cdcontrol.1 revision 17786 
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. Word
41.Nm play
42can be ommitted.
43.Bl -tag -width Cm
44
45.It Cm play Ar first_track Op Ar last_track
46Play from track 
47.Nm first_track
48to track
49.Nm last_track. 
50The first track has number 1.
51can be ommited in all cases.
52
53.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
54Play from the absolute address
55(MSF) defined by 
56.Nm start_m
57in minutes, 
58.Nm start_s,
59in seconds and 
60.Nm start_f
61(frame number) to the absolute address defined by
62.Nm end_m
63in minutes, 
64.Nm end_s,
65in seconds and 
66.Nm end_f
67(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
68Frame numbers are in the range 0-74.
69
70.It Cm play Op Ar #start_block Op length
71Play starting from the logical block
72.Nm start_block
73using
74.Nm length
75logical blocks.
76
77.It Cm pause
78Stop playing. Do not stop the disc.
79
80.It Cm resume
81Resume playing. Used after the 
82.Nm pause
83 command.
84
85.It Cm stop
86Stop the disc.
87
88.It Cm eject
89Eject the disc.
90
91.It Cm close
92Inject the disc.
93
94.It Cm volume Ar left_channel Ar right_channel
95Set the volume of left channel to 
96.Nm left_channel
97and the volume of right channel to 
98.Nm right_channel. 
99Allowed values are in the range 0-255. 
100
101.It Cm volume Ar mute
102Turn the sound off.
103
104.It Cm volume Ar mono
105Set the mono mode.
106
107.It Cm volume Ar stereo
108Set the stereo mode.
109
110.It Cm volume Ar left
111Play the left subtrack on both left and right channels.
112
113.It Cm volume Ar right
114Play the right subtrack on both left and right channels.
115
116.It Cm info
117Print the the table of contents.
118
119.It Cm status
120Print the information about the disc:
121the current playing status and position,
122the current media catalog status,
123the current values of the volume for left and right channels.
124
125.It Cm help
126Print the list of available commands.
127
128.It Cm debug Ar on
129Enable the debugging mode of the CD device driver.
130
131.It Cm debug Ar off
132Disable the driver debugging mode.
133
134.It Cm reset
135Perform the hardware reset of the device.
136
137.It Cm set Ar msf
138Set minute-second-frame ioctl mode (default).
139
140.It Cm set Ar lba
141Set LBA ioctl mode.
142
143.It Cm quit
144Quit the program.
145
146.Sh FILES
147.Bl -tag -width /dev/rmcd0c -compact
148.It Pa /dev/rcd0c
149.It Pa /dev/rmcd0c
150.It Pa /dev/rwcd0c
151.El
152.Sh AUTHORS
153Jean-Marc Zucconi,
154Andrey A.\ Chernov,
155Serge V.\ Vakulenko
156.Sh HISTORY
157The
158.Nm cdcontrol
159command appeared in
160.Fx 2.1 .
161