Annotation of src/usr.bin/cdio/cdio.1, Revision 1.15
1.15 ! deraadt 1: .\" $OpenBSD: cdio.1,v 1.14 1999/06/05 01:21:20 aaron Exp $
1.1 downsj 2: .Dd July 3, 1995
3: .Dt CDIO 1
1.14 aaron 4: .Os
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
1.13 aaron 12: .Op Fl f Ar device
13: .Op Ar command args ...
1.1 downsj 14: .Sh DESCRIPTION
1.13 aaron 15: The
1.14 aaron 16: .Nm
1.13 aaron 17: program controls audio features of a CD drive. The
18: .Ar device
19: is a name such
1.14 aaron 20: as
21: .Dq cd0 ,
22: or
23: .Dq mcd0 .
1.1 downsj 24: .Pp
1.13 aaron 25: If a
26: .Ar device
1.14 aaron 27: is not specified, the environment variable
1.1 downsj 28: .Ev DISC
1.13 aaron 29: will be used to find the CD device.
1.1 downsj 30: .Pp
1.13 aaron 31: If no command is given,
1.14 aaron 32: .Nm
1.1 downsj 33: enters an interactive mode, reading commands from the standard input.
34: .Pp
35: The following options are available:
36: .Bl -tag -width flag
37: .It Fl s
1.13 aaron 38: Silent mode. Do not print table headers or human-readable comments.
1.1 downsj 39: .It Fl v
1.13 aaron 40: Verbose mode. Print as much information as possible.
41: .It Fl f Ar device
42: Specifies a device name such as
43: .Pa /dev/rcd0d
44: or
45: .Pa mcd0 .
46: Both absolute and relative paths to
47: .Pa /dev
48: filenames are possible.
1.11 deraadt 49: The raw partition name is added if needed.
1.1 downsj 50: .El
51: .Pp
52: The available commands are listed below. Only as many
53: characters as are required to uniquely identify a command
1.13 aaron 54: need be specified. The word
55: .Cm play
56: may be omitted.
1.1 downsj 57: .Bl -tag -width Cm
58: .It Cm play Ar first_track Op Ar last_track
1.14 aaron 59: Play from track
60: .Ar first_track
1.1 downsj 61: to track
1.14 aaron 62: .Ar last_track .
1.13 aaron 63: The first track has number 1 and may be omitted in all cases.
1.1 downsj 64: .It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
65: Play from the absolute address
1.14 aaron 66: (MSF) defined by
1.13 aaron 67: .Ar start_m
1.14 aaron 68: in minutes,
1.13 aaron 69: .Ar start_s,
1.14 aaron 70: in seconds and
1.13 aaron 71: .Ar start_f
1.1 downsj 72: (frame number) to the absolute address defined by
1.13 aaron 73: .Ar end_m
1.14 aaron 74: in minutes,
1.13 aaron 75: .Ar end_s,
1.14 aaron 76: in seconds and
1.13 aaron 77: .Ar end_f
1.1 downsj 78: (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
79: Frame numbers are in the range 0-74.
80: .It Cm play Op Ar #start_block Op length
81: Play starting from the logical block
1.13 aaron 82: .Ar start_block
1.1 downsj 83: using
1.13 aaron 84: .Ar length
1.1 downsj 85: logical blocks.
86: .It Cm pause
87: Stop playing. Do not stop the disc.
1.7 angelos 88: .It Cm next
89: Play the next track. If we're at the last track, stop.
90: .It Cm previous
91: Play the previous track. If we're at the first track, restart.
1.8 angelos 92: .It Cm replay
93: Replay the current track again.
1.1 downsj 94: .It Cm resume
1.4 deraadt 95: Resume playing. Used after the
1.14 aaron 96: .Cm pause
1.4 deraadt 97: command.
1.1 downsj 98: .It Cm stop
99: Stop the disc.
100: .It Cm eject
101: Eject the disc.
102: .It Cm close
103: Inject the disc.
104: .It Cm volume Ar left_channel Ar right_channel
1.14 aaron 105: Set the volume of the left channel to
1.13 aaron 106: .Ar left_channel
1.14 aaron 107: and the volume of the right channel to
108: .Ar right_channel .
109: Allowed values are in the range 0-255.
1.1 downsj 110: .It Cm volume Ar mute
111: Turn the sound off.
112: .It Cm volume Ar mono
113: Set the mono mode.
114: .It Cm volume Ar stereo
115: Set the stereo mode.
116: .It Cm volume Ar left
117: Play the left subtrack on both left and right channels.
118: .It Cm volume Ar right
119: Play the right subtrack on both left and right channels.
120: .It Cm info
1.6 deraadt 121: Print the table of contents.
1.1 downsj 122: .It Cm status
1.13 aaron 123: Print information about the disc:
1.1 downsj 124: the current playing status and position,
125: the current media catalog status,
126: the current values of the volume for left and right channels.
127: .It Cm help
128: Print the list of available commands.
129: .It Cm debug Ar on
130: Enable the debugging mode of the CD device driver.
131: .It Cm debug Ar off
132: Disable the driver debugging mode.
1.9 millert 133: .It Cm device Ar devname
134: Make
135: .Ar devname
136: the current CD device. This is the equivalent of quitting
137: .Nm
138: and restarting with a different device.
1.1 downsj 139: .It Cm reset
1.14 aaron 140: Perform a hardware reset of the device.
1.1 downsj 141: .It Cm set Ar msf
142: Set minute-second-frame ioctl mode (default).
143: .It Cm set Ar lba
144: Set LBA ioctl mode.
145: .It Cm quit
146: Quit the program.
147: .Sh FILES
148: .Bl -tag -width /dev/rmcd0c -compact
1.10 mickey 149: .It Pa /dev/rcd0c
150: .It Pa /dev/rmcd0c
1.1 downsj 151: .El
152: .Sh AUTHORS
153: Jean-Marc Zucconi,
154: Andrey A.\ Chernov,
155: Serge V.\ Vakulenko
156: .Sh HISTORY
157: The
1.14 aaron 158: .Nm
1.1 downsj 159: command is based on
160: .Nm cdcontrol ,
1.13 aaron 161: which first appeared in FreeBSD 2.1.