xref: /freebsd/share/man/man9/cd.9 (revision aaf1f16e39da164cd6dfa049b53d61b9c9ed3216)
13cf493c6SJoerg Wunsch.\" Copyright (c) 1997
23cf493c6SJoerg Wunsch.\"	John-Mark Gurney.  All rights reserved.
33cf493c6SJoerg Wunsch.\"
43cf493c6SJoerg Wunsch.\" Redistribution and use in source and binary forms, with or without
53cf493c6SJoerg Wunsch.\" modification, are permitted provided that the following conditions
63cf493c6SJoerg Wunsch.\" are met:
73cf493c6SJoerg Wunsch.\" 1. Redistributions of source code must retain the above copyright
83cf493c6SJoerg Wunsch.\"    notice, this list of conditions and the following disclaimer.
93cf493c6SJoerg Wunsch.\" 2. Redistributions in binary form must reproduce the above copyright
103cf493c6SJoerg Wunsch.\"    notice, this list of conditions and the following disclaimer in the
113cf493c6SJoerg Wunsch.\"    documentation and/or other materials provided with the distribution.
123cf493c6SJoerg Wunsch.\" 3. Neither the name of the author nor the names of any co-contributors
133cf493c6SJoerg Wunsch.\"    may be used to endorse or promote products derived from this software
143cf493c6SJoerg Wunsch.\"    without specific prior written permission.
153cf493c6SJoerg Wunsch.\"
163cf493c6SJoerg Wunsch.\" THIS SOFTWARE IS PROVIDED BY John-Mark Gurney AND CONTRIBUTORS ``AS IS'' AND
173cf493c6SJoerg Wunsch.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
183cf493c6SJoerg Wunsch.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
193cf493c6SJoerg Wunsch.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
203cf493c6SJoerg Wunsch.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
213cf493c6SJoerg Wunsch.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
223cf493c6SJoerg Wunsch.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
233cf493c6SJoerg Wunsch.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
243cf493c6SJoerg Wunsch.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
253cf493c6SJoerg Wunsch.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
263cf493c6SJoerg Wunsch.\" SUCH DAMAGE.
273cf493c6SJoerg Wunsch.\"
28aaf1f16eSPhilippe Charnier.\"	$Id: cd.9,v 1.6 1997/04/02 09:41:16 jmg Exp $
293cf493c6SJoerg Wunsch.\"
30076dc43cSMike Pritchard.Dd February 1, 1997
3109edd56aSMike Pritchard.Dt CD 9
323cf493c6SJoerg Wunsch.Os FreeBSD
333cf493c6SJoerg Wunsch.Sh NAME
343cf493c6SJoerg Wunsch.Nm cd
353cf493c6SJoerg Wunsch.Nd device driver for SCSI subsystem
363cf493c6SJoerg Wunsch.Sh DESCRIPTION
37076dc43cSMike PritchardThe
38076dc43cSMike Pritchard.Nm
39076dc43cSMike Pritcharddevice driver provides the
403cf493c6SJoerg Wunsch.Tn SCSI
413cf493c6SJoerg Wunschsubsystem a way to handle type 5
423cf493c6SJoerg Wunsch.Pq Dv T_READONLY
433cf493c6SJoerg Wunschmedia.  Some drives don't behave as the driver expects.  See the section
443cf493c6SJoerg WunschQUIRKS for info on possible flags.
453cf493c6SJoerg Wunsch.Sh QUIRKS
463cf493c6SJoerg WunschEach
473cf493c6SJoerg Wunsch.Tn CD-ROM
483cf493c6SJoerg Wunschdevice can have different interpretations of the
493cf493c6SJoerg Wunsch.Tn SCSI
503cf493c6SJoerg Wunschspec.  This can lead to drives requiring special handling in the driver.  The
513cf493c6SJoerg Wunschfollowing is a list of quirks that the driver recognize.  See
523cf493c6SJoerg Wunsch.Xr scsiconf 9
533cf493c6SJoerg Wunschfor more information on how to add quirk entries.
543cf493c6SJoerg Wunsch.Bl -tag -width CD_Q_BCD_TRACKS
553cf493c6SJoerg Wunsch.It Dv CD_Q_NO_TOUCH
563cf493c6SJoerg WunschThis flag tell the driver not to probe the drive at attach time to see if
573cf493c6SJoerg Wunschthere is a disk in the drive and find out what size it is.
583cf493c6SJoerg Wunsch.It Dv CD_Q_BCD_TRACKS
593cf493c6SJoerg WunschThis flag is for broken drives that return the track numbers in packed BCD
60df3cc939SJohn-Mark Gurneyinstead of straight decimal.  If the drive seems to skip tracks
61df3cc939SJohn-Mark Gurney.Pq tracks 10-15 are skipped
623cf493c6SJoerg Wunschthen you have a drive that is in need of this flag.
633cf493c6SJoerg Wunsch.El
643cf493c6SJoerg Wunsch.Sh FILES
653cf493c6SJoerg Wunsch.Bl -tag -width /sys/scsi/scsiconf.h -compact
663cf493c6SJoerg Wunsch.It Pa /sys/scsi/cd.c
673cf493c6SJoerg Wunschfiles contains actual driver code
683cf493c6SJoerg Wunsch.It Pa /sys/scsi/scsiconf.h
693cf493c6SJoerg Wunschcontains the defines of the
703cf493c6SJoerg Wunsch.Dv CD_Q_xxx
713cf493c6SJoerg Wunschquirk flags
723cf493c6SJoerg Wunsch.El
733cf493c6SJoerg Wunsch.Sh SEE ALSO
743cf493c6SJoerg Wunsch.Xr cd 4 ,
75df3cc939SJohn-Mark Gurney.Xr scsi 4 ,
763cf493c6SJoerg Wunsch.Xr scsiconf 9
773cf493c6SJoerg Wunsch.Sh HISTORY
783cf493c6SJoerg WunschThe
793cf493c6SJoerg Wunsch.Nm
803cf493c6SJoerg Wunschmanual page first appeared in
810f63118aSMike Pritchard.Fx 2.2 .
82aaf1f16eSPhilippe Charnier.Sh AUTHORS
833cf493c6SJoerg WunschThis
84aaf1f16eSPhilippe Charniermanual page was written by
85aaf1f16eSPhilippe Charnier.An John-Mark Gurney Aq gurney_j@efn.org .
86