docs/173255: [patch] Handbook section 23.3.3 correction

[Yuri]

>Number:         173255
>Category:       docs
>Synopsis:       [patch] Handbook section 23.3.3 correction
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 01 05:20:00 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Yuri
>Release:        9.1
>Organization:
n/a
>Environment:
>Description:
Please check in the correction to the Section 23.3.3 VirtualBox Host DVD/CD Access.


>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: handbook/virtualization/chapter.xml
===================================================================
--- handbook/virtualization/chapter.xml	(revision 39888)
+++ handbook/virtualization/chapter.xml	(working copy)
@@ -1254,19 +1254,20 @@
     <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>
+      <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.
+        "Passthrough" check box will appear, which is an option to share the physical drive
+        as a whole, vs. to share the current data media only. For example, audio CDs or the
+        burner function won't be accessible by guests without choosing the passthrough
+        option.</para>
 
-      <programlisting>atapicam_load="YES"</programlisting>
-
       <para><acronym>HAL</acronym> needs to run for
 	<application>&virtualbox;</application> DVD/CD functions to
 	work, so enable it in <filename>/etc/rc.conf</filename> and
 	start it (if it is not already running):</para>
-
       <programlisting>hald_enable="YES"</programlisting>
-
       <screen>&prompt.root; <userinput>/usr/local/etc/rc.d/hald start</userinput></screen>
 
       <para>In order for users to be able to use
@@ -1276,12 +1277,15 @@
 	  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>
+        the 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>
 
 <!--


>Release-Note:
>Audit-Trail:
>Unformatted: