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
26 enters an interactive mode, reading commands from the standard input.
28 The following options are available:
29 .Bl -tag -width indent
32 Do not print table headers and human readable comments.
35 Print as much information as possible.
37 Specify a device, such as
39 Both absolute path and relative to
41 filename are possible.
58 The available commands are listed below.
60 characters as are required to uniquely identify a command
64 can be omitted or the characters
73 .Bl -tag -width indent
74 .It Ic play Ar first_track Op Ar last_track
79 The first track has number 1.
80 Can be omitted in all cases.
83 .Ar start_m : Ns Ar start_s . Ns Ar start_f
84 .Op Ar end_m : Ns Ar end_s . Ns Ar end_f
86 Play from the absolute address
93 (frame number) to the absolute address defined by
100 Minutes are in the range 0-99.
101 Seconds are in the range 0-59.
102 Frame numbers are in the range 0-74.
103 .It Ic play Op # Ns Ar start_block Op Ar length
104 Play starting from the logical block
109 .It Ic next Op Ar tracks
110 Skip forward a number of tracks (default 1).
111 .It Ic prev Op Ar tracks
112 Skip backward a number of tracks (default 1).
115 Do not stop the disc.
131 .It Ic volume Ar level
132 Set the volume of both channels to
134 Allowed values are in the range 0-255.
135 .It Ic volume Ar left_channel right_channel
136 Set the volume of left channel to
138 and the volume of right channel to
140 Allowed values are in the range 0-255.
141 .It Ic volume Cm mute
143 .It Ic volume Cm mono
145 .It Ic volume Cm stereo
147 .It Ic volume Cm left
148 Play the left subtrack on both left and right channels.
149 .It Ic volume Cm right
150 Play the right subtrack on both left and right channels.
152 Print the table of contents.
153 .It Ic status Op Cm audio | media | volume
154 Print the information about the disc:
156 .Bl -tag -width ".Cm volume" -compact
158 the current playing status and position
160 the current media catalog status
162 the current values of the volume for left and right channels.
165 Display the serial number of the CD using the method used by the
168 .Pq Pa http://www.cddb.org/ .
170 Print the list of available commands.
172 Enable the debugging mode of the CD device driver.
174 Disable the driver debugging mode.
176 Perform the hardware reset of the device.
178 Set minute-second-frame ioctl mode (default).
182 Set the highest speed that the drive should use for reading data.
183 The units are multiples of a single speed CDROM (150 KB/s).
186 to use the drive's fastest speed.
191 The following environment variables affect the execution of
193 .Bl -tag -width ".Ev CD_DRIVE"
195 The CD device to use, if one is not specified with the
198 .It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
199 These variables have been deprecated in favour of
203 .Bl -tag -width ".Pa /dev/cd0" -compact
212 .An Jean-Marc Zucconi
213 .An Andrey A. Chernov
214 .An Serge V. Vakulenko