version 1.16, 2000/03/05 00:28:52 |
version 1.17, 2000/03/05 20:09:19 |
|
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
.Nm |
.Nm |
program controls audio features of a CD drive. The |
program controls audio features of a CD drive. |
|
The |
.Ar device |
.Ar device |
is a name such |
is a name such |
as |
as |
.Dq cd0 , |
.Dq cd0 |
or |
or |
.Dq mcd0 . |
.Dq mcd0 . |
.Pp |
.Pp |
|
|
The options are as follows: |
The options are as follows: |
.Bl -tag -width flag |
.Bl -tag -width flag |
.It Fl s |
.It Fl s |
Silent mode. Do not print table headers or human-readable comments. |
Silent mode. |
|
Do not print table headers or human-readable comments. |
.It Fl v |
.It Fl v |
Verbose mode. Print as much information as possible. |
Verbose mode. |
|
Print as much information as possible. |
.It Fl f Ar device |
.It Fl f Ar device |
Specifies a device name such as |
Specifies a device name such as |
.Pa /dev/rcd0d |
.Pa /dev/rcd0d |
|
|
The raw partition name is added if needed. |
The raw partition name is added if needed. |
.El |
.El |
.Pp |
.Pp |
The available commands are listed below. Only as many |
The available commands are listed below. |
characters as are required to uniquely identify a command |
Only as many characters as are required to uniquely identify a command |
need be specified. The word |
need be specified. |
.Cm play |
The word |
|
.Ic play |
may be omitted. |
may be omitted. |
.Bl -tag -width Cm |
.Bl -tag -width Ic |
.It Cm play Ar first_track Op Ar last_track |
.It Ic play Ar first_track Op Ar last_track |
Play from track |
Play from track |
.Ar first_track |
.Ar first_track |
to track |
to track |
.Ar last_track . |
.Ar last_track . |
The first track has number 1 and may be omitted in all cases. |
The first track has number 1 and may be omitted in all cases. |
.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f |
.It Ic play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f |
Play from the absolute address |
Play from the absolute address |
(MSF) defined by |
(MSF) defined by |
.Ar start_m |
.Ar start_m |
in minutes, |
in minutes, |
.Ar start_s, |
.Ar start_s |
in seconds and |
in seconds, and |
.Ar start_f |
.Ar start_f |
(frame number) to the absolute address defined by |
(frame number) to the absolute address defined by |
.Ar end_m |
.Ar end_m |
in minutes, |
in minutes, |
.Ar end_s, |
.Ar end_s |
in seconds and |
in seconds, and |
.Ar end_f |
.Ar end_f |
(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59. |
(frame number). |
|
Minutes are in the range 0-99. |
|
Seconds are in the range 0-59. |
Frame numbers are in the range 0-74. |
Frame numbers are in the range 0-74. |
.It Cm play Op Ar #start_block Op length |
.It Ic play Op Ar #start_block Op length |
Play starting from the logical block |
Play starting from the logical block |
.Ar start_block |
.Ar start_block |
using |
using |
.Ar length |
.Ar length |
logical blocks. |
logical blocks. |
.It Cm pause |
.It Ic pause |
Stop playing. Do not stop the disc. |
Stop playing. |
.It Cm next |
Do not stop the disc. |
Play the next track. If we're at the last track, stop. |
.It Ic next |
.It Cm previous |
Play the next track. |
Play the previous track. If we're at the first track, restart. |
If we're at the last track, stop. |
.It Cm replay |
.It Ic previous |
|
Play the previous track. |
|
If we're at the first track, restart. |
|
.It Ic replay |
Replay the current track again. |
Replay the current track again. |
.It Cm resume |
.It Ic resume |
Resume playing. Used after the |
Resume playing. |
.Cm pause |
Used after the |
|
.Ic pause |
command. |
command. |
.It Cm stop |
.It Ic stop |
Stop the disc. |
Stop the disc. |
.It Cm eject |
.It Ic eject |
Eject the disc. |
Eject the disc. |
.It Cm close |
.It Ic close |
Inject the disc. |
Inject the disc. |
.It Cm volume Ar left_channel Ar right_channel |
.It Ic volume Ar left_channel Ar right_channel |
Set the volume of the left channel to |
Set the volume of the left channel to |
.Ar left_channel |
.Ar left_channel |
and the volume of the right channel to |
and the volume of the right channel to |
.Ar right_channel . |
.Ar right_channel . |
Allowed values are in the range 0-255. |
Allowed values are in the range 0-255. |
.It Cm volume Ar mute |
.It Ic volume Ar mute |
Turn the sound off. |
Turn the sound off. |
.It Cm volume Ar mono |
.It Ic volume Ar mono |
Set the mono mode. |
Set the mono mode. |
.It Cm volume Ar stereo |
.It Ic volume Ar stereo |
Set the stereo mode. |
Set the stereo mode. |
.It Cm volume Ar left |
.It Ic volume Ar left |
Play the left subtrack on both left and right channels. |
Play the left subtrack on both left and right channels. |
.It Cm volume Ar right |
.It Ic volume Ar right |
Play the right subtrack on both left and right channels. |
Play the right subtrack on both left and right channels. |
.It Cm info |
.It Ic info |
Print the table of contents. |
Print the table of contents. |
.It Cm status |
.It Ic status |
Print information about the disc: |
Print information about the disc: |
the current playing status and position, |
the current playing status and position, |
the current media catalog status, |
the current media catalog status, |
the current values of the volume for left and right channels. |
and the current values of the volume for left and right channels. |
.It Cm help |
.It Ic help |
Print the list of available commands. |
Print the list of available commands. |
.It Cm debug Ar on |
.It Ic debug Ar on |
Enable the debugging mode of the CD device driver. |
Enable the debugging mode of the CD device driver. |
.It Cm debug Ar off |
.It Ic debug Ar off |
Disable the driver debugging mode. |
Disable the driver debugging mode. |
.It Cm device Ar devname |
.It Ic device Ar devname |
Make |
Make |
.Ar devname |
.Ar devname |
the current CD device. This is the equivalent of quitting |
the current CD device. |
|
This is the equivalent of quitting |
.Nm |
.Nm |
and restarting with a different device. |
and restarting with a different device. |
.It Cm reset |
.It Ic reset |
Perform a hardware reset of the device. |
Perform a hardware reset of the device. |
.It Cm set Ar msf |
.It Ic set Ar msf |
Set minute-second-frame ioctl mode (default). |
Set minute-second-frame ioctl mode (default). |
.It Cm set Ar lba |
.It Ic set Ar lba |
Set LBA ioctl mode. |
Set LBA ioctl mode. |
.It Cm quit |
.It Ic quit |
Quit the program. |
Quit the program. |
.Sh FILES |
.Sh FILES |
.Bl -tag -width /dev/rmcd0c -compact |
.Bl -tag -width /dev/rmcd0c -compact |