7 .Nd compact disc control utility
16 utility is a program to control audio features of a CD drive.
17 The device is a name such
25 enters an interactive mode, reading commands from the standard input.
27 The following options are available:
28 .Bl -tag -width indent
31 Do not print table headers and human readable comments.
34 Print as much information as possible.
36 Specify a device, such as
38 Both absolute path and relative to
40 filename are possible.
57 The available commands are listed below.
59 characters as are required to uniquely identify a command
63 can be omitted or the characters
72 .Bl -tag -width indent
73 .It Ic play Ar first_track Op Ar last_track
78 The first track has number 1.
79 Can be omitted in all cases.
82 .Ar start_m : Ns Ar start_s . Ns Ar start_f
83 .Op Ar end_m : Ns Ar end_s . Ns Ar end_f
85 Play from the absolute address
92 (frame number) to the absolute address defined by
99 Minutes are in the range 0-99.
100 Seconds are in the range 0-59.
101 Frame numbers are in the range 0-74.
102 .It Ic play Op # Ns Ar start_block Op Ar length
103 Play starting from the logical block
108 .It Ic next Op Ar tracks
109 Skip forward a number of tracks (default 1).
110 .It Ic prev Op Ar tracks
111 Skip backward a number of tracks (default 1).
114 Do not stop the disc.
130 .It Ic volume Ar level
131 Set the volume of both channels to
133 Allowed values are in the range 0-255.
134 .It Ic volume Ar left_channel right_channel
135 Set the volume of left channel to
137 and the volume of right channel to
139 Allowed values are in the range 0-255.
140 .It Ic volume Cm mute
142 .It Ic volume Cm mono
144 .It Ic volume Cm stereo
146 .It Ic volume Cm left
147 Play the left subtrack on both left and right channels.
148 .It Ic volume Cm right
149 Play the right subtrack on both left and right channels.
151 Print the table of contents.
152 .It Ic status Op Cm audio | media | volume
153 Print the information about the disc:
155 .Bl -tag -width ".Cm volume" -compact
157 the current playing status and position
159 the current media catalog status
161 the current values of the volume for left and right channels.
164 Display the serial number of the CD using the method used by the
167 .Pq Pa http://www.cddb.org/ .
169 Print the list of available commands.
171 Enable the debugging mode of the CD device driver.
173 Disable the driver debugging mode.
175 Perform the hardware reset of the device.
177 Set minute-second-frame ioctl mode (default).
181 Set the highest speed that the drive should use for reading data.
182 The units are multiples of a single speed CDROM (150 KB/s).
185 to use the drive's fastest speed.
190 The following environment variables affect the execution of
192 .Bl -tag -width ".Ev CD_DRIVE"
194 The CD device to use, if one is not specified with the
197 .It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
198 These variables have been deprecated in favour of
202 .Bl -tag -width ".Pa /dev/cd0" -compact
211 .An Jean-Marc Zucconi
212 .An Andrey A. Chernov
213 .An Serge V. Vakulenko