1.\" $Id: cdcontrol.1,v 1.14 1998/01/07 07:43:04 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 130.Op Ar audio | media | volume 131 132Print the information about the disc: 133 134.Nm audio 135the current playing status and position, 136 137.Nm media 138the current media catalog status, 139 140.Nm volume 141the current values of the volume for left and right channels. 142 143.It Cm help 144Print the list of available commands. 145 146.It Cm debug Ar on 147Enable the debugging mode of the CD device driver. 148 149.It Cm debug Ar off 150Disable the driver debugging mode. 151 152.It Cm reset 153Perform the hardware reset of the device. 154 155.It Cm set Ar msf 156Set minute-second-frame ioctl mode (default). 157 158.It Cm set Ar lba 159Set LBA ioctl mode. 160 161.It Cm quit 162Quit the program. 163 164.Sh FILES 165.Bl -tag -width /dev/rmcd0c -compact 166.It Pa /dev/rcd0c 167.It Pa /dev/rmcd0c 168.It Pa /dev/rwcd0c 169.El 170.Sh AUTHORS 171.An Jean-Marc Zucconi , 172.An Andrey A.\ Chernov , 173.An Serge V.\ Vakulenko 174.Sh HISTORY 175The 176.Nm 177command appeared in 178.Fx 2.1 . 179