From nobody@FreeBSD.org  Thu Nov  1 05:17:01 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id E16D32FB4
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  1 Nov 2012 05:17:01 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id B0A028FC15
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  1 Nov 2012 05:17:01 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id qA15H1el021599
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 1 Nov 2012 05:17:01 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id qA15H1dc021598;
	Thu, 1 Nov 2012 05:17:01 GMT
	(envelope-from nobody)
Message-Id: <201211010517.qA15H1dc021598@red.freebsd.org>
Date: Thu, 1 Nov 2012 05:17:01 GMT
From: Yuri <yuri@tsoft.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] Handbook section 23.3.3 correction
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         173255
>Category:       docs
>Synopsis:       [patch] Handbook section 23.3.3 correction
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 01 05:20:00 UTC 2012
>Closed-Date:    Mon Nov 05 13:17:01 UTC 2012
>Last-Modified:  Mon Nov 05 13:17:01 UTC 2012
>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:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Thu Nov 1 18:42:21 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=173255 
State-Changed-From-To: open->analyzed 
State-Changed-By: eadler 
State-Changed-When: Thu Nov 1 18:59:08 UTC 2012 
State-Changed-Why:  
awaiting approval or review prior to commit (no action needed from 
submitter) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=173255 
State-Changed-From-To: analyzed->closed 
State-Changed-By: eadler 
State-Changed-When: Mon Nov 5 13:17:00 UTC 2012 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=173255 
>Unformatted:
