Annotation of src/usr.bin/cdio/cdio.1, Revision 1.6
1.6 ! deraadt 1: .\" $OpenBSD: cdio.1,v 1.5 1996/10/01 03:07:44 etheisen Exp $
1.1 downsj 2: .Dd July 3, 1995
3: .Dt CDIO 1
1.5 etheisen 4: .Os OpenBSD 2.0
1.1 downsj 5: .Sh NAME
6: .Nm cdio
7: .Nd compact disc control utility
8: .Sh SYNOPSIS
9: .Nm cdio
10: .Op Fl s
11: .Op Fl v
12: .Op Fl f Ar discname
13: .Op Ar command args...
14: .Sh DESCRIPTION
15: .Nm cdio
16: is a program to control audio features of a CD drive. The device is a name such
1.2 deraadt 17: as cd0, acd0, or mcd0
1.1 downsj 18: .Pp
1.2 deraadt 19: If the device is not specified, the environment variable
1.1 downsj 20: .Ev DISC
21: will be used to find the cd device.
22: .Pp
23: If no command is given, then
24: .Nm cdio
25: enters an interactive mode, reading commands from the standard input.
26: .Pp
27: The following options are available:
28: .Bl -tag -width flag
29: .It Fl s
30: Silent mode - do not print table headers and human readable comments.
31: .It Fl v
32: Verbose mode - print as much information as possible.
33: .It Fl f Ar discname
34: Specifies a device name, such as /dev/rcd0d or mcd0.
35: Both absolute path and relative to /dev filename are possible.
36: The raw parition name is added if needed.
37: .El
38: .Pp
39: The available commands are listed below. Only as many
40: characters as are required to uniquely identify a command
41: need be specified. Word
42: .Nm play
43: can be ommitted.
44: .Bl -tag -width Cm
45: .It Cm play Ar first_track Op Ar last_track
46: Play from track
47: .Nm first_track
48: to track
49: .Nm last_track.
50: The first track has number 1.
51: can be ommited in all cases.
52: .It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
53: Play from the absolute address
54: (MSF) defined by
55: .Nm start_m
56: in minutes,
57: .Nm start_s,
58: in seconds and
59: .Nm start_f
60: (frame number) to the absolute address defined by
61: .Nm end_m
62: in minutes,
63: .Nm end_s,
64: in seconds and
65: .Nm end_f
66: (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
67: Frame numbers are in the range 0-74.
68: .It Cm play Op Ar #start_block Op length
69: Play starting from the logical block
70: .Nm start_block
71: using
72: .Nm length
73: logical blocks.
74: .It Cm pause
75: Stop playing. Do not stop the disc.
76: .It Cm resume
1.4 deraadt 77: Resume playing. Used after the
1.1 downsj 78: .Nm pause
1.4 deraadt 79: command.
1.1 downsj 80: .It Cm stop
81: Stop the disc.
82: .It Cm eject
83: Eject the disc.
84: .It Cm close
85: Inject the disc.
86: .It Cm volume Ar left_channel Ar right_channel
87: Set the volume of left channel to
88: .Nm left_channel
89: and the volume of right channel to
90: .Nm right_channel.
91: Allowed values are in the range 0-255.
92: .It Cm volume Ar mute
93: Turn the sound off.
94: .It Cm volume Ar mono
95: Set the mono mode.
96: .It Cm volume Ar stereo
97: Set the stereo mode.
98: .It Cm volume Ar left
99: Play the left subtrack on both left and right channels.
100: .It Cm volume Ar right
101: Play the right subtrack on both left and right channels.
102: .It Cm info
1.6 ! deraadt 103: Print the table of contents.
1.1 downsj 104: .It Cm status
105: Print the information about the disc:
106: the current playing status and position,
107: the current media catalog status,
108: the current values of the volume for left and right channels.
109: .It Cm help
110: Print the list of available commands.
111: .It Cm debug Ar on
112: Enable the debugging mode of the CD device driver.
113: .It Cm debug Ar off
114: Disable the driver debugging mode.
115: .It Cm reset
116: Perform the hardware reset of the device.
117: .It Cm set Ar msf
118: Set minute-second-frame ioctl mode (default).
119: .It Cm set Ar lba
120: Set LBA ioctl mode.
121: .It Cm quit
122: Quit the program.
123: .Sh FILES
124: .Bl -tag -width /dev/rmcd0c -compact
125: .It Pa /dev/rcd0d
126: .It Pa /dev/racd0d
127: .It Pa /dev/rmcd0d
128: .El
129: .Sh AUTHORS
130: Jean-Marc Zucconi,
131: Andrey A.\ Chernov,
132: Serge V.\ Vakulenko
133: .Sh HISTORY
134: The
135: .Nm cdio
136: command is based on
137: .Nm cdcontrol ,
138: which first appeared in FreeBSD 2.1