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