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.
48 is added to the device name if needed.
51 The available commands are listed below.
53 characters as are required to uniquely identify a command
57 can be omitted or the characters
66 .Bl -tag -width indent
67 .It Ic play Ar first_track Op Ar last_track
72 The first track has number 1.
73 Can be omitted in all cases.
76 .Ar start_m : Ns Ar start_s . Ns Ar start_f
77 .Op Ar end_m : Ns Ar end_s . Ns Ar end_f
79 Play from the absolute address
86 (frame number) to the absolute address defined by
93 Minutes are in the range 0-99.
94 Seconds are in the range 0-59.
95 Frame numbers are in the range 0-74.
96 .It Ic play Op # Ns Ar start_block Op Ar length
97 Play starting from the logical block
102 .It Ic next Op Ar tracks
103 Skip forward a number of tracks (default 1).
104 .It Ic prev Op Ar tracks
105 Skip backward a number of tracks (default 1).
108 Do not stop the disc.
120 .It Ic volume Ar left_channel right_channel
121 Set the volume of left channel to
123 and the volume of right channel to
125 Allowed values are in the range 0-255.
126 .It Ic volume Cm mute
128 .It Ic volume Cm mono
130 .It Ic volume Cm stereo
132 .It Ic volume Cm left
133 Play the left subtrack on both left and right channels.
134 .It Ic volume Cm right
135 Play the right subtrack on both left and right channels.
137 Print the table of contents.
138 .It Ic status Op Cm audio | media | volume
139 Print the information about the disc:
141 .Bl -tag -width ".Cm volume" -compact
143 the current playing status and position
145 the current media catalog status
147 the current values of the volume for left and right channels.
150 Display the serial number of the CD using the method used by the
153 .Pq Pa http://www.cddb.org/ .
155 Print the list of available commands.
157 Enable the debugging mode of the CD device driver.
159 Disable the driver debugging mode.
161 Perform the hardware reset of the device.
163 Set minute-second-frame ioctl mode (default).
167 Set the highest speed that the drive should use.
168 The speed is a multiple of the single speed.
169 This command is currently only supported on ATAPI drives.
174 The following environment variables affect the execution of
176 .Bl -tag -width ".Ev CD_DRIVE"
178 The CD device to use, if one is not specified with the
181 .It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
182 These variables have been deprecated in favour of
186 .Bl -tag -width ".Pa /dev/mcd0c" -compact
192 .An Jean-Marc Zucconi
193 .An Andrey A. Chernov
194 .An Serge V. Vakulenko