Changeset 51261 in vbox

Timestamp:

May 15, 2014 3:36:42 PM (11 years ago)

Author:

vboxsync

Message:

User manual: mention about connection between VBoxInternal2/EfiBootArgs extradata and boot-args EFI variable.

Location:

trunk/doc/manual/en_US

Files:

• user_BasicConcepts.xml (modified) (1 diff)
• user_KnownIssues.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_BasicConcepts.xml

@@ -1386 +1386 @@
       VM is powered off and remains persistent until changed.</para>
     </sect2>
+
+    <sect2 id="efibootargs">
+      <title>Specifying boot arguments</title>
+
+      <para>It is currently not possible to manipulate EFI variables from within a running guest
+      (e.g., setting the "boot-args" variable by running the <computeroutput>nvram</computeroutput> tool in a Mac OS X guest will not work).
+      As an alternative way, "VBoxInternal2/EfiBootArgs" extradata can be passed to a VM in order to set
+      the "boot-args" variable. To change the "boot-args" EFI variable:
+      <screen>VBoxManage setextradata "VM name" VBoxInternal2/EfiBootArgs &lt;value&gt;</screen>
+      </para>
+    </sect2>
+
   </sect1>
 </chapter>

trunk/doc/manual/en_US/user_KnownIssues.xml

@@ -225 +225 @@
                 messages by issuing this command:<screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" "  "</screen>To
                 revert to the previous behavior, use:<screen>VBoxManage setextradata "VM name" "VBoxInternal2/EfiBootArgs" ""</screen></para>
+              </listitem>
+
+              <listitem>
+                <para>It is currently not possible to start a Mac OS X guest in safe mode by specifying "-x" option
+                in "VBoxInternal2/EfiBootArgs" extradata.</para>
               </listitem>
             </itemizedlist></para>