1.\" $FreeBSD$ 2.\" 3.Dd July 3, 1995 4.Dt CDCONTROL 1 5.Os FreeBSD 6.Sh NAME 7.Nm cdcontrol 8.Nd compact disc control utility 9.Sh SYNOPSIS 10.Nm cdcontrol 11.Op Fl sv 12.Op Fl f Ar device 13.Op Ar command ... 14.Sh DESCRIPTION 15.Nm Cdcontrol 16is a program to control audio features of a CD drive. The device is a name such 17as 18.Pa cd0 19or 20.Pa mcd0 . 21.Pp 22If the device not specified, the environment variables 23.Ev MUSIC_CD , 24.Ev CD_DRIVE , 25.Ev DISC 26and 27.Ev CDPLAY 28will be used (in this order) to find the cd device. 29.Pp 30If no command is given, then 31.Nm 32enters an interactive mode, reading commands from the standard input. 33.Pp 34The following options are available: 35.Bl -tag -width indent 36.It Fl s 37Silent mode - do not print table headers and human readable comments. 38.It Fl v 39Verbose mode - print as much information as possible. 40.It Fl f Ar device 41Specify a device, such as 42.Pa /dev/cd0c 43or 44.Pa mcd0 . 45Both absolute path and relative to 46.Pa /dev 47filename are possible. 48Suffix `c' is added to the device name if needed. 49.El 50.Pp 51The available commands are listed below. Only as many 52characters as are required to uniquely identify a command 53need be specified. Word 54.Em play 55can be omitted. 56.Bl -tag -width Cm 57 58.It Cm play Ar first_track Op Ar last_track 59Play from track 60.Ar first_track 61to track 62.Ar last_track . 63The first track has number 1. 64Can be omitted in all cases. 65 66.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f 67Play from the absolute address 68(MSF) defined by 69.Ar start_m 70in minutes, 71.Ar start_s , 72in seconds and 73.Ar start_f 74(frame number) to the absolute address defined by 75.Ar end_m 76in minutes, 77.Ar end_s , 78in seconds and 79.Ar end_f 80(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59. 81Frame numbers are in the range 0-74. 82 83.It Cm play Op Ar #start_block Op length 84Play starting from the logical block 85.Ar start_block 86using 87.Ar length 88logical blocks. 89 90.It Cm pause 91Stop playing. Do not stop the disc. 92 93.It Cm resume 94Resume playing. Used after the 95.Em pause 96command. 97 98.It Cm stop 99Stop the disc. 100 101.It Cm eject 102Eject the disc. 103 104.It Cm close 105Inject the disc. 106 107.It Cm volume Ar left_channel Ar right_channel 108Set the volume of left channel to 109.Ar left_channel 110and the volume of right channel to 111.Ar right_channel . 112Allowed values are in the range 0-255. 113 114.It Cm volume Ar mute 115Turn the sound off. 116 117.It Cm volume Ar mono 118Set the mono mode. 119 120.It Cm volume Ar stereo 121Set the stereo mode. 122 123.It Cm volume Ar left 124Play the left subtrack on both left and right channels. 125 126.It Cm volume Ar right 127Play the right subtrack on both left and right channels. 128 129.It Cm info 130Print the table of contents. 131 132.It Cm status 133.Op Ar audio | media | volume 134 135Print the information about the disc: 136 137.Nm audio 138the current playing status and position, 139 140.Nm media 141the current media catalog status, 142 143.Nm volume 144the current values of the volume for left and right channels. 145 146.It Cm help 147Print the list of available commands. 148 149.It Cm debug Ar on 150Enable the debugging mode of the CD device driver. 151 152.It Cm debug Ar off 153Disable the driver debugging mode. 154 155.It Cm reset 156Perform the hardware reset of the device. 157 158.It Cm set Ar msf 159Set minute-second-frame ioctl mode (default). 160 161.It Cm set Ar lba 162Set LBA ioctl mode. 163 164.It Cm quit 165Quit the program. 166 167.Sh FILES 168.Bl -tag -width /dev/rmcd0c -compact 169.It Pa /dev/rcd0c 170.It Pa /dev/rmcd0c 171.It Pa /dev/rwcd0c 172.El 173.Sh AUTHORS 174.An Jean-Marc Zucconi , 175.An Andrey A.\ Chernov , 176.An Serge V.\ Vakulenko 177.Sh HISTORY 178The 179.Nm 180command appeared in 181.Fx 2.1 . 182