svn commit: r44637 - head/en_US.ISO8859-1/books/handbook/disks
Dru Lavigne
dru at FreeBSD.org
Wed Apr 23 19:35:49 UTC 2014
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
More information about the svn-doc-head
mailing list