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.  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>

CDTOOL
								   29-July-2004 							 CDCTRL(1)