d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
4b2f7fe1db
freebsd-skq/usr.sbin/cdcontrol/cdcontrol.1

180 lines
3.7 KiB
Groff
Raw Normal View History

$Id$ -> $FreeBSD$
1999-08-28 01:35:59 +00:00
.\" $FreeBSD$
delete doubled words, e.g.: "the the" -> "the"
1996-10-05 22:27:30 +00:00
.\"
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Dd July 3, 1995
.Dt CDCONTROL 1
.Os FreeBSD
.Sh NAME
.Nm cdcontrol
.Nd compact disc control utility
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm
(1) Make usage() and SYNOPSIS agree with each other. (2) Use 'device' instead of 'device name', there seems to be a precedent in /usr/share/man/man1 Prompted By: bde
1999-01-31 15:30:21 +00:00
.Op Fl sv
.Op Fl f Ar device
.Op Ar command ...
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Sh DESCRIPTION
Use err(3). Style in usage().
1997-09-04 11:52:28 +00:00
.Nm Cdcontrol
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 14:09:25 +00:00
is a program to control audio features of a CD drive.
The device is a name such
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
as
.Pa cd0
or
.Pa mcd0 .
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Pp
If no command is given, then
Use err(3). Style in usage().
1997-09-04 11:52:28 +00:00
.Nm
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
enters an interactive mode, reading commands from the standard input.
.Pp
The following options are available:
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Bl -tag -width indent
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Fl s
Silent mode - do not print table headers and human readable comments.
.It Fl v
Verbose mode - print as much information as possible.
(1) Make usage() and SYNOPSIS agree with each other. (2) Use 'device' instead of 'device name', there seems to be a precedent in /usr/share/man/man1 Prompted By: bde
1999-01-31 15:30:21 +00:00
.It Fl f Ar device
Specify a device, such as
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Pa /dev/cd0c
or
.Pa mcd0 .
Both absolute path and relative to
.Pa /dev
filename are possible.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Suffix `c' is added to the device name if needed.
.El
.Pp
The available commands are listed below. Only as many
characters as are required to uniquely identify a command
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 14:09:25 +00:00
need be specified.
Word
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Em play
spelling corrections. PR: docs/4450 Submitted by: josh@quick.net
1997-09-13 16:01:53 +00:00
can be omitted.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Bl -tag -width Cm
Implement several new commands
1996-02-03 14:13:36 +00:00
.It Cm play Ar first_track Op Ar last_track
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Play from track
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar first_track
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
to track
Typo.
1998-01-07 07:43:04 +00:00
.Ar last_track .
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
The first track has number 1.
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
Can be omitted in all cases.
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.It Cm play Xo
.Ar start_m : Ns Ar start_s . Ns Ar start_f
.Oo Ar end_m : Ns Ar end_s . Ns
.Ar end_f Oc
.Xc
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Play from the absolute address
(MSF) defined by
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar start_m
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
in minutes,
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar start_s ,
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
in seconds and
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar start_f
Fix a bunch of spelling errors in a bunch of man pages.
1996-01-30 13:52:50 +00:00
(frame number) to the absolute address defined by
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar end_m
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
in minutes,
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar end_s ,
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
in seconds and
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar end_f
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
(frame number). Minutes are in the range 0-99.
Seconds are in the range 0-59.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Frame numbers are in the range 0-74.
Implement several new commands
1996-02-03 14:13:36 +00:00
.It Cm play Op Ar #start_block Op length
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Play starting from the logical block
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar start_block
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
using
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar length
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
logical blocks.
.It Cm pause
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 14:09:25 +00:00
Stop playing.
Do not stop the disc.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Cm resume
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 14:09:25 +00:00
Resume playing.
Used after the
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Em pause
command.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Cm stop
Stop the disc.
.It Cm eject
Eject the disc.
Integrate vak fixes, mostly command parsing & cosmetic Submitted by: vak@cronyx.ru
1996-02-09 00:22:17 +00:00
.It Cm close
Implement 'inject' command
1996-02-02 22:03:37 +00:00
Inject the disc.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Cm volume Ar left_channel Ar right_channel
Set the volume of left channel to
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar left_channel
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
and the volume of right channel to
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.Ar right_channel .
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Allowed values are in the range 0-255.
.It Cm volume Ar mute
Turn the sound off.
.It Cm volume Ar mono
Set the mono mode.
.It Cm volume Ar stereo
Set the stereo mode.
.It Cm volume Ar left
Play the left subtrack on both left and right channels.
.It Cm volume Ar right
Play the right subtrack on both left and right channels.
.It Cm info
delete doubled words, e.g.: "the the" -> "the"
1996-10-05 22:27:30 +00:00
Print the table of contents.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Cm status Xo
The status command prints the audio position, the media catalog and the volume value for the disc. It is now possible to specify additional arguments (audio, volume, media) to print only a subset of the full status. This is particularly useful with drives which stop playing when asked to return the catalog number.
1998-01-26 00:57:54 +00:00
.Op Ar audio | media | volume
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Xc
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Print the information about the disc:
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Pp
.Bl -tag -width "volume" -compact
.It Ar audio
the current playing status and position
.It Ar media
the current media catalog status
.It Ar volume
Implement several new commands
1996-02-03 14:13:36 +00:00
the current values of the volume for left and right channels.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.El
Add a new command, 'cdid', to calculate and display a serial number for a cd, using the algorithm that the cddb database uses. Submitted by: Sergey Shkonda <serg@bcs.zp.ua>
2000-07-13 22:56:43 +00:00
.It Cm cdid
Display the serial number of the cd using the method used by the
cddb (http://www.cddb.org/) project.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Cm help
Print the list of available commands.
.It Cm debug Ar on
Enable the debugging mode of the CD device driver.
.It Cm debug Ar off
Disable the driver debugging mode.
Implement several new commands
1996-02-03 14:13:36 +00:00
.It Cm reset
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
Perform the hardware reset of the device.
Implement several new commands
1996-02-03 14:13:36 +00:00
.It Cm set Ar msf
Set minute-second-frame ioctl mode (default).
.It Cm set Ar lba
Set LBA ioctl mode.
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.It Cm quit
Quit the program.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.El
Describe that the CDROM environment variable now affects which device is used by default.
2001-01-14 16:29:24 +00:00
.Sh ENVIRONMENT
The following environment variables affect the execution of
.Nm :
mdoc(7) police: removed empty line (mdocNG does not like them), columnate ENVIRONMENT variables.
2001-01-17 08:32:08 +00:00
.Pp
.Bl -tag -width CD_DRIVE -compact
Describe that the CDROM environment variable now affects which device is used by default.
2001-01-14 16:29:24 +00:00
.It Ev CDROM
The cd device to use if one isn't specified with the
.Fl f
flag.
mdoc(7) police: removed empty line (mdocNG does not like them), columnate ENVIRONMENT variables.
2001-01-17 08:32:08 +00:00
.Pp
.It Ev CDPLAY
.It Ev CD_DRIVE
.It Ev DISC
.It Ev MUSIC_CD
Deprecate the use of the CD_DRIVE, CDPLAY, DISC and MUSIC_CD environment variables in favour of CDROM. Discussed on: stable@FreeBSD.org
2001-01-16 20:31:53 +00:00
These variables have been deprecated in favour of
.Ev CDROM .
Describe that the CDROM environment variable now affects which device is used by default.
2001-01-14 16:29:24 +00:00
.El
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Sh FILES
Update device names.
2000-05-07 09:50:44 +00:00
.Bl -tag -width /dev/mcd0c -compact
.It Pa /dev/cd0c
.It Pa /dev/mcd0c
.It Pa /dev/acd0c
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.El
.Sh AUTHORS
Use Pa for files and Ar for arguments.
1997-12-08 07:43:13 +00:00
.An Jean-Marc Zucconi ,
.An Andrey A.\ Chernov ,
.An Serge V.\ Vakulenko
Add the cdcontrol program by Serge Vakulenko. It's my understanding that this is a superset of cdplay, and perhaps it's time to send cdplay into the bit bucket if this works well. According to the docs, it has a friendlier command structure, command line interface etc. Submitted by: Serge Vakulenko <vak@cronyx.ru>
1995-08-18 11:41:32 +00:00
.Sh HISTORY
The
Use err(3). Style in usage().
1997-09-04 11:52:28 +00:00
.Nm
Use the .Fx macro where appropriate.
1996-08-23 00:57:08 +00:00
command appeared in
.Fx 2.1 .
Reference in New Issue Copy Permalink