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