cdtool :: cdctrl(1)

CDCTRL(1)                        User Commands                       CDCTRL(1)

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.  Out-
       put 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, fol-
       lowed 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>

CDTOOL                           29-July-2004                        CDCTRL(1)