1813115081
* Change atapi-cd ioctls to use the same units. * Change burncd, cdcontrol to convert CDROM speed to KB/sec before calling the ioctl. Add a "max" speed option for their command lines. This change does not break ABI but does change the units passed through the ioctl so 3rd party software that uses cdrio.h will have to convert (most likely by multiplying CDROM speed by 177 to get KB/s). PR: kern/36845 Submitted by: Philipp Mergenthaler <p@i609a.hadiko.de> (CAM ioctls) Reviewed by: sos, ken MFC after: 1 month
200 lines
4.1 KiB
Groff
200 lines
4.1 KiB
Groff
.\" $FreeBSD$
|
|
.\"
|
|
.Dd May 8, 2002
|
|
.Dt CDCONTROL 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm cdcontrol
|
|
.Nd compact disc control utility
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl sv
|
|
.Op Fl f Ar device
|
|
.Op Ar command ...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility is a program to control audio features of a CD drive.
|
|
The device is a name such
|
|
as
|
|
.Pa cd0
|
|
or
|
|
.Pa mcd0 .
|
|
.Pp
|
|
If no
|
|
.Ar command
|
|
is given, then
|
|
.Nm
|
|
enters an interactive mode, reading commands from the standard input.
|
|
.Pp
|
|
The following options are available:
|
|
.Bl -tag -width indent
|
|
.It Fl s
|
|
Silent mode.
|
|
Do not print table headers and human readable comments.
|
|
.It Fl v
|
|
Verbose mode.
|
|
Print as much information as possible.
|
|
.It Fl f Ar device
|
|
Specify a device, such as
|
|
.Pa /dev/cd0c
|
|
or
|
|
.Pa mcd0 .
|
|
Both absolute path and relative to
|
|
.Pa /dev
|
|
filename are possible.
|
|
Suffix
|
|
.Pa c
|
|
is added to the device name if needed.
|
|
.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
|
|
.Ic play
|
|
can be omitted or the characters
|
|
.Ic +
|
|
and
|
|
.Ic -
|
|
can be used in the
|
|
place of
|
|
.Ic next
|
|
and
|
|
.Ic prev .
|
|
.Bl -tag -width indent
|
|
.It Ic play Ar first_track Op Ar last_track
|
|
Play from track
|
|
.Ar first_track
|
|
to track
|
|
.Ar last_track .
|
|
The first track has number 1.
|
|
Can be omitted in all cases.
|
|
.It Xo
|
|
.Ic play
|
|
.Ar start_m : Ns Ar start_s . Ns Ar start_f
|
|
.Op Ar end_m : Ns Ar end_s . Ns Ar end_f
|
|
.Xc
|
|
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 Ic play Op # Ns Ar start_block Op Ar length
|
|
Play starting from the logical block
|
|
.Ar start_block
|
|
using
|
|
.Ar length
|
|
logical blocks.
|
|
.It Ic next Op Ar tracks
|
|
Skip forward a number of tracks (default 1).
|
|
.It Ic prev Op Ar tracks
|
|
Skip backward a number of tracks (default 1).
|
|
.It Ic pause
|
|
Stop playing.
|
|
Do not stop the disc.
|
|
.It Ic resume
|
|
Resume playing.
|
|
Used after the
|
|
.Ic pause
|
|
command.
|
|
.It Ic stop
|
|
Stop the disc.
|
|
.It Ic eject
|
|
Eject the disc.
|
|
.It Ic close
|
|
Inject the disc.
|
|
.It Ic volume Ar left_channel 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 Ic volume Cm mute
|
|
Turn the sound off.
|
|
.It Ic volume Cm mono
|
|
Set the mono mode.
|
|
.It Ic volume Cm stereo
|
|
Set the stereo mode.
|
|
.It Ic volume Cm left
|
|
Play the left subtrack on both left and right channels.
|
|
.It Ic volume Cm right
|
|
Play the right subtrack on both left and right channels.
|
|
.It Ic info
|
|
Print the table of contents.
|
|
.It Ic status Op Cm audio | media | volume
|
|
Print the information about the disc:
|
|
.Pp
|
|
.Bl -tag -width ".Cm volume" -compact
|
|
.It Cm audio
|
|
the current playing status and position
|
|
.It Cm media
|
|
the current media catalog status
|
|
.It Cm volume
|
|
the current values of the volume for left and right channels.
|
|
.El
|
|
.It Ic cdid
|
|
Display the serial number of the CD using the method used by the
|
|
.Tn CDDB
|
|
project
|
|
.Pq Pa http://www.cddb.org/ .
|
|
.It Ic help
|
|
Print the list of available commands.
|
|
.It Ic debug Cm on
|
|
Enable the debugging mode of the CD device driver.
|
|
.It Ic debug Cm off
|
|
Disable the driver debugging mode.
|
|
.It Ic reset
|
|
Perform the hardware reset of the device.
|
|
.It Ic set Cm msf
|
|
Set minute-second-frame ioctl mode (default).
|
|
.It Ic set Cm lba
|
|
Set LBA ioctl mode.
|
|
.It Ic speed Ar s
|
|
Set the highest speed that the drive should use for reading data.
|
|
The units are multiples of a single speed CDROM (150 KB/s).
|
|
Specify "max" to use the drive's fastest speed.
|
|
.It Ic quit
|
|
Quit the program.
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
The following environment variables affect the execution of
|
|
.Nm :
|
|
.Bl -tag -width ".Ev CD_DRIVE"
|
|
.It Ev CDROM
|
|
The CD device to use, if one is not specified with the
|
|
.Fl f
|
|
option.
|
|
.It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
|
|
These variables have been deprecated in favour of
|
|
.Ev CDROM .
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width ".Pa /dev/mcd0c" -compact
|
|
.It Pa /dev/cd0c
|
|
.It Pa /dev/mcd0c
|
|
.It Pa /dev/acd0c
|
|
.El
|
|
.Sh AUTHORS
|
|
.An Jean-Marc Zucconi
|
|
.An Andrey A. Chernov
|
|
.An Serge V. Vakulenko
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
command appeared in
|
|
.Fx 2.1 .
|