[BACK]Return to cdio.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / cdio

Annotation of src/usr.bin/cdio/cdio.1, Revision 1.16

1.16    ! aaron       1: .\" $OpenBSD: cdio.1,v 1.15 1999/07/30 18:59:30 deraadt 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
1.16    ! aaron      35: The options are as follows:
1.1       downsj     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.