1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
.TH CDTOOL 1 24-June-1998 LOCAL "Unix Programmer's Manual"
.\" manual page copyright 1994 thomas insel
.\" copyright 1995,96 sven oliver moll
.\" copyright 1997, 1998 Wade Hampton and Dan Risacher
.\" $Id: cdtool.1,v 1.2 1998/01/06 21:00:33 wadeh Exp wadeh $
.SH NAME
cdtool \- play and catalog audio CDROMs on CDROM drive(s)
.SH SYNOPSIS
.nf
\fBcdadd\fR [-[0..9]|-d device]
\fBcdeject\fR [-[0..9]|-d device] [-V|-?|-h]
\fBcdir\fR -n [-[0..9]|-d device] [-r|-s|-t|-V|-?|-h]
\fBcdinfo\fR [-[0..9]|-d device] [-a|-r|-s|-t|-v|-V|-?|-h]
\fBcdpause\fR [-[0..9]|-d device] [-V|-?|-h]
\fBcdplay\fR [-[0..9]|-d device] [\fIstart\fR [\fIstop\fR]
\fBcdplay\fR [-[0..9]|-d device] [\fI+|-\fR \fInumber\fR]
\fBcdplay\fR [-[0..9]|-d device] [start|stop|resume|eject|info|dir]
\fBcdplay\fR [-[0..9]|-d device] [-V|-?|-h]
\fBcdstop\fR [-[0..9]|-d device] [-V|-?|-h]
\fBcdvolume\fR [-[0..9]|-d device] [-V|-?|-h|\fIlevel\fR]
\fBcdshuffle\fR [-[0..9]|-d device] [-V|-?|-h]
.fi
.SH DESCRIPTION
The
.I cdadd
command is a shell script which uses
.I cdir -t
and assists users in adding a new entry to the
.B ~/.cdtooldb
database file. It allows the user to edit a blank template database entry
for the current compact disc, and then appends it to the file.
.PP
The
.I cdeject
command ejects the current compact disc.
.PP
The
.I cdir
command lists information about the currently loaded audio compact disc.
In particular, it lists the lengths of all tracks.
It also references the database files specified in the
.B CDTOOLPATHDB
environment variable and the
.B ~/.cdtooldb
file, which use a simplified version of the format used by
.IR workman(1).
If one of these files contains an entry for the current compact disc,
.I cdir
will print title, artist, and track name information.
.RS
.IP \fB-n\fR
Do not lookup any information in the database files.
.IP \fB-s\fR
Print information in a short format: only author, title, and current
track, all on one line.
.IP \fB-t\fR
Print a template for the current cd, including title, artist, and track name
information if available. If blank lines are filled in, this can be appended to the
.B ~/.cdtooldb
file.
.RE
.PP
The
.I cdinfo
command, with no option used, will print out the audiostatus (playing, etc.).
.RS
.IP \fB-a\fR
Print out the absolute disc time.
.IP \fB-r\fR
Print out the relative track time.
.IP \fB-s\fR
Print out the audiostatus.
.IP \fB-t\fR
Print out the current track.
.IP \fB-v\fR
All info: \fBstatus track absolute relative\fR.
.RE
.PP
The
.I cdpause
command pauses the currently playing compact disc. Resume by using
.I cdplay
with no arguments.
.PP
The
.I cdplay
command plays the compact disc. If called with one argument, this is
the starting track number. If called with two arguments, these are the
starting and stopping track numbers. If the first argument is a
.B +
or
.B -
then skip the number of tracks given by the second argument forward or
backward. If no second argument is give, skip one. A
.B 0
as first argument or no argument replays current track.
.PP
The
.I cdstop
command stops the compact disc, if it is playing.
.PP
The
.I cdvolume
command sets the output volume level of the CD player. The level is an
integer from 0 to 255.
.PP
The
.I cdshuffle
command plays the audio tracks on the disc in random order.
.PP
The default device opened is \fB/dev/cdrom\fR. This default and others
may be changed in \fIconfig.h\fR. Options supported by all programs are:
.RS
.IP \fB-[0..7]\fR
Multiple cdrom support to open \fB/dev/scd0../dev/scd7\fR [by default].
.IP \fB-d device\fR
Multiple cdrom support to open \fBdevice\fR by name.
.IP \fB[-h|-?]\fR
Print out help for the command.
.IP \fB-V\fR
Print out version information and build information.
.RE
.SH FILES
.B ~/.cdtooldb
- default database file.
.SH ENVIRONMENT
.B CDTOOLDBPATH
- colon delimited path of database files to search. It is not necessary to
specify
.BR ~/.cdtooldb ,
as this is automatically added to the end of the search path.
.PP
.B CDTOOLDEV
- device file for cd-rom, overrides compile-time defaults.
.SH SEE ALSO
cdctrl(1)
.SH AUTHORS
.nf
Main code:
.RS
Thomas Insel <tinsel@tinsel.org>
.RE
Enhancements:
.RS
Byron Ellacott <rodent@homer.humbug.org.au>
Wade Hampton <whampton@staffnet.com>
Lin Zhe Min <ljm@ljm.wownet.net>
Sven Oliver Moll <smol0075@rz.uni-hildesheim.de>
Daniel R. Risacher <risacher@worldnet.att.net>
.RE
.fi
|