Annotation of src/usr.bin/cdio/cdio.1, Revision 1.1
1.1 ! downsj 1: .\" $OpenBSD$
! 2: .Dd July 3, 1995
! 3: .Dt CDIO 1
! 4: .Os OpenBSD
! 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
! 17: as cd0 or mcd0.
! 18: .Pp
! 19: If the device not specified, the environment variable
! 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:
! 46: .It Cm play Ar first_track Op Ar last_track
! 47: Play from track
! 48: .Nm first_track
! 49: to track
! 50: .Nm last_track.
! 51: The first track has number 1.
! 52: can be ommited in all cases.
! 53:
! 54: .It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
! 55: Play from the absolute address
! 56: (MSF) defined by
! 57: .Nm start_m
! 58: in minutes,
! 59: .Nm start_s,
! 60: in seconds and
! 61: .Nm start_f
! 62: (frame number) to the absolute address defined by
! 63: .Nm end_m
! 64: in minutes,
! 65: .Nm end_s,
! 66: in seconds and
! 67: .Nm end_f
! 68: (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
! 69: Frame numbers are in the range 0-74.
! 70:
! 71: .It Cm play Op Ar #start_block Op length
! 72: Play starting from the logical block
! 73: .Nm start_block
! 74: using
! 75: .Nm length
! 76: logical blocks.
! 77:
! 78: .It Cm pause
! 79: Stop playing. Do not stop the disc.
! 80:
! 81: .It Cm resume
! 82: Resume playing. Used after the
! 83: .Nm pause
! 84: command.
! 85:
! 86: .It Cm stop
! 87: Stop the disc.
! 88:
! 89: .It Cm eject
! 90: Eject the disc.
! 91:
! 92: .It Cm close
! 93: Inject the disc.
! 94:
! 95: .It Cm volume Ar left_channel Ar right_channel
! 96: Set the volume of left channel to
! 97: .Nm left_channel
! 98: and the volume of right channel to
! 99: .Nm right_channel.
! 100: Allowed values are in the range 0-255.
! 101:
! 102: .It Cm volume Ar mute
! 103: Turn the sound off.
! 104:
! 105: .It Cm volume Ar mono
! 106: Set the mono mode.
! 107:
! 108: .It Cm volume Ar stereo
! 109: Set the stereo mode.
! 110:
! 111: .It Cm volume Ar left
! 112: Play the left subtrack on both left and right channels.
! 113:
! 114: .It Cm volume Ar right
! 115: Play the right subtrack on both left and right channels.
! 116:
! 117: .It Cm info
! 118: Print the the table of contents.
! 119:
! 120: .It Cm status
! 121: Print the information about the disc:
! 122: the current playing status and position,
! 123: the current media catalog status,
! 124: the current values of the volume for left and right channels.
! 125:
! 126: .It Cm help
! 127: Print the list of available commands.
! 128:
! 129: .It Cm debug Ar on
! 130: Enable the debugging mode of the CD device driver.
! 131:
! 132: .It Cm debug Ar off
! 133: Disable the driver debugging mode.
! 134:
! 135: .It Cm reset
! 136: Perform the hardware reset of the device.
! 137:
! 138: .It Cm set Ar msf
! 139: Set minute-second-frame ioctl mode (default).
! 140:
! 141: .It Cm set Ar lba
! 142: Set LBA ioctl mode.
! 143:
! 144: .It Cm quit
! 145: Quit the program.
! 146:
! 147: .Sh FILES
! 148: .Bl -tag -width /dev/rmcd0c -compact
! 149: .It Pa /dev/rcd0d
! 150: .It Pa /dev/racd0d
! 151: .It Pa /dev/rmcd0d
! 152: .El
! 153: .Sh AUTHORS
! 154: Jean-Marc Zucconi,
! 155: Andrey A.\ Chernov,
! 156: Serge V.\ Vakulenko
! 157: .Sh HISTORY
! 158: The
! 159: .Nm cdio
! 160: command is based on
! 161: .Nm cdcontrol ,
! 162: which first appeared in FreeBSD 2.1