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