From owner-svn-doc-all@FreeBSD.ORG Wed Apr 23 19:35:49 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 6A87FAA; Wed, 23 Apr 2014 19:35:49 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 565CF1D80; Wed, 23 Apr 2014 19:35:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3NJZnS5003160; Wed, 23 Apr 2014 19:35:49 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3NJZntd003159; Wed, 23 Apr 2014 19:35:49 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404231935.s3NJZntd003159@svn.freebsd.org> From: Dru Lavigne Date: Wed, 23 Apr 2014 19:35:49 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44637 - head/en_US.ISO8859-1/books/handbook/disks X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Apr 2014 19:35:49 -0000 Author: dru Date: Wed Apr 23 19:35:48 2014 New Revision: 44637 URL: http://svnweb.freebsd.org/changeset/doc/44637 Log: Editorial review of Supported CD Devices section. Add notes for ATAPI devices prior to 10.0. Update verification example. More commits to come in this chapter. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Wed Apr 23 18:16:34 2014 (r44636) +++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Wed Apr 23 19:35:48 2014 (r44637) @@ -678,68 +678,73 @@ da0: <STECH Simple Drive 1.04> s/n ATAPI/CAM driver - This driver allows ATAPI devices, such - as CD/DVD drives, to be accessed through the - SCSI subsystem, and so allows the use of - applications like sysutils/cdrdao or - &man.cdrecord.1;. - - To use this driver, add the following line to - /boot/loader.conf: - - atapicam_load="YES" - - then, reboot the system. + The GENERIC kernel provides support + for SCSI, USB, and + ATAPI CD readers and + burners. If a custom kernel is used, the options that need to + be present in the kernel configuration file vary by the type + of device. + + For a SCSI burner, make sure these + options are present: + + device scbus # SCSI bus (required for ATA/SCSI) +device da # Direct Access (disks) +device pass # Passthrough device (direct ATA/SCSI access) +device cd # needed for CD and DVD burners + + For a USB burner, make sure these + options are present: + + device scbus # SCSI bus (required for ATA/SCSI) +device da # Direct Access (disks) +device pass # Passthrough device (direct ATA/SCSI access) +device cd # needed for CD and DVD burners +device uhci # provides USB 1.x support +device ohci # provides USB 1.x support +device ehci # provides USB 2.0 support +device xhci # provides USB 3.0 support +device usb # USB Bus (required) +device umass # Disks/Mass storage - Requires scbus and da + + For an ATAPI burner, make sure these + options are present: + + device ata # Legacy ATA/SATA controllers +device scbus # SCSI bus (required for ATA/SCSI) +device pass # Passthrough device (direct ATA/SCSI access) +device cd # needed for CD and DVD burners + - Users who prefer to statically compile &man.atapicam.4; - support into the kernel, should add this line to the - kernel configuration file: + On &os; versions prior to 10.x, this line is also + needed in the kernel configuration file if the burner is an + ATAPI device: device atapicam - Ensure the following lines are still in the kernel - configuration file: + Alternately, this driver can be loaded at boot time by adding the following line to + /boot/loader.conf: - device ata -device scbus -device cd -device pass + atapicam_load="YES" - Then rebuild, install the new kernel, and reboot the - machine. + This will require a reboot of the system as this driver + can only be loaded at boot time. - During the boot process, the burner should show up, like - so: - - acd0: CD-RW <MATSHITA CD-RW/DVD-ROM UJDA740> at ata1-master PIO4 -cd0 at ata1 bus 0 target 0 lun 0 -cd0: <MATSHITA CDRW/DVD UJDA740 1.00> Removable CD-ROM SCSI-0 device -cd0: 16.000MB/s transfers -cd0: Attempt to query device size failed: NOT READY, Medium not present - tray closed - - The drive can now be accessed via the - /dev/cd0 device name. For example, to - mount a CD-ROM on - /mnt, type the following: - - &prompt.root; mount -t cd9660 /dev/cd0 /mnt - - As root, run the - following command to get the SCSI address - of the burner: - - &prompt.root; camcontrol devlist -<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0) - - In this example, 1,0,0 is the - SCSI address to use with &man.cdrecord.1; - and other SCSI applications. - - For more information about ATAPI/CAM and - SCSI system, refer to &man.atapicam.4; and - &man.cam.4;. + To verify that &os; recognizes the device, run + dmesg and look for an entry for the device. + On systems prior to 10.x, the device name in the first line of + the output will be acd0 instead of + cd0. + + &prompt.user; dmesg | grep cd +cd0 at ahcich1 bus 0 scbus1 target 0 lun 0 +cd0: <HL-DT-ST DVDRAM GU70N LT20> Removable CD-ROM SCSI-0 device +cd0: Serial Number M3OD3S34152 +cd0: 150.000MB/s transfers (SATA 1.x, UDMA6, ATAPI 12bytes, PIO 8192bytes) +cd0: Attempt to query device size failed: NOT READY, Medium not present - tray closed + @@ -915,6 +920,17 @@ scsibus1: . Refer to &man.cdrecord.1; for easier ways to specify this value and for information on writing audio tracks and controlling the write speed. + + Alternately, as root, run the + following command to get the SCSI address + of the burner: + + &prompt.root; camcontrol devlist +<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0) + + In this example, 1,0,0 is the + SCSI address to use with &man.cdrecord.1; + and other SCSI applications. @@ -1021,6 +1037,13 @@ scsibus1: Using Data <acronym>CD</acronym>s + The drive can now be accessed via the + /dev/cd0 device name. For example, to + mount a CD-ROM on + /mnt, type the following: + + &prompt.root; mount -t cd9660 /dev/cd0 /mnt + It is possible to mount and read the data on a standard data CD. By default, &man.mount.8; assumes that a file system is of type ufs. Running