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