xref: /freebsd/share/man/man9/cd.9 (revision 09edd56ac0c37d5a8ab1ae67a0709b8d06efe1f7)
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.\"
283cf493c6SJoerg Wunsch.\"
29076dc43cSMike Pritchard.Dd February 1, 1997
3009edd56aSMike Pritchard.Dt CD 9
313cf493c6SJoerg Wunsch.Os FreeBSD
323cf493c6SJoerg Wunsch.Sh NAME
333cf493c6SJoerg Wunsch.Nm cd
343cf493c6SJoerg Wunsch.Nd device driver for SCSI subsystem
353cf493c6SJoerg Wunsch.Sh DESCRIPTION
36076dc43cSMike PritchardThe
37076dc43cSMike Pritchard.Nm
38076dc43cSMike Pritcharddevice driver provides the
393cf493c6SJoerg Wunsch.Tn SCSI
403cf493c6SJoerg Wunschsubsystem a way to handle type 5
413cf493c6SJoerg Wunsch.Pq Dv T_READONLY
423cf493c6SJoerg Wunschmedia.  Some drives don't behave as the driver expects.  See the section
433cf493c6SJoerg WunschQUIRKS for info on possible flags.
443cf493c6SJoerg Wunsch.Sh QUIRKS
453cf493c6SJoerg WunschEach
463cf493c6SJoerg Wunsch.Tn CD-ROM
473cf493c6SJoerg Wunschdevice can have different interpretations of the
483cf493c6SJoerg Wunsch.Tn SCSI
493cf493c6SJoerg Wunschspec.  This can lead to drives requiring special handling in the driver.  The
503cf493c6SJoerg Wunschfollowing is a list of quirks that the driver recognize.  See
513cf493c6SJoerg Wunsch.Xr scsiconf 9
523cf493c6SJoerg Wunschfor more information on how to add quirk entries.
533cf493c6SJoerg Wunsch.Bl -tag -width CD_Q_BCD_TRACKS
543cf493c6SJoerg Wunsch.It Dv CD_Q_NO_TOUCH
553cf493c6SJoerg WunschThis flag tell the driver not to probe the drive at attach time to see if
563cf493c6SJoerg Wunschthere is a disk in the drive and find out what size it is.
573cf493c6SJoerg Wunsch.ig xx
583cf493c6SJoerg Wunsch.It Dv CD_Q_BCD_TRACKS
593cf493c6SJoerg WunschThis flag is for broken drives that return the track numbers in packed BCD
603cf493c6SJoerg Wunschencoding instead of straight decimal.  If the drive seems to skip tracks
613cf493c6SJoerg Wunsch.Pq usually tracks 10-15 are skipped
623cf493c6SJoerg Wunschthen you have a drive that is in need of this flag.
633cf493c6SJoerg Wunsch.xx
643cf493c6SJoerg Wunsch.El
653cf493c6SJoerg Wunsch.Sh FILES
663cf493c6SJoerg Wunsch.Bl -tag -width /sys/scsi/scsiconf.h -compact
673cf493c6SJoerg Wunsch.It Pa /sys/scsi/cd.c
683cf493c6SJoerg Wunschfiles contains actual driver code
693cf493c6SJoerg Wunsch.It Pa /sys/scsi/scsiconf.h
703cf493c6SJoerg Wunschcontains the defines of the
713cf493c6SJoerg Wunsch.Dv CD_Q_xxx
723cf493c6SJoerg Wunschquirk flags
733cf493c6SJoerg Wunsch.El
743cf493c6SJoerg Wunsch.Sh SEE ALSO
753cf493c6SJoerg Wunsch.Xr cd 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 .
823cf493c6SJoerg Wunsch.Sh AUTHOR
833cf493c6SJoerg WunschThis
843cf493c6SJoerg Wunschmanual page was written by John-Mark Gurney
853cf493c6SJoerg Wunsch.Aq gurney_j@efn.org .
86