cdcontrol(1M)

NAME | SYNOPSIS | DESCRIPTION | FILES | ATTRIBUTES

NAME

cdcontrol- compact disc control utility

SYNOPSIS

cdcontrol [-sv] [-f device] [command...]

DESCRIPTION

cdcontrol is a program to control the audio features of a CD drive. The device is a name such as cd0 or mcd0.

If the device is not specified, the environment variables MUSIC_CD, CD_DRIVE, DISC and CDPLAY are used (in this order) to find the cd device.

If no command is given, cdcontrol enters an interactive mode, reading commands from the standard input.

The following options are available:

-s

Silent mode - does not print table headers or comments visible to users.

-v

Verbose mode - prints as much information as possible.

-f device

Specifies a device, such as /dev/cd0c or mcd0. Both an absolute path and a path relative to /dev filename are possible. Suffix `c' is added to the device name, if required.

The available commands are listed below. Only as many characters as are required to identify a command uniquely need be specified. Word play can be omitted.

play first_track [last_track]

Plays 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]

Plays 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]]

Plays starting from the logical block start_block using length logical blocks.

pause

Stops playing. Does not stop the disc.

resume

Resumes playing. Used after the pause command.

stop

Stops the disc.

eject

Ejects the disc.

close

Inserts the disc.

volume left_channel right_channel

Sets the volume of left channel to left_channel and the volume of right channel to right_channel. Permitted values are in the range 0-255.

volume mute

Turns the sound off.

volume mono

Sets the mono mode.

volume stereo

Sets the stereo mode.

volume left

Plays the left subtrack on both left and right channels.

volume right

Plays the right subtrack on both left and right channels.

info

Prints the table of contents.

status [audio | media | volume]

Prints 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 the left and right channels.

cdid

Displays the serial number of the cd using the method used by the cddb (http://www.cddb.org/) project.

help

Prints the list of available commands.

debug on

Enables the debugging mode of the CD device driver.

debug off

Disables the driver debugging mode.

reset

Performs a hardware reset of the device.

set msf

Sets minute-second-frame ioctl mode (default).

set lba

Sets LBA ioctl mode.

quit

Quits the program.

FILES

• /dev/cd0c
• /dev/mcd0c
• /dev/acd0c

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

NAME | SYNOPSIS | DESCRIPTION | FILES | ATTRIBUTES