version 1.12, 1998/09/01 16:38:23 |
version 1.13, 1998/09/23 04:32:36 |
|
|
.Nm cdio |
.Nm cdio |
.Op Fl s |
.Op Fl s |
.Op Fl v |
.Op Fl v |
.Op Fl f Ar discname |
.Op Fl f Ar device |
.Op Ar command args... |
.Op Ar command args ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
|
The |
.Nm cdio |
.Nm cdio |
is a program to control audio features of a CD drive. The device is a name such |
program controls audio features of a CD drive. The |
as cd0, acd0, or mcd0 |
.Ar device |
|
is a name such |
|
as ``cd0'', ``acd0'', or ``mcd0''. |
.Pp |
.Pp |
If the device is not specified, the environment variable |
If a |
|
.Ar device |
|
is not specified, the environment variable |
.Ev DISC |
.Ev DISC |
will be used to find the cd device. |
will be used to find the CD device. |
.Pp |
.Pp |
If no command is given, then |
If no command is given, |
.Nm cdio |
.Nm cdio |
enters an interactive mode, reading commands from the standard input. |
enters an interactive mode, reading commands from the standard input. |
.Pp |
.Pp |
The following options are available: |
The following options are available: |
.Bl -tag -width flag |
.Bl -tag -width flag |
.It Fl s |
.It Fl s |
Silent mode - do not print table headers and 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 discname |
.It Fl f Ar device |
Specifies a device name, such as /dev/rcd0d or mcd0. |
Specifies a device name such as |
Both absolute path and relative to /dev filename are possible. |
.Pa /dev/rcd0d |
|
or |
|
.Pa mcd0 . |
|
Both absolute and relative paths to |
|
.Pa /dev |
|
filenames are possible. |
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. Only as many |
characters as are required to uniquely identify a command |
characters as are required to uniquely identify a command |
need be specified. Word |
need be specified. The word |
.Nm play |
.Cm play |
can be omitted. |
may be omitted. |
.Bl -tag -width Cm |
.Bl -tag -width Cm |
.It Cm play Ar first_track Op Ar last_track |
.It Cm play Ar first_track Op Ar last_track |
Play from track |
Play from track |
.Nm first_track |
.Nm first_track |
to track |
to track |
.Nm last_track. |
.Nm last_track. |
The first track has number 1. |
The first track has number 1 and may be omitted in all cases. |
can be ommited in all cases. |
|
.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f |
.It Cm 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 |
.Nm start_m |
.Ar start_m |
in minutes, |
in minutes, |
.Nm start_s, |
.Ar start_s, |
in seconds and |
in seconds and |
.Nm start_f |
.Ar start_f |
(frame number) to the absolute address defined by |
(frame number) to the absolute address defined by |
.Nm end_m |
.Ar end_m |
in minutes, |
in minutes, |
.Nm end_s, |
.Ar end_s, |
in seconds and |
in seconds and |
.Nm 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 Cm play Op Ar #start_block Op length |
Play starting from the logical block |
Play starting from the logical block |
.Nm start_block |
.Ar start_block |
using |
using |
.Nm length |
.Ar length |
logical blocks. |
logical blocks. |
.It Cm pause |
.It Cm pause |
Stop playing. Do not stop the disc. |
Stop playing. Do not stop the disc. |
|
|
.It Cm close |
.It Cm close |
Inject the disc. |
Inject the disc. |
.It Cm volume Ar left_channel Ar right_channel |
.It Cm volume Ar left_channel Ar right_channel |
Set the volume of left channel to |
Set the volume of the left channel to |
.Nm left_channel |
.Ar left_channel |
and the volume of right channel to |
and the volume of the right channel to |
.Nm 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 Cm volume Ar mute |
Turn the sound off. |
Turn the sound off. |
|
|
.It Cm info |
.It Cm info |
Print the table of contents. |
Print the table of contents. |
.It Cm status |
.It Cm status |
Print the 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. |
the current values of the volume for left and right channels. |
|
|
.Nm cdio |
.Nm cdio |
command is based on |
command is based on |
.Nm cdcontrol , |
.Nm cdcontrol , |
which first appeared in FreeBSD 2.1 |
which first appeared in FreeBSD 2.1. |