[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.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.