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