svn commit: r39948 - head/en_US.ISO8859-1/books/handbook/virtualization

[Eitan Adler]

Author: eadler
Date: Mon Nov  5 13:16:50 2012
New Revision: 39948
URL: http://svnweb.freebsd.org/changeset/doc/39948

Log:
  Update information about using VirtualBox.
  
  atapicam is no longer required and some devices need passthrough.
  
  PR:		docs/173255
  Submitted by:	Yuri <yuri at tsoft.com>
  Approved by:	jkois (mentor)

Modified:
  head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Mon Nov  5 13:16:45 2012	(r39947)
+++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Mon Nov  5 13:16:50 2012	(r39948)
@@ -1254,11 +1254,16 @@ add path 'usb/*' mode 0660 group operato
     <sect2 id="virtualization-virtualbox-host-dvd-cd-access">
       <title>&virtualbox; Host DVD/CD Access</title>
 
-      <para>The <command>atapicam</command> kernel module needs to be
-	loaded by adding the following line to
-	<filename>/boot/loader.conf</filename>:</para>
-
-      <programlisting>atapicam_load="YES"</programlisting>
+      <para>Access to the host DVD/CD drives from guests is achieved
+	through the sharing of the physical drives.  In GUI this is
+	set up from the Storage window in the Settings of the virtual
+	machine.  Create an empty IDE CD/DVD device first.
+	Then choose the Host Drive from the popup menu for the virtual
+	CD/DVD drive selection.  A checkbox labeled
+	<literal>Passthrough</literal> check box will appear.
+	This allows the virtual machine to use the hardware directly.
+	For example, audio CDs or the burner only function if
+	this option is selected.</para>
 
       <para><acronym>HAL</acronym> needs to run for
 	<application>&virtualbox;</application> DVD/CD functions to
@@ -1267,7 +1272,7 @@ add path 'usb/*' mode 0660 group operato
 
       <programlisting>hald_enable="YES"</programlisting>
 
-      <screen>&prompt.root; <userinput>/usr/local/etc/rc.d/hald start</userinput></screen>
+      <screen>&prompt.root; <userinput>service hald start</userinput></screen>
 
       <para>In order for users to be able to use
 	<application>&virtualbox;</application> DVD/CD functions, they
@@ -1276,12 +1281,18 @@ add path 'usb/*' mode 0660 group operato
 	  class="devicefile">/dev/cd<replaceable>N</replaceable></filename>,
 	and <filename
 	  class="devicefile">/dev/pass<replaceable>N</replaceable></filename>.
-	Add the following lines to
+	This is usually achieved by making the user of
+	<application>&virtualbox;</application>
+	a member of the operator group, which is also the default
+	group of the above mentioned devices.  Permissions of these
+	devices have to be corrected by adding the following lines to
 	<filename>/etc/devfs.conf</filename>:</para>
 
-      <programlisting>perm cd0 0600
+      <programlisting>perm cd* 0600
 perm xpt0 0660
-perm pass0 0660</programlisting>
+perm pass* 0660</programlisting>
+
+      <screen>&prompt.root; <userinput>/etc/rc.d/devfs restart</userinput></screen>
     </sect2>
 
 <!--