CDCTRL

NAME

cdctrl - command line CDROM control

SYNOPSIS

cdctrl [device]
cdctrl -c [device]
cdctrl -c
cdctrl [-V|-?|-h]

DESCRIPTION

cdctrl command is a program that opens a CDROM device and may be used for interactive control of the CDROM including play starting at a track, next track, previous track, stop, pause, display info, display CDROM status, and display CDROM directory. This program may be used as a daemon to control an audio CDROM device.

The commands to the cdctrl command are:

	device		Open CDROM device.
	-V		Print out version and build information.
	-h		Display help.
	-v		Display help.
	-D		Enable runtime debugging.
	-c		Output CR-LF at end of each line, not LF.

By default, cdctrl opens /dev/cdrom, but does not start playing. Output is to standard output with each line terminated by a linefeed (LF).

Commands to cdctrl are:

	1	Play first track, start playing.
	s	Stop playing.
	p	Pause playing.
	r	Resume playing.
	e	Eject CDROM.
	c	Close CDROM tray.
	i	Display info string.
	d	Display directory.
	-	Play previous track.
	+	Play next track. When on last track, play first track.
	[1..99]	Play track 1..99.
	?	Display help screen.
	q	Quit.

Each command results in one or multiple lines of output to stdout, followed by an info string, followed by END.

The format of the info string is:

CMD cmd-name cd-status track abs-time rel-time

cmd-name := {play, stop, ... quit} from above list
cd-status := {invalid, play, paused}
cd-status += {completed, error, no_status}
track := {1..99} CD track
abs-time := HH:MM:SS elapsed since CD start
rel-time := HH:MM:SS elapsed since track start

FILES

/dev/cdrom - default cdrom device

ENVIRONMENT

CDTOOLDEV - cdrom device, overrides compile time defaults

SEE ALSO

cdplay(1)

AUTHORS

Main code:

Thomas Insel <tinsel@tinsel.org>

Enhancements:

Sven Oliver Moll <smol0075@rz.uni-hildesheim.de>

cdctrl extensions:

Wade Hampton <whampton@staffnet.com>