Date: Wed, 23 Apr 2014 19:35:49 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201404231935.s3NJZntd003159@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 <secondary>ATAPI/CAM driver</secondary> </indexterm> - <para>This driver allows <acronym>ATAPI</acronym> devices, such - as CD/DVD drives, to be accessed through the - <acronym>SCSI</acronym> subsystem, and so allows the use of - applications like <package>sysutils/cdrdao</package> or - &man.cdrecord.1;.</para> - - <para>To use this driver, add the following line to - <filename>/boot/loader.conf</filename>:</para> - - <programlisting>atapicam_load="YES"</programlisting> - - <para>then, reboot the system.</para> + <para>The <filename>GENERIC</filename> kernel provides support + for <acronym>SCSI</acronym>, <acronym>USB</acronym>, and + <acronym>ATAPI</acronym> <acronym>CD</acronym> 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.</para> + + <para>For a <acronym>SCSI</acronym> burner, make sure these + options are present:</para> + + <programlisting>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</programlisting> + + <para>For a <acronym>USB</acronym> burner, make sure these + options are present:</para> + + <programlisting>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</programlisting> + + <para>For an <acronym>ATAPI</acronym> burner, make sure these + options are present:</para> + + <programlisting>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 +</programlisting> <note> - <para>Users who prefer to statically compile &man.atapicam.4; - support into the kernel, should add this line to the - kernel configuration file:</para> + <para>On &os; versions prior to 10.x, this line is also + needed in the kernel configuration file if the burner is an + <acronym>ATAPI</acronym> device:</para> <programlisting>device atapicam</programlisting> - <para>Ensure the following lines are still in the kernel - configuration file:</para> + <para>Alternately, this driver can be loaded at boot time by adding the following line to + <filename>/boot/loader.conf</filename>:</para> - <programlisting>device ata -device scbus -device cd -device pass</programlisting> + <programlisting>atapicam_load="YES"</programlisting> - <para>Then rebuild, install the new kernel, and reboot the - machine.</para> + <para>This will require a reboot of the system as this driver + can only be loaded at boot time.</para> </note> - <para>During the boot process, the burner should show up, like - so:</para> - - <screen>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</screen> - - <para>The drive can now be accessed via the - <filename>/dev/cd0</filename> device name. For example, to - mount a <acronym>CD-ROM</acronym> on - <filename>/mnt</filename>, type the following:</para> - - <screen>&prompt.root; <userinput>mount -t cd9660 <replaceable>/dev/cd0</replaceable> /mnt</userinput></screen> - - <para>As <systemitem class="username">root</systemitem>, run the - following command to get the <acronym>SCSI</acronym> address - of the burner:</para> - - <screen>&prompt.root; <userinput>camcontrol devlist</userinput> -<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0)</screen> - - <para>In this example, <literal>1,0,0</literal> is the - <acronym>SCSI</acronym> address to use with &man.cdrecord.1; - and other <acronym>SCSI</acronym> applications.</para> - - <para>For more information about ATAPI/CAM and - <acronym>SCSI</acronym> system, refer to &man.atapicam.4; and - &man.cam.4;.</para> + <para>To verify that &os; recognizes the device, run + <command>dmesg</command> 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 <filename>acd0</filename> instead of + <filename>cd0</filename>.</para> + + <screen>&prompt.user; <userinput>dmesg | grep cd</userinput> +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 +</screen> </sect2> <sect2 xml:id="mkisofs"> @@ -915,6 +920,17 @@ scsibus1: <option>dev=1,5,0</option>. Refer to &man.cdrecord.1; for easier ways to specify this value and for information on writing audio tracks and controlling the write speed.</para> + + <para>Alternately, as <systemitem class="username">root</systemitem>, run the + following command to get the <acronym>SCSI</acronym> address + of the burner:</para> + + <screen>&prompt.root; <userinput>camcontrol devlist</userinput> +<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0)</screen> + + <para>In this example, <literal>1,0,0</literal> is the + <acronym>SCSI</acronym> address to use with &man.cdrecord.1; + and other <acronym>SCSI</acronym> applications.</para> </sect2> <sect2 xml:id="duplicating-audiocds"> @@ -1021,6 +1037,13 @@ scsibus1: <sect2 xml:id="mounting-cd"> <title>Using Data <acronym>CD</acronym>s</title> + <para>The drive can now be accessed via the + <filename>/dev/cd0</filename> device name. For example, to + mount a <acronym>CD-ROM</acronym> on + <filename>/mnt</filename>, type the following:</para> + + <screen>&prompt.root; <userinput>mount -t cd9660 <replaceable>/dev/cd0</replaceable> /mnt</userinput></screen> + <para>It is possible to mount and read the data on a standard data <acronym>CD</acronym>. By default, &man.mount.8; assumes that a file system is of type <literal>ufs</literal>. Running
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201404231935.s3NJZntd003159>