Date: Thu, 1 Nov 2012 05:17:01 GMT From: Yuri <yuri@tsoft.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/173255: [patch] Handbook section 23.3.3 correction Message-ID: <201211010517.qA15H1dc021598@red.freebsd.org> Resent-Message-ID: <201211010520.qA15K0JJ014033@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211010517.qA15H1dc021598>