CDPLAY(1)               NetBSD General Commands Manual               CDPLAY(1)

NAME
     cdplay -- compact disc player

SYNOPSIS
     cdplay [-a audio device] [-f device] [command ...]

DESCRIPTION
     cdplay is a program to control the audio features of a CD-ROM drive.

     If no command is given, then cdplay enters interactive mode, reading com-
     mands from the standard input.

     The following options are available:

     -a audio device
             Specify the audio device to use.  Used only in digital transfer
             mode.  If not specified, the environment variables AUDIODEV and
             SPEAKER will be tried (in this order) to find the device; as a
             last resort, /dev/sound will be used.

     -f device
             Specify the control device to use.  Both absolute paths and paths
             relative to /dev are accepted.  The suffix `c' (or `d' on some
             architectures, see disklabel(8) for details) is added to the
             device name if needed.  If the device not specified, the environ-
             ment variables MUSIC_CD, CD_DRIVE, DISC and CDPLAY will be tried
             (in this order) to find the device.

     The available commands are listed below.  Only as many characters as are
     required to uniquely identify a command need be specified.  The word play
     can be omitted in all cases.

     play [first_track [last_track]]
                 Play from track first_track to track last_track.  The first
                 track has number 1.

     play [start_m:start_s.start_f [end_m:end_s.end_f]]
                 Play from the absolute address (MSF) defined by start_m in
                 minutes, start_s, in seconds and start_f (frame number) to
                 the absolute address defined by end_m in minutes, end_s, in
                 seconds and end_f (frame number).  Minutes are in the range
                 0-99.  Seconds are in the range 0-59.  Frame numbers are in
                 the range 0-74.

     play [#start_block [length]]
                 Play starting from the logical block start_block using length
                 logical blocks.

     next        Skip to the next track.

     prev        Skip to the previous track.

     pause       Stop playing.  Do not stop the disc.

     resume      Resume playing.  Used after the pause command.

     shuffle     Select shuffle play.  Only valid in interactive mode.

     single [track]
                 Pick a single track and play it repeatedly.  If a track argu-
                 ment is not given the single command will shut shuffle mode
                 off and play the disc normally.  Only valid in interactive
                 mode.

     skip        Skip to another track.  Only valid when shuffle play is
                 selected.

     stop        Stop the disc.

     eject       Eject the disc.

     close       Inject the disc.

     volume left_channel right_channel
                 Set the volume of left channel to left_channel and the volume
                 of right channel to right_channel.  Allowed values are in the
                 range 0-255.

     volume value
                 Set the volume of both left channel right channel to value.
                 Allowed values are in the range 0-255.

     volume mute
                 Turn the sound off.

     volume mono
                 Set the mono mode.

     volume stereo
                 Set the stereo mode.

     volume left
                 Play the left subtrack on both left and right channels.

     volume right
                 Play the right subtrack on both left and right channels.

     info        Print the table of contents.

     status      Display the current audio, media and volume status.

     digital n   Turn on digital transfer mode.  In this mode, cdplay reads
                 digital data from disc and sends it to an audio device.  A
                 SCSI or ATAPI CD-ROM is required; and the audio device must
                 support CD audio format (44100 Hz sampling rate, 16-bit
                 stereo samples).  Audio data are read and written in groups
                 of n frames (5 by default, or 1/15 seconds).

     help        Print the list of available commands.

     reset       Perform the hardware reset of the device.

     set msf     Set minute-second-frame ioctl mode (default).

     set lba     Set LBA ioctl mode.

     quit        Quit the program.

FILES
     /dev/cd??
     /dev/mcd??

SEE ALSO
     disklabel(8), mscdlabel(8)

HISTORY
     The cdplay command first appeared in NetBSD 1.5.  Support for digital
     transfer mode was added in NetBSD 4.0.

NetBSD 5.0_STABLE               April 23, 2007               NetBSD 5.0_STABLE
