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
24 If no command is given, then
26 enters an interactive mode, reading commands from the standard input.
28 The following options are available:
29 .Bl -tag -width indent
31 Silent mode - do not print table headers and human readable comments.
33 Verbose mode - print as much information as possible.
35 Specify a device, such as
39 Both absolute path and relative to
41 filename are possible.
42 Suffix `c' is added to the device name if needed.
45 The available commands are listed below. Only as many
46 characters as are required to uniquely identify a command
50 can be omitted or the characters
60 .It Cm play Ar first_track Op Ar last_track
65 The first track has number 1.
66 Can be omitted in all cases.
68 .Ar start_m : Ns Ar start_s . Ns Ar start_f
69 .Oo Ar end_m : Ns Ar end_s . Ns
72 Play from the absolute address
79 (frame number) to the absolute address defined by
85 (frame number). Minutes are in the range 0-99.
86 Seconds are in the range 0-59.
87 Frame numbers are in the range 0-74.
88 .It Cm play Op Ar #start_block Op length
89 Play starting from the logical block
94 .It Cm next Op Ar tracks
95 Skip forward a number of tracks (default 1).
96 .It Cm prev Op Ar tracks
97 Skip backward a number of tracks (default 1).
100 Do not stop the disc.
112 .It Cm volume Ar left_channel Ar right_channel
113 Set the volume of left channel to
115 and the volume of right channel to
117 Allowed values are in the range 0-255.
118 .It Cm volume Ar mute
120 .It Cm volume Ar mono
122 .It Cm volume Ar stereo
124 .It Cm volume Ar left
125 Play the left subtrack on both left and right channels.
126 .It Cm volume Ar right
127 Play the right subtrack on both left and right channels.
129 Print the table of contents.
131 .Op Ar audio | media | volume
133 Print the information about the disc:
135 .Bl -tag -width "volume" -compact
137 the current playing status and position
139 the current media catalog status
141 the current values of the volume for left and right channels.
144 Display the serial number of the cd using the method used by the
145 cddb (http://www.cddb.org/) project.
147 Print the list of available commands.
149 Enable the debugging mode of the CD device driver.
151 Disable the driver debugging mode.
153 Perform the hardware reset of the device.
155 Set minute-second-frame ioctl mode (default).
159 Set the highest speed that the drive should use. The speed is a multiple of
160 the single speed. This command is currently only supported on ATAPI drives.
165 The following environment variables affect the execution of
168 .Bl -tag -width CD_DRIVE -compact
170 The cd device to use if one isn't specified with the
178 These variables have been deprecated in favour of
182 .Bl -tag -width /dev/mcd0c -compact
188 .An Jean-Marc Zucconi ,
189 .An Andrey A.\ Chernov ,
190 .An Serge V.\ Vakulenko