Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
CDCONTROL(1)            FreeBSD General Commands Manual           CDCONTROL(1)

     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

     -v      Verbose mode.  Print as much information as possible.

     -f device
             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 finally /dev/acd0.

     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
     and prev.

     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

     play [#start_block [length]]
             Play starting from the logical block start_block using length
             logical blocks.

     next [tracks]
             Skip forward a number of tracks (default 1).

     prev [tracks]
             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  Same as status volume command.

     volume level
             Set the volume of both channels to level.  Allowed values are in
             the range 0-255.

     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

     volume mute
             Turn the sound off.

     volume mono
             Set the mono mode.

     volume stereo
             Set the stereo mode.

     volume left
             Play the left subtrack on both left and right channels.

     volume right
             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

     cdid    Display the serial number of the CD using the method used by the
             CDDB project (

     help    Print the list of available commands.

     debug on
             Enable the debugging mode of the CD device driver.

     debug off
             Disable the driver debugging mode.

     reset   Perform the hardware reset of the device.

     set msf
             Set minute-second-frame ioctl mode (default).

     set lba
             Set LBA ioctl mode.

     speed 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 ``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

                   These variables have been deprecated in favour of CDROM.


     The cdcontrol command appeared in FreeBSD 2.1.

     Jean-Marc Zucconi
     Andrey A. Chernov
     Serge V. Vakulenko

FreeBSD 11.0-PRERELEASE          June 27, 2008         FreeBSD 11.0-PRERELEASE


Want to link to this manual page? Use this URL:

home | help