From 2871de848d7f8b3dcc6fbba6a080a04e86479e02 Mon Sep 17 00:00:00 2001 From: dg Date: Wed, 25 Jan 1995 09:18:56 +0000 Subject: Added more missing manual pages from 1.1.5. --- share/man/man4/cd.4 | 179 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 179 insertions(+) create mode 100644 share/man/man4/cd.4 (limited to 'share/man/man4/cd.4') diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4 new file mode 100644 index 0000000..9b2bc71 --- /dev/null +++ b/share/man/man4/cd.4 @@ -0,0 +1,179 @@ +.Dd August 27, 1993 +.Dt CD 4 +.Os FreeBSD +.Sh NAME +.Nm cd +.Nd scsi cdrom driver +.Sh SYNOPSIS +.Nm device-driver cd +.Op Ar count +.Sh DESCRIPTION +The +.Xr cd +driver provides support for a +.Em scsi +cdrom. It allows the cdrom +to be divided up into a set of pseudo devices called +.Em partitions. +In an attempt to look like regular disks the +.Nm +driver synthesises a partition table, with one partition covering the entire +cdrom. A user might (for some amazing reason) add another partition to the +cdrom by using disklabel, but it will last only until the cdrom is unmounted. +A Partition can have both a +.Em raw +interface +and a +.Em Block mode +interface. +In general the interfaces are similar to those described by +.Xr wd 4 +or +.Xr sd 4 . + +.Pp +Where the +.Xr wd 4 +device has a fairly low level interface to the system, +.Em SCSI +devices have a much higher level interface and talk to the system via +a +.Em SCSI Adapter +and a +.Em Scsi Adapter driver +e.g. +.Xr AHA1542 . +A scsi adapter must also be separatly configured into the system +before a scsi cdrom can be configured. +.Pp +As the scsi adapter is probed during boot, the +.Em SCSI +bus is scanned for devices. Any devices found which answer as 'Readonly' +type devices will be 'attached' to the +.Nm +driver. The first found will be attached as +.Em cd0 +and the next, +.Em cd1 +etc. +.Pp +The system utility +.Xr disklabel 1 +may be used to read the synthesized +.Xr disklabel 5 +structure, which will contain correct figures for the size of the cdrom +should that information be required. +.Pp +.Sh KERNEL CONFIGURATION +Any number of cdroms may be attached to the system regardless of system +configuration as all resources are dynamically allocated. + +.Pp +.Sh IOCTLS +The following +.Xr ioctl 2 +calls apply to scsi cdroms +in the header files +.Em sys/cdio.h. +and +.Em sys/disklabel.h + +.Bl -tag -width CDIOCPLAYAUDIO____ + +.It Dv DIOCGDINFO +Read, from the kernel, the in-core copy of the disklabel for the +drive. This will be a ficticious disklabel it will contain information +read from the scsi inquiry commands, and should be the same as +the information printed at boot. +.It Dv DIOCSDINFO +Give the driver a new disklabel to use. The driver will NOT try write the new +disklabel to the disk. (ok?) +.It CDIOCPLAYTRACKS +Start Audio playback given a track address and length. +.It CDIOCPLAYBLOCKS +Start Audio playback given a block address and length. +.It CDIOCPLAYMSF +Start Audio playback given a 'Minutes/ seconds/ frames' address and length. +.It CDIOCREADSUBCHANNEL +Read information from the subchannel at the location specified. +.It CDIOREADTOCHEADER +Return summary information about the table of contents for the mounted cdrom. +.It CDIOREADTOCENTRYS +Return information from the table of contents entries mentionned. +.It CDIOCSETPATCH +Attach various audio channels to various output channels. +.It CDIOCGETVOL +Get information about the volume settings of the output channels. +.It CDIOCSETVOL +Change the volume settings of the output channels. +.It CDIOCSETMONO +Patch all out[put channels to all source channels. +.It CDIOCSETSTERIO +Patch left source channel to the left output channel and the right +source channel to the right output channel. +.It CDIOCSETMUTE +Mute output without changing the volume settings. +.It CDIOCSETLEFT +Attach both output channels to the left source channel. +.It CDIOCSETRIGHT +Attach both output channels to the right source channel. +.It CDIOCSETDEBUG +Turn on debugging for the appropriate device. +.It CDIOCCLRDEBUG +Turn off debugging for the appropriate device. +.It CDIOCPAUSE +Pause audio play, do not reset the location of the read-head. +.It CDIOCRESUME +Resume audio play, Start at the location of the pause. +.It CDIOCRESET +Reset the drive. +.It CDIOCSTART +Tell the drive to spin-up the cdrom. +.It CDIOCSTOP +Tell the drive to spin-down the cdrom. +.It CDIOCEJECT +Eject the cdrom. +.El +.Pp +In addition the general +.Xr scsi 4 +ioctls may be used with the +.Nm +driver, if used against the fourth (raw/whole disk) partiton. (e.g. rcd0d) +.Sh NOTES +When a cdrom is changed in a drive controlled by the +.Nm +driver, then the act of changing the media will invalidate the +disklabel and information held within the kernel. To stop corruption, +All accesses to the device will be discarded until there are no more +open file descriptors referencing the device. During this period, all +new open attempts will be rejected. When No more open file descriptors +reference the device, the first next open will load a new set of +figures (including disklabel) for the drive. + +The Audio code in the +.Nm +driver only support SCSI2 standard audio commands. As there are many cdrom +manufacturers who have not followed the standard well, there are many +cdroms for which audio will not work. Some work is planned to support +some of the more common 'broken' cdrom drives however this is not yet +under way. + +.Sh FILES +.Bl -tag -width /dev/rcd[0-9][a-h] -compact +.It Pa /dev/cd[0-9][a-h] +block mode scsi disks +.It Pa /dev/rcd[0-9][a-h] +raw scsi disks +.El +.Sh DIAGNOSTICS +None. +.Sh SEE ALSO +.Xr disklabel 1 +.Xr disklabel 5 +.Xr wd 4 +.Xr sd 4 +.Sh HISTORY +This +.Nm +driver appeared in 386BSD 0.1. -- cgit v1.1