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
andSPEAKER
will be tried (in this order) to find the device; as a last resort, /dev/sound will be used. If the “-a
” command line option is used, or theCDPLAY_DIGITAL
environment variable is present, digital transfer mode is switched on automatically. -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 variablesMUSIC_CD
,CD_DRIVE
,DISC
andCDPLAY
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). analog
- Switch from digital back to analog mode.
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
HISTORY
The cdplay
command first appeared in
NetBSD 1.5. Support for digital transfer mode was
added in NetBSD 4.0.