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

AUTHORS

Main code:

Thomas Insel <[email protected]>

Enhancements:

Sven Oliver Moll <[email protected]>

cdctrl extensions:

Wade Hampton <[email protected]>