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

FreeBSD Manual Pages


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.

     If	no command is given, then cdcontrol enters an interactive mode,	read-
     ing commands from the standard input.

     The following options are available:

     -s	     Silent mode.  Do not print	table headers and human	readable com-

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

     -f	device
	     Specify a device, such as /dev/cd0.  Both absolute	path and rela-
	     tive 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.

     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	min-
	     utes, start_s, in seconds and start_f (frame number) to the abso-
	     lute 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
	     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 chan-

     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 op-

	       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	13.0			August 25, 2016			  FreeBSD 13.0


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

home | help