1998-01-26 00:57:54 +00:00
|
|
|
.\" $Id: cdcontrol.1,v 1.14 1998/01/07 07:43:04 charnier Exp $
|
1996-10-05 22:27:30 +00:00
|
|
|
.\"
|
1995-08-18 11:41:32 +00:00
|
|
|
.Dd July 3, 1995
|
|
|
|
.Dt CDCONTROL 1
|
|
|
|
.Os FreeBSD
|
|
|
|
.Sh NAME
|
|
|
|
.Nm cdcontrol
|
|
|
|
.Nd compact disc control utility
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm cdcontrol
|
|
|
|
.Op Fl s
|
|
|
|
.Op Fl v
|
|
|
|
.Op Fl f Ar discname
|
1997-09-04 11:52:28 +00:00
|
|
|
.Op Ar command args ...
|
1995-08-18 11:41:32 +00:00
|
|
|
.Sh DESCRIPTION
|
1997-09-04 11:52:28 +00:00
|
|
|
.Nm Cdcontrol
|
1995-08-18 11:41:32 +00:00
|
|
|
is a program to control audio features of a CD drive. The device is a name such
|
1997-12-08 07:43:13 +00:00
|
|
|
as
|
|
|
|
.Pa cd0
|
|
|
|
or
|
|
|
|
.Pa mcd0 .
|
1995-08-18 11:41:32 +00:00
|
|
|
.Pp
|
|
|
|
If the device not specified, the environment variable
|
|
|
|
.Ev DISC
|
|
|
|
will be used to find the cd device.
|
|
|
|
.Pp
|
|
|
|
If no command is given, then
|
1997-09-04 11:52:28 +00:00
|
|
|
.Nm
|
1995-08-18 11:41:32 +00:00
|
|
|
enters an interactive mode, reading commands from the standard input.
|
|
|
|
.Pp
|
|
|
|
The following options are available:
|
1997-12-08 07:43:13 +00:00
|
|
|
.Bl -tag -width indent
|
1995-08-18 11:41:32 +00:00
|
|
|
.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 discname
|
1997-12-08 07:43:13 +00:00
|
|
|
Specify a device name, such as
|
|
|
|
.Pa /dev/cd0c
|
|
|
|
or
|
|
|
|
.Pa mcd0 .
|
|
|
|
Both absolute path and relative to
|
|
|
|
.Pa /dev
|
|
|
|
filename are possible.
|
1995-08-18 11:41:32 +00:00
|
|
|
Suffix `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
|
1996-02-09 00:22:17 +00:00
|
|
|
need be specified. Word
|
1997-12-08 07:43:13 +00:00
|
|
|
.Em play
|
1997-09-13 16:01:53 +00:00
|
|
|
can be omitted.
|
1995-08-18 11:41:32 +00:00
|
|
|
.Bl -tag -width Cm
|
|
|
|
|
1996-02-03 14:13:36 +00:00
|
|
|
.It Cm play Ar first_track Op Ar last_track
|
1995-08-18 11:41:32 +00:00
|
|
|
Play from track
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar first_track
|
1995-08-18 11:41:32 +00:00
|
|
|
to track
|
1998-01-07 07:43:04 +00:00
|
|
|
.Ar last_track .
|
1995-08-18 11:41:32 +00:00
|
|
|
The first track has number 1.
|
1997-12-08 07:43:13 +00:00
|
|
|
Can be omitted in all cases.
|
1995-08-18 11:41:32 +00:00
|
|
|
|
|
|
|
.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
|
|
|
|
Play from the absolute address
|
|
|
|
(MSF) defined by
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar start_m
|
1995-08-18 11:41:32 +00:00
|
|
|
in minutes,
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar start_s ,
|
1995-08-18 11:41:32 +00:00
|
|
|
in seconds and
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar start_f
|
1996-01-30 13:52:50 +00:00
|
|
|
(frame number) to the absolute address defined by
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar end_m
|
1995-08-18 11:41:32 +00:00
|
|
|
in minutes,
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar end_s ,
|
1995-08-18 11:41:32 +00:00
|
|
|
in seconds and
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar end_f
|
1995-08-18 11:41:32 +00:00
|
|
|
(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
|
|
|
|
Frame numbers are in the range 0-74.
|
|
|
|
|
1996-02-03 14:13:36 +00:00
|
|
|
.It Cm play Op Ar #start_block Op length
|
1995-08-18 11:41:32 +00:00
|
|
|
Play starting from the logical block
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar start_block
|
1995-08-18 11:41:32 +00:00
|
|
|
using
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar length
|
1995-08-18 11:41:32 +00:00
|
|
|
logical blocks.
|
|
|
|
|
|
|
|
.It Cm pause
|
|
|
|
Stop playing. Do not stop the disc.
|
|
|
|
|
|
|
|
.It Cm resume
|
|
|
|
Resume playing. Used after the
|
1997-12-08 07:43:13 +00:00
|
|
|
.Em pause
|
|
|
|
command.
|
1995-08-18 11:41:32 +00:00
|
|
|
|
|
|
|
.It Cm stop
|
|
|
|
Stop the disc.
|
|
|
|
|
|
|
|
.It Cm eject
|
|
|
|
Eject the disc.
|
|
|
|
|
1996-02-09 00:22:17 +00:00
|
|
|
.It Cm close
|
1996-02-02 22:03:37 +00:00
|
|
|
Inject the disc.
|
|
|
|
|
1995-08-18 11:41:32 +00:00
|
|
|
.It Cm volume Ar left_channel Ar right_channel
|
|
|
|
Set the volume of left channel to
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar left_channel
|
1995-08-18 11:41:32 +00:00
|
|
|
and the volume of right channel to
|
1997-12-08 07:43:13 +00:00
|
|
|
.Ar right_channel .
|
1995-08-18 11:41:32 +00:00
|
|
|
Allowed values are in the range 0-255.
|
|
|
|
|
|
|
|
.It Cm volume Ar mute
|
|
|
|
Turn the sound off.
|
|
|
|
|
|
|
|
.It Cm volume Ar mono
|
|
|
|
Set the mono mode.
|
|
|
|
|
|
|
|
.It Cm volume Ar stereo
|
|
|
|
Set the stereo mode.
|
|
|
|
|
|
|
|
.It Cm volume Ar left
|
|
|
|
Play the left subtrack on both left and right channels.
|
|
|
|
|
|
|
|
.It Cm volume Ar right
|
|
|
|
Play the right subtrack on both left and right channels.
|
|
|
|
|
|
|
|
.It Cm info
|
1996-10-05 22:27:30 +00:00
|
|
|
Print the table of contents.
|
1996-02-03 14:13:36 +00:00
|
|
|
|
1998-01-26 00:57:54 +00:00
|
|
|
.It Cm status
|
|
|
|
.Op Ar audio | media | volume
|
|
|
|
|
1995-08-18 11:41:32 +00:00
|
|
|
Print the information about the disc:
|
1998-01-26 00:57:54 +00:00
|
|
|
|
|
|
|
.Nm audio
|
1995-08-18 11:41:32 +00:00
|
|
|
the current playing status and position,
|
1998-01-26 00:57:54 +00:00
|
|
|
|
|
|
|
.Nm media
|
1996-02-03 15:07:32 +00:00
|
|
|
the current media catalog status,
|
1998-01-26 00:57:54 +00:00
|
|
|
|
|
|
|
.Nm volume
|
1996-02-03 14:13:36 +00:00
|
|
|
the current values of the volume for left and right channels.
|
1995-08-18 11:41:32 +00:00
|
|
|
|
|
|
|
.It Cm help
|
|
|
|
Print the list of available commands.
|
|
|
|
|
|
|
|
.It Cm debug Ar on
|
|
|
|
Enable the debugging mode of the CD device driver.
|
|
|
|
|
|
|
|
.It Cm debug Ar off
|
|
|
|
Disable the driver debugging mode.
|
|
|
|
|
1996-02-03 14:13:36 +00:00
|
|
|
.It Cm reset
|
1995-08-18 11:41:32 +00:00
|
|
|
Perform the hardware reset of the device.
|
|
|
|
|
1996-02-03 14:13:36 +00:00
|
|
|
.It Cm set Ar msf
|
|
|
|
Set minute-second-frame ioctl mode (default).
|
|
|
|
|
|
|
|
.It Cm set Ar lba
|
|
|
|
Set LBA ioctl mode.
|
|
|
|
|
1995-08-18 11:41:32 +00:00
|
|
|
.It Cm quit
|
|
|
|
Quit the program.
|
|
|
|
|
|
|
|
.Sh FILES
|
|
|
|
.Bl -tag -width /dev/rmcd0c -compact
|
|
|
|
.It Pa /dev/rcd0c
|
|
|
|
.It Pa /dev/rmcd0c
|
|
|
|
.It Pa /dev/rwcd0c
|
|
|
|
.El
|
|
|
|
.Sh AUTHORS
|
1997-12-08 07:43:13 +00:00
|
|
|
.An Jean-Marc Zucconi ,
|
|
|
|
.An Andrey A.\ Chernov ,
|
|
|
|
.An Serge V.\ Vakulenko
|
1995-08-18 11:41:32 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
1997-09-04 11:52:28 +00:00
|
|
|
.Nm
|
1996-08-23 00:57:08 +00:00
|
|
|
command appeared in
|
|
|
|
.Fx 2.1 .
|