CDIO(1) BSD Reference Manual CDIO(1)
cdio - compact disc audio player and control utility
cdio [-sv] [-d host:port] [-f device] [command args ...]
The cdio program controls audio features of a CD drive. The device is a
name such as "cd0" or "mcd0".
If a device is not specified, the environment variable DISC will be used
to find the CD device.
If no command is given, cdio enters an interactive mode, reading commands
from the standard input.
The options are as follows:
-d host:port
Specifies cddb host (default: freedb.freedb.org:cddb).
-f device
Specifies a device name such as /dev/rcd0d or mcd0. Both absolute
and relative paths to /dev filenames are possible. The raw parti-
tion name is added if needed.
-s Silent mode. Do not print table headers or human-readable com-
ments.
-v Verbose mode. Print as much information as possible.
The available commands are listed below. Only as many characters as are
required to uniquely identify a command need be specified. The word play
may be omitted.
cddb [n]
Print the table of contents after matching the disc with the
cddb. In case of multiple matches, reissue the command with n.
cdid Print the disc ID that will be used for matching with the cddb.
close Inject the disc.
debug on | off
Enable/disable the debugging mode of the CD device driver.
device devname
Make devname the current CD device. This is the equivalent of
quitting cdio and restarting with a different device.
eject Eject the disc.
exit A synonym for quit.
help Print the list of available commands.
info Print the table of contents.
lock Lock the drive door, preventing it from being opened manually.
The lock is only in effect during run time of cdio, and can be
rescinded with, for example, the eject command.
next Play the next track. If we're at the last track, stop.
pause Stop playing. Do not stop the disc.
play first_track [last_track]
Play from track first_track to track last_track. The first track
has number 1 and may 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
logical blocks.
previous
Play the previous track. If we're at the first track, restart.
quit Quit the program.
replay Replay the current track again.
reset Perform a hardware reset of the device.
resume Resume playing. Used after the pause command.
set lba | msf
Set LBA (lba) or minute-second-frame (msf) ioctl mode. The de-
fault is minute-second-frame ioctl mode.
status Print information about the disc: the current playing status and
position, the current media catalog status, and the current
values of the volume for left and right channels.
stop Stop the disc.
volume left_channel right_channel
Set the volume of the left channel to left_channel and the volume
of the right channel to right_channel. Allowed values are in the
range 0-255.
volume left
Play the left subtrack on both left and right channels.
volume mono
Set the mono mode.
volume mute
Turn the sound off.
volume right
Play the right subtrack on both left and right channels.
volume stereo
Set the stereo mode.
/dev/rcd0c
/dev/rmcd0c
aucat(1), audioctl(1), mixerctl(1), audio(4)
The cdio command is based on cdcontrol, which first appeared in
FreeBSD 2.1.
Jean-Marc Zucconi, Andrey A. Chernov, Serge V. Vakulenko, Marc Espie
MirOS BSD #10-current February 9, 2009 2
Generated on 2010-01-30 03:26:42 by $MirOS: src/scripts/roff2htm,v 1.58 2009/02/17 12:55:22 tg Exp $
These manual pages are copyrighted
by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors.
The rest is Copyright © 2002-2008 The
MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.