.Dd August 25, 2016 .Dt CDCONTROL 1 .Os .Sh NAME .Nm cdcontrol .Nd compact disc control utility .Sh SYNOPSIS .Nm .Op Fl sv .Op Fl f Ar device .Op Ar command ... .Sh DESCRIPTION The .Nm utility is a program to control audio features of a CD drive. The device is a name such as
a cd0 .
p If no .Ar command is given, then .Nm enters an interactive mode, reading commands from the standard input.
p The following options are available: l -tag -width indent t Fl s Silent mode. Do not print table headers and human readable comments. t Fl v Verbose mode. Print as much information as possible. t Fl f Ar device Specify a device, such as
a /dev/cd0 . Both absolute path and relative to
a /dev filename are possible. The .Fl f option overrides .Ev CDROM . If neither .Ev CDROM nor the .Fl f option is specified, .Nm tries opening first
p The available commands are listed below. Only as many characters as are required to uniquely identify a command need be specified. The word c play can be omitted or the characters c + and c - can be used in the place of c next and c prev . l -tag -width indent t Ic play Ar first_track Op Ar last_track Play from track .Ar first_track to track .Ar last_track . The first track has number 1. Can be omitted in all cases. t Xo c play .Ar start_m : Ns Ar start_s . Ns Ar start_f .Op Ar end_m : Ns Ar end_s . Ns Ar end_f .Xc Play from the absolute address (MSF) defined by .Ar start_m in minutes, .Ar start_s , in seconds and .Ar start_f (frame number) to the absolute address defined by .Ar end_m in minutes, .Ar end_s , in seconds and .Ar end_f (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59. Frame numbers are in the range 0-74. t Ic play Op # Ns Ar start_block Op Ar length Play starting from the logical block .Ar start_block using .Ar length logical blocks. t Ic next Op Ar tracks Skip forward a number of tracks (default 1). t Ic prev Op Ar tracks Skip backward a number of tracks (default 1). t Ic pause Stop playing. Do not stop the disc. t Ic resume Resume playing. Used after the c pause command. t Ic stop Stop the disc. t Ic eject Eject the disc. t Ic close Inject the disc. t Ic volume Same as .Em status volume command. t Ic volume Ar level Set the volume of both channels to .Ar level . Allowed values are in the range 0-255. t Ic volume Ar left_channel right_channel Set the volume of left channel to .Ar left_channel and the volume of right channel to .Ar right_channel . Allowed values are in the range 0-255. t Ic volume Cm mute Turn the sound off. t Ic volume Cm mono Set the mono mode. t Ic volume Cm stereo Set the stereo mode. t Ic volume Cm left Play the left subtrack on both left and right channels. t Ic volume Cm right Play the right subtrack on both left and right channels. t Ic info Print the table of contents. t Ic status Op Cm audio | media | volume Print the information about the disc:
p l -tag -width ".Cm volume" -compact t Cm audio the current playing status and position t Cm media the current media catalog status t Cm volume the current values of the volume for left and right channels. .El t Ic cdid Display the serial number of the CD using the method used by the .Tn CDDB project
q Pa http://www.cddb.org/ . t Ic help Print the list of available commands. t Ic debug Cm on Enable the debugging mode of the CD device driver. t Ic debug Cm off Disable the driver debugging mode. t Ic reset Perform the hardware reset of the device. t Ic set Cm msf Set minute-second-frame ioctl mode (default). t Ic set Cm lba Set LBA ioctl mode. t Ic speed Ar s Set the highest speed that the drive should use for reading data. The units are multiples of a single speed CDROM (150 KB/s). Specify .Dq Li max to use the drive's fastest speed. t Ic quit Quit the program. .El .Sh ENVIRONMENT The following environment variables affect the execution of .Nm : l -tag -width ".Ev CD_DRIVE" t Ev CDROM The CD device to use, if one is not specified with the .Fl f option. t Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD These variables have been deprecated in favour of .Ev CDROM . .El .Sh FILES l -tag -width ".Pa /dev/cd0" -compact t Pa /dev/cd0 .El .Sh HISTORY The .Nm command appeared in .Fx 2.1 . .Sh AUTHORS .An Jean-Marc Zucconi .An Andrey A. Chernov .An Serge V. Vakulenko