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