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 commands 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 environment 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
argument 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
NetBSD1.5.
Support for digital transfer mode was added in
NetBSD4.0.