CDCTL(1) BSD Reference Manual CDCTL(1)NAMEcdctl - control a cdrom drive
SYNOPSIScdctl [-NPShjlptvw] [-V volume] [-e track] [-f device] [-s track]
DESCRIPTION
The cdctl utility plays a cdrom from beginning to end.
The following options are available:
-N Skip to the next track if the cdrom is playing.
-P Go to the previous track if the cdrom is playing.
-S Stop playing.
-V Set the audio volume (0-100).
-e Specify an ending track number.
-f Specify the cdrom device name. For a SCSI drive, use the C par-
tition of the raw device, for example, /dev/rsr0c.
-h Print a hash code that represents the table of contents.
-j Eject the CD from the drive.
-l Load the CD.
-p Print a status message once per second while the cdrom is play-
ing.
-s Specify a starting track number.
-t Print the table of contents. This is a listing of track numbers
and durations, where durations are specified as minutes, seconds
and frames. (A frame is 1/75'th of a second.)
-v If the -v option is specified, the hexadecimal value of the track
control information is displayed as part of the -t option dis-
play.
-w Wait until the play operation is complete before exiting.
The -j and -l options may not be supported by some devices.
The cdctl utility exits 0 on success, and >0 if an error occurs.
ENVIRONMENT
The CDROM environment variable is used if -f devicename isn't given. In
the event it isn't set the default pathname /dev/rsr0c is used. The de-
vice must be readable by the invoking user.
BUGS
Not all drives implement volume control, and in those that do the sensi-
tivity of the control varies greatly.
The user running cdctl must have read access to the given physical device
(to perform the low level operations required to operate the player).
Anyone with read access to the physical device may issue commands that
could affect all partitions on that device (a user may eject the media
for example). This isn't usually a problem on a CDROM but may cause trou-
ble with other removable media.
