docs/162961: [PATCH] Update VirtualBox section in handbook

Warren Block wblock at wonkity.com
Thu Dec 1 19:53:58 UTC 2011 

On Thu, 1 Dec 2011, Manolis Kiagias wrote:

> Here is the latest version of the patch, with few more minor fixes and a 
> complete whitespace overhaul:
>
> http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt
>
> A test build is here:
>
> http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/virtualization-guest.html
>
> If there are no objections / fixes, this goes in tomorrow :)

A few quick suggestions:

--- virtualization-virtualbox-chapter-patch-new.txt.orig	2011-12-01 12:41:46.000000000 -0700
+++ virtualization-virtualbox-chapter-patch-new.txt	2011-12-01 12:52:28.000000000 -0700
@@ -7,7 +7,7 @@
       </sect2>
  +
  +    <sect2 id="virtualization-guest-virtualbox-guest-additions">
-+      <title>&virtualbox; Guest Additions on &os; Guest</title>
++      <title>&virtualbox; Guest Additions on a &os; Guest</title>
  +
  +      <para>The <application>&virtualbox;</application> guest additions
  +	provide support for:</para>
@@ -44,7 +44,7 @@
  +
  +      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions && make install clean</userinput></screen>
  +
-+      <para>Add the following lines to <filename>/etc/rc.conf</filename>:</para>
++      <para>Add these lines to <filename>/etc/rc.conf</filename>:</para>
  +
  +      <programlisting>vboxguest_enable="YES"
  +vboxservice_enable="YES"</programlisting>
@@ -55,8 +55,8 @@
  +      <programlisting>vboxservice_flags="--disable-timesync"</programlisting>
  +
  +      <para>The <literal>vboxvideo_drv</literal> should be recognized by
-+	<command>Xorg -configure</command>.  If not, use something like this
-+	in your <filename>xorg.conf</filename> file for the
++	<command>Xorg -configure</command>.  If not, modify
++	<filename>xorg.conf</filename> for the
  +	<application>&virtualbox;</application> video card:</para>
  +
  +      <programlisting>Section "Device"
@@ -71,8 +71,8 @@
  +	BusID "PCI:0:2:0"
  +EndSection</programlisting>
  +
-+      <para>To use <literal>vboxmouse_drv</literal> please adjust the mouse
-+	section in your <filename>xorg.conf</filename> like this:</para>
++      <para>To use <literal>vboxmouse_drv</literal>, adjust the mouse
++	section in <filename>xorg.conf</filename>:</para>
  +
  +      <programlisting>Section "InputDevice"
  +	Identifier "Mouse0"
@@ -127,7 +127,7 @@
  -	may be installed using the following commands:</para>
  +	in <filename role="package">emulators/virtualbox-ose</filename>.
  +	As &virtualbox; is very actively developed, make sure your ports
-+	tree is up to date before installing.  Install using the following
++	tree is up to date before installing.  Install using these
  +	commands:</para>

         <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
@@ -142,7 +142,7 @@
  -	the functions provided by the &man.sysctl.3; library.</para>
  +      <para>To use the kernel modules that allow bridged or host-only
  +	networking, add the following to <filename>/etc/rc.conf</filename>
-+	and reboot your computer:</para>
++	and reboot the computer:</para>

  -      <para>When using an older version of the port, follow the instructions
  -	below to make sure <filename class="directory">proc</filename> is
@@ -170,28 +170,28 @@
  +      <programlisting>vboxnet_enable="YES"</programlisting>

         <para>The <groupname>vboxusers</groupname> group is created during
- 	the installation of <application>&virtualbox;</application>.
+ 	installation of <application>&virtualbox;</application>.
  @@ -1066,6 +1156,21 @@

         <screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>

  +      <para>The default permissions for <filename
  +	  class="devicefile">/dev/vboxnetctl</filename> are restrictive and
-+	will need to be changed for bridged networking.</para>
++	need to be changed for bridged networking.</para>
  +
  +      <para>To test it temporarily:</para>
  +
  +      <screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
  +&prompt.root; <userinput>chmod 0660 /dev/vboxnetctl</userinput></screen>
  +
-+      <para>To make the permissions change permanent, add the following
++      <para>To make the permissions change permanent, add these
  +	lines to <filename>/etc/devfs.conf</filename>:
  +
  +      <programlisting>own     vboxnetctl root:vboxusers
  +perm    vboxnetctl 0660</programlisting>
  +
         <para>To launch <application>&virtualbox;</application>, either select
- 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from your
+ 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from the
   	graphic environment's menu, or type the following in a
  @@ -1081,6 +1186,71 @@
   	visit the relevant page in the &os; wiki, at <ulink
-------------- next part --------------
--- virtualization-virtualbox-chapter-patch-new.txt.orig	2011-12-01 12:41:46.000000000 -0700
+++ virtualization-virtualbox-chapter-patch-new.txt	2011-12-01 12:52:28.000000000 -0700
@@ -7,7 +7,7 @@
      </sect2>
 +
 +    <sect2 id="virtualization-guest-virtualbox-guest-additions">
-+      <title>&virtualbox; Guest Additions on &os; Guest</title>
++      <title>&virtualbox; Guest Additions on a &os; Guest</title>
 +
 +      <para>The <application>&virtualbox;</application> guest additions
 +	provide support for:</para>
@@ -44,7 +44,7 @@
 +
 +      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose-additions && make install clean</userinput></screen>
 +
-+      <para>Add the following lines to <filename>/etc/rc.conf</filename>:</para>
++      <para>Add these lines to <filename>/etc/rc.conf</filename>:</para>
 +
 +      <programlisting>vboxguest_enable="YES"
 +vboxservice_enable="YES"</programlisting>
@@ -55,8 +55,8 @@
 +      <programlisting>vboxservice_flags="--disable-timesync"</programlisting>
 +
 +      <para>The <literal>vboxvideo_drv</literal> should be recognized by
-+	<command>Xorg -configure</command>.  If not, use something like this
-+	in your <filename>xorg.conf</filename> file for the
++	<command>Xorg -configure</command>.  If not, modify
++	<filename>xorg.conf</filename> for the
 +	<application>&virtualbox;</application> video card:</para>
 +
 +      <programlisting>Section "Device"
@@ -71,8 +71,8 @@
 +	BusID "PCI:0:2:0"
 +EndSection</programlisting>
 +
-+      <para>To use <literal>vboxmouse_drv</literal> please adjust the mouse
-+	section in your <filename>xorg.conf</filename> like this:</para>
++      <para>To use <literal>vboxmouse_drv</literal>, adjust the mouse
++	section in <filename>xorg.conf</filename>:</para>
 +
 +      <programlisting>Section "InputDevice"
 +	Identifier "Mouse0"
@@ -127,7 +127,7 @@
 -	may be installed using the following commands:</para>
 +	in <filename role="package">emulators/virtualbox-ose</filename>.
 +	As &virtualbox; is very actively developed, make sure your ports
-+	tree is up to date before installing.  Install using the following
++	tree is up to date before installing.  Install using these
 +	commands:</para>
  
        <screen>&prompt.root; <userinput>cd /usr/ports/emulators/virtualbox-ose</userinput>
@@ -142,7 +142,7 @@
 -	the functions provided by the &man.sysctl.3; library.</para>
 +      <para>To use the kernel modules that allow bridged or host-only
 +	networking, add the following to <filename>/etc/rc.conf</filename>
-+	and reboot your computer:</para>
++	and reboot the computer:</para>
  
 -      <para>When using an older version of the port, follow the instructions
 -	below to make sure <filename class="directory">proc</filename> is
@@ -170,28 +170,28 @@
 +      <programlisting>vboxnet_enable="YES"</programlisting>
  
        <para>The <groupname>vboxusers</groupname> group is created during
- 	the installation of <application>&virtualbox;</application>.
+ 	installation of <application>&virtualbox;</application>.
 @@ -1066,6 +1156,21 @@
  
        <screen>&prompt.root; <userinput>pw groupmod vboxusers -m <replaceable>yourusername</replaceable></userinput></screen>
  
 +      <para>The default permissions for <filename
 +	  class="devicefile">/dev/vboxnetctl</filename> are restrictive and
-+	will need to be changed for bridged networking.</para>
++	need to be changed for bridged networking.</para>
 +
 +      <para>To test it temporarily:</para>
 +
 +      <screen>&prompt.root; <userinput>chown root:vboxusers /dev/vboxnetctl</userinput>
 +&prompt.root; <userinput>chmod 0660 /dev/vboxnetctl</userinput></screen>
 +
-+      <para>To make the permissions change permanent, add the following
++      <para>To make the permissions change permanent, add these
 +	lines to <filename>/etc/devfs.conf</filename>:
 +
 +      <programlisting>own     vboxnetctl root:vboxusers
 +perm    vboxnetctl 0660</programlisting>
 +
        <para>To launch <application>&virtualbox;</application>, either select
- 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from your
+ 	the <guimenuitem>Sun VirtualBox</guimenuitem> item from the
  	graphic environment's menu, or type the following in a
 @@ -1081,6 +1186,71 @@
  	visit the relevant page in the &os; wiki, at <ulink

More information about the freebsd-doc mailing list