cdcontrol -- compact disc control utility
cdcontrol [-sv] [-f device] [command ...]
The cdcontrol utility is a program to control audio features of a CD
drive. The device is a name such as cd0 or acd0.
If no command is given, then cdcontrol enters an interactive mode, reading
commands from the standard input.
The following options are available:
-s Silent mode. Do not print table headers and human readable comments.
-v Verbose mode. Print as much information as possible.
Specify a device, such as /dev/cd0 or acd0. Both absolute path
and relative to /dev filename are possible. The -f option overrides
CDROM. If neither CDROM nor the -f option is specified,
cdcontrol tries opening first /dev/cdrom, then /dev/cd0, and
The available commands are listed below. Only as many characters as are
required to uniquely identify a command need be specified. The word play
can be omitted or the characters + and - can be used in the place of next
play first_track [last_track]
Play from track first_track to track last_track. The first track
has number 1. Can be omitted in all cases.
play start_m:start_s.start_f [end_m:end_s.end_f]
Play from the absolute address (MSF) defined by start_m in minutes,
start_s, in seconds and start_f (frame number) to the absolute
address defined by end_m in minutes, end_s, in seconds and
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.
play [#start_block [length]]
Play starting from the logical block start_block using length
Skip forward a number of tracks (default 1).
Skip backward a number of tracks (default 1).
pause Stop playing. Do not stop the disc.
resume Resume playing. Used after the pause command.
stop Stop the disc.
eject Eject the disc.
close Inject the disc.
volume left_channel right_channel
Set the volume of left channel to left_channel and the volume of
right channel to right_channel. Allowed values are in the range
Turn the sound off.
Set the mono mode.
Set the stereo mode.
Play the left subtrack on both left and right channels.
Play the right subtrack on both left and right channels.
info Print the table of contents.
status [audio | media | volume]
Print the information about the disc:
audio the current playing status and position
media the current media catalog status
volume the current values of the volume for left and right channels.
cdid Display the serial number of the CD using the method used by the
CDDB project (http://www.cddb.org/).
help Print the list of available commands.
Enable the debugging mode of the CD device driver.
Disable the driver debugging mode.
reset Perform the hardware reset of the device.
Set minute-second-frame ioctl mode (default).
Set LBA ioctl mode.
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 ``max'' to use the drive's fastest speed.
quit Quit the program.
The following environment variables affect the execution of cdcontrol:
CDROM The CD device to use, if one is not specified with the -f
CDPLAY, CD_DRIVE, DISC, MUSIC_CD
These variables have been deprecated in favour of CDROM.
Andrey A. Chernov
Serge V. Vakulenko
The cdcontrol command appeared in FreeBSD 2.1.
FreeBSD 5.2.1 May 8, 2002 FreeBSD 5.2.1 [ Back ]