Date: Thu, 1 Dec 2011 12:53:57 -0700 (MST) From: Warren Block <wblock@wonkity.com> To: Manolis Kiagias <sonic2000gr@gmail.com> Cc: freebsd-doc@freebsd.org, bug-followup@freebsd.org Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook Message-ID: <alpine.BSF.2.00.1112011250280.12893@wonkity.com> In-Reply-To: <4ED7BECE.2060000@gmail.com> References: <201111302220.pAUMK8Gt078242@freefall.freebsd.org> <4ED7BECE.2060000@gmail.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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 [-- Attachment #2 --] --- 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 <ulinkhelp
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1112011250280.12893>