a438c2d1f9
earlier, sleep(3) until playing finished) -also switch to digital mode if an audio device is given on the cmd line, or the (new) "CDPLAY_DIGITAL" env var is set (The latter can be used to make digital mode default per system. As I see it, analog mode is not dead yet - two of three external DVD drives I looked at have a speaker output.)
220 lines
5.7 KiB
Groff
220 lines
5.7 KiB
Groff
.\" $NetBSD: cdplay.1,v 1.24 2012/01/04 17:26:21 drochner Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999, 2000 Andrew Doran.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" from FreeBSD: cdcontrol.1,v 1.16.2.2 1999/01/31 15:36:01 billf Exp
|
|
.\"
|
|
.Dd January 3, 2012
|
|
.Dt CDPLAY 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm cdplay
|
|
.Nd compact disc player
|
|
.Sh SYNOPSIS
|
|
.Nm cdplay
|
|
.Op Fl a Ar audio device
|
|
.Op Fl f Ar device
|
|
.Op Ar command ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a program to control the audio features of a CD-ROM drive.
|
|
.Pp
|
|
If no command is given, then
|
|
.Nm
|
|
enters interactive mode, reading commands from the standard input.
|
|
.Pp
|
|
The following options are available:
|
|
.Bl -tag -width indent
|
|
.It Fl a Ar audio device
|
|
Specify the audio device to use.
|
|
Used only in digital transfer mode.
|
|
If not specified, the environment variables
|
|
.Ev AUDIODEV
|
|
and
|
|
.Ev SPEAKER
|
|
will be tried (in this order) to find the device; as a last resort,
|
|
.Pa /dev/sound
|
|
will be used.
|
|
If the
|
|
.Dq Fl a
|
|
command line option is used, or the
|
|
.Ev CDPLAY_DIGITAL
|
|
environment variable is present,
|
|
digital transfer mode is switched on automatically.
|
|
.It Fl f Ar device
|
|
Specify the control device to use.
|
|
Both absolute paths and paths relative to
|
|
.Pa /dev
|
|
are accepted.
|
|
The suffix
|
|
.Ql c
|
|
(or
|
|
.Ql d
|
|
on some architectures, see
|
|
.Xr disklabel 8
|
|
for details) is added to the
|
|
device name if needed.
|
|
If the device not specified, the environment variables
|
|
.Ev MUSIC_CD ,
|
|
.Ev CD_DRIVE ,
|
|
.Ev DISC
|
|
and
|
|
.Ev CDPLAY
|
|
will be tried (in this order) to find the device.
|
|
.El
|
|
.Pp
|
|
The available commands are listed below.
|
|
Only as many characters as are required to uniquely identify a command
|
|
need be specified.
|
|
The word
|
|
.Em play
|
|
can be omitted in all cases.
|
|
.Bl -tag -width Cm
|
|
.It Cm play Op Ar first_track Op Ar last_track
|
|
Play from track
|
|
.Ar first_track
|
|
to track
|
|
.Ar last_track .
|
|
The first track has number 1.
|
|
.It Cm play Op Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
|
|
Play from the absolute address
|
|
(MSF) defined by
|
|
.Ar start_m
|
|
in minutes,
|
|
.Ar start_s ,
|
|
in seconds and
|
|
.Ar start_f
|
|
(frame number) to the absolute address defined by
|
|
.Ar end_m
|
|
in minutes,
|
|
.Ar end_s ,
|
|
in seconds and
|
|
.Ar 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.
|
|
.It Cm play Op Ar #start_block Op length
|
|
Play starting from the logical block
|
|
.Ar start_block
|
|
using
|
|
.Ar length
|
|
logical blocks.
|
|
.It Cm next
|
|
Skip to the next track.
|
|
.It Cm prev
|
|
Skip to the previous track.
|
|
.It Cm pause
|
|
Stop playing.
|
|
Do not stop the disc.
|
|
.It Cm resume
|
|
Resume playing.
|
|
Used after the
|
|
.Em pause
|
|
command.
|
|
.It Cm shuffle
|
|
Select shuffle play.
|
|
Only valid in interactive mode.
|
|
.It Cm single Op Ar track
|
|
Pick a single track and play it repeatedly.
|
|
If a
|
|
.Ar track
|
|
argument is not given the
|
|
.Cm single
|
|
command will shut shuffle mode off and play the disc normally.
|
|
Only valid in interactive mode.
|
|
.It Cm skip
|
|
Skip to another track.
|
|
Only valid when shuffle play is selected.
|
|
.It Cm stop
|
|
Stop the disc.
|
|
.It Cm eject
|
|
Eject the disc.
|
|
.It Cm close
|
|
Inject the disc.
|
|
.It Cm volume Ar left_channel Ar right_channel
|
|
Set the volume of left channel to
|
|
.Ar left_channel
|
|
and the volume of right channel to
|
|
.Ar right_channel .
|
|
Allowed values are in the range 0-255.
|
|
.It Cm volume Ar value
|
|
Set the volume of both left channel right channel to
|
|
.Ar value .
|
|
Allowed values are in the range 0-255.
|
|
.It Cm volume mute
|
|
Turn the sound off.
|
|
.It Cm volume mono
|
|
Set the mono mode.
|
|
.It Cm volume stereo
|
|
Set the stereo mode.
|
|
.It Cm volume left
|
|
Play the left subtrack on both left and right channels.
|
|
.It Cm volume right
|
|
Play the right subtrack on both left and right channels.
|
|
.It Cm info
|
|
Print the table of contents.
|
|
.It Cm status
|
|
Display the current audio, media and volume status.
|
|
.It Cm digital Ar n
|
|
Turn on digital transfer mode.
|
|
In this mode,
|
|
.Nm
|
|
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
|
|
.Ar n
|
|
frames (5 by default, or 1/15 seconds).
|
|
.It Cm analog
|
|
Switch from digital back to analog mode.
|
|
.It Cm help
|
|
Print the list of available commands.
|
|
.It Cm reset
|
|
Perform the hardware reset of the device.
|
|
.It Cm set msf
|
|
Set minute-second-frame ioctl mode (default).
|
|
.It Cm set lba
|
|
Set LBA ioctl mode.
|
|
.It Cm quit
|
|
Quit the program.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width /dev/rmcd0c -compact
|
|
.It Pa /dev/cd??
|
|
.It Pa /dev/mcd??
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr disklabel 8 ,
|
|
.Xr mscdlabel 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
command first appeared in
|
|
.Nx 1.5 .
|
|
Support for digital transfer mode was added in
|
|
.Nx 4.0 .
|