8 .Nd compact disc control utility
17 utility is a program to control audio features of a CD drive.
18 The device is a name such
28 enters an interactive mode, reading commands from the standard input.
30 The following options are available:
31 .Bl -tag -width indent
34 Do not print table headers and human readable comments.
37 Print as much information as possible.
39 Specify a device, such as
43 Both absolute path and relative to
45 filename are possible.
64 The available commands are listed below.
66 characters as are required to uniquely identify a command
70 can be omitted or the characters
79 .Bl -tag -width indent
80 .It Ic play Ar first_track Op Ar last_track
85 The first track has number 1.
86 Can be omitted in all cases.
89 .Ar start_m : Ns Ar start_s . Ns Ar start_f
90 .Op Ar end_m : Ns Ar end_s . Ns Ar end_f
92 Play from the absolute address
99 (frame number) to the absolute address defined by
106 Minutes are in the range 0-99.
107 Seconds are in the range 0-59.
108 Frame numbers are in the range 0-74.
109 .It Ic play Op # Ns Ar start_block Op Ar length
110 Play starting from the logical block
115 .It Ic next Op Ar tracks
116 Skip forward a number of tracks (default 1).
117 .It Ic prev Op Ar tracks
118 Skip backward a number of tracks (default 1).
121 Do not stop the disc.
137 .It Ic volume Ar level
138 Set the volume of both channels to
140 Allowed values are in the range 0-255.
141 .It Ic volume Ar left_channel right_channel
142 Set the volume of left channel to
144 and the volume of right channel to
146 Allowed values are in the range 0-255.
147 .It Ic volume Cm mute
149 .It Ic volume Cm mono
151 .It Ic volume Cm stereo
153 .It Ic volume Cm left
154 Play the left subtrack on both left and right channels.
155 .It Ic volume Cm right
156 Play the right subtrack on both left and right channels.
158 Print the table of contents.
159 .It Ic status Op Cm audio | media | volume
160 Print the information about the disc:
162 .Bl -tag -width ".Cm volume" -compact
164 the current playing status and position
166 the current media catalog status
168 the current values of the volume for left and right channels.
171 Display the serial number of the CD using the method used by the
174 .Pq Pa http://www.cddb.org/ .
176 Print the list of available commands.
178 Enable the debugging mode of the CD device driver.
180 Disable the driver debugging mode.
182 Perform the hardware reset of the device.
184 Set minute-second-frame ioctl mode (default).
188 Set the highest speed that the drive should use for reading data.
189 The units are multiples of a single speed CDROM (150 KB/s).
192 to use the drive's fastest speed.
197 The following environment variables affect the execution of
199 .Bl -tag -width ".Ev CD_DRIVE"
201 The CD device to use, if one is not specified with the
204 .It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
205 These variables have been deprecated in favour of
209 .Bl -tag -width ".Pa /dev/mcd0" -compact
220 .An Jean-Marc Zucconi
221 .An Andrey A. Chernov
222 .An Serge V. Vakulenko