CDTOOL(1)                  Unix Programmer's Manual                  CDTOOL(1)

       cdtool - play and catalog audio CDROMs on CDROM drive(s)

       cdadd     [-[0..9]|-d device]
       cdeject   [-[0..9]|-d device]  [-V|-?|-h]
       cdir -n   [-[0..9]|-d device]  [-r|-s|-t|-V|-?|-h]
       cdinfo    [-[0..9]|-d device]  [-a|-r|-s|-t|-v|-V|-?|-h]
       cdpause   [-[0..9]|-d device]  [-V|-?|-h]
       cdplay    [-[0..9]|-d device]  [start [stop]
       cdplay    [-[0..9]|-d device]  [+|- number]
       cdplay    [-[0..9]|-d device]  [start|stop|resume|eject|info|dir]
       cdplay    [-[0..9]|-d device]  [-V|-?|-h]
       cdstop    [-[0..9]|-d device]  [-V|-?|-h]
       cdshuffle [-[0..9]|-d device]  [-V|-?|-h]

       The cdadd command is a shell script which uses cdir -t and assists
       users in adding a new entry to the ~/.cdtooldb database file.  It
       allows the user to edit a blank template database entry for the current
       compact disc, and then appends it to the file.

       The cdeject command ejects the current compact disc.

       The cdir command lists information about the currently loaded audio
       compact disc.  In particular, it lists the lengths of all tracks.  It
       also references the database files specified in the CDTOOLPATHDB
       environment variable and the ~/.cdtooldb file, which use a simplified
       version of the format used by workman(1).  If one of these files
       contains an entry for the current compact disc, cdir will print title,
       artist, and track name information.

              -n     Do not lookup any information in the database files.

              -s     Print information in a short format: only author, title,
                     and current track, all on one line.

              -t     Print a template for the current cd, including title,
                     artist, and track name information if available. If blank
                     lines are filled in, this can be appended to the
                     ~/.cdtooldb file.

       The cdinfo command, with no option used, will print out the audiostatus
       (playing, etc.).

              -a     Print out the absolute disc time.

              -r     Print out the relative track time.

              -s     Print out the audiostatus.

              -t     Print out the current track.

              -v     All info: status track absolute relative.

       The cdpause command pauses the currently playing compact disc.  Resume
       by using cdplay with no arguments.

       The cdplay command plays the compact disc.  If called with one
       argument, this is the starting track number.  If called with two
       arguments, these are the starting and stopping track numbers. If the
       first argument is a + or - then skip the number of tracks given by the
       second argument forward or backward. If no second argument is give,
       skip one. A 0 as first argument or no argument replays current track.

       The cdstop command stops the compact disc, if it is playing.

       The cdshuffle command plays the audio tracks on the disc in random

       The default device opened is /dev/cdrom.  This default and others may
       be changed in config.h. Options supported by all programs are:

                     Multiple cdrom support to open /dev/scd0../dev/scd7 [by

              -d     Multiple cdrom support to open device by name.

                     Print out help for the command.

              -V     Print out version information and build information.

       ~/.cdtooldb - default database file.

       CDTOOLDBPATH - colon delimited path of database files to search.  It is
       not necessary to specify ~/.cdtooldb, as this is automatically added to
       the end of the search path.

       CDTOOLDEV - device file for cd-rom, overrides compile-time defaults.


       Main code:
              Thomas Insel <>
              Byron Ellacott           <>
              Wade Hampton        <>
              Lin Zhe Min         <>
              Sven Oliver Moll    <>
              Daniel R. Risacher  <>

LOCAL                            24-June-1998                        CDTOOL(1)