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
This commit is contained in:
Dru Lavigne
parent
5fac5a51eb
commit
3f45ef8f01
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44637
1 changed files with 77 additions and 54 deletions
|
|
@ -678,68 +678,73 @@ da0: <STECH Simple Drive 1.04> s/n WD-WXE508CAN263 detached
|
|||
<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>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>To use this driver, add the following line to
|
||||
<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>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>Alternately, this driver can be loaded at boot time by adding the following line to
|
||||
<filename>/boot/loader.conf</filename>:</para>
|
||||
|
||||
<programlisting>atapicam_load="YES"</programlisting>
|
||||
|
||||
<para>then, reboot the system.</para>
|
||||
|
||||
<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>
|
||||
|
||||
<programlisting>device atapicam</programlisting>
|
||||
|
||||
<para>Ensure the following lines are still in the kernel
|
||||
configuration file:</para>
|
||||
|
||||
<programlisting>device ata
|
||||
device scbus
|
||||
device cd
|
||||
device pass</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>
|
||||
<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>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>
|
||||
<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
|
||||
|
|
|
|||
Loading…
Reference in a new issue