From owner-freebsd-doc@FreeBSD.ORG Thu Nov 1 05:20:01 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0ED08451 for ; Thu, 1 Nov 2012 05:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id D8AB78FC17 for ; Thu, 1 Nov 2012 05:20:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qA15K0uq014034 for ; Thu, 1 Nov 2012 05:20:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qA15K0JJ014033; Thu, 1 Nov 2012 05:20:00 GMT (envelope-from gnats) Resent-Date: Thu, 1 Nov 2012 05:20:00 GMT Resent-Message-Id: <201211010520.qA15K0JJ014033@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Yuri Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E16D32FB4 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/173255: [patch] Handbook section 23.3.3 correction X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Nov 2012 05:20:01 -0000 >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 @@ &virtualbox; Host DVD/CD Access - The atapicam kernel module needs to be - loaded by adding the following line to - /boot/loader.conf: + 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. - atapicam_load="YES" - HAL needs to run for &virtualbox; DVD/CD functions to work, so enable it in /etc/rc.conf and start it (if it is not already running): - hald_enable="YES" - &prompt.root; /usr/local/etc/rc.d/hald start In order for users to be able to use @@ -1276,12 +1277,15 @@ class="devicefile">/dev/cdN, and /dev/passN. - Add the following lines to + This is usually achieved by making the user of &virtualbox; + 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 /etc/devfs.conf: - perm cd0 0600 + perm cd* 0600 perm xpt0 0660 -perm pass0 0660 +perm pass* 0660 + &prompt.root; /etc/rc.d/devfs restart