cdcontrol.1 revision 10099 
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