~ubuntu-branches/ubuntu/utopic/cdtool/utopic

« back to all changes in this revision

Viewing changes to cdctrl.1

  • Committer: Bazaar Package Importer
  • Author(s): Gergely Nagy
  • Date: 2002-01-22 14:08:28 UTC
  • Revision ID: james.westby@ubuntu.com-20020122140828-l9ztstm6m6anm34c
Tags: upstream-2.1.5
ImportĀ upstreamĀ versionĀ 2.1.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH CDCTRL.1 6-January-1988 LOCAL "Unix Programmer's Manual"
 
2
.\" manual page Copyright 1998, Wade Hampton
 
3
.\" $Id: cdctrl.1,v 1.2 1998/01/06 21:00:33 wadeh Exp wadeh $
 
4
.SH NAME
 
5
cdctrl \- command line CDROM control
 
6
.SH SYNOPSIS
 
7
.nf
 
8
\fBcdctrl\fR  [device]
 
9
\fBcdctrl\fR  -c [device]
 
10
\fBcdctrl\fR  -c 
 
11
\fBcdctrl\fR  [-V|-?|-h]
 
12
.fi
 
13
.SH DESCRIPTION
 
14
.I cdctrl
 
15
command is a program that opens a CDROM device and may be used for 
 
16
interactive control of the CDROM including play starting at a track, 
 
17
next track, previous track, stop, pause, display info, display 
 
18
CDROM status, and display CDROM directory.  This program may be used as
 
19
a daemon to control an audio CDROM device.
 
20
 
 
21
.PP
 
22
The commands to the 
 
23
.I cdctrl
 
24
command are:
 
25
.RS
 
26
.IP \fBdevice\fR
 
27
Open CDROM device.
 
28
.IP \fB-V\fR
 
29
Print out version and build information.
 
30
.IP \fB-h\fR
 
31
Display help.
 
32
.IP \fB-v\fR
 
33
Display help.
 
34
.IP \fB-c\fR
 
35
Output CR-LF at end of each line, not LF.
 
36
.RE
 
37
.PP
 
38
By default, 
 
39
.I cdctrl
 
40
opens \fI/dev/cdrom\fR, but does not start playing.  Output
 
41
is to standard output with each line terminated by a linefeed (LF).
 
42
 
 
43
.PP
 
44
Commands to
 
45
.I cdctrl
 
46
are:
 
47
.RS
 
48
.IP \fB1\fR
 
49
Play first track, start playing.
 
50
.IP \fBs\fR
 
51
Stop playing.
 
52
.IP \fBp\fR
 
53
Pause playing.
 
54
.IP \fBr\fR
 
55
Resume playing.
 
56
.IP \fBe\fR
 
57
Eject CDROM.
 
58
.IP \fBi\fR
 
59
Display info string.
 
60
.IP \fBd\fR
 
61
Display directory.
 
62
.IP \fB-\fR
 
63
Play previous track.
 
64
.IP \fB+\fR
 
65
Play next track.  When on last track, play first track.
 
66
.IP \fB[1..99]\fR
 
67
Play track \fB1..99\fR.
 
68
.IP \fB?\fR
 
69
Display help screen.
 
70
.IP \fBq\fR
 
71
Quit.
 
72
.RE
 
73
.PP
 
74
 
 
75
Each command results in one or multiple lines of output to \fIstdout\fR,
 
76
followed by an \fIinfo\fR string, followed by \fIEND\fR.
 
77
.PP
 
78
The format of the info string is:
 
79
 
 
80
\fICMD cmd-name cd-status track abs-time rel-time\fR
 
81
 
 
82
  cmd-name  := {play, stop, ... quit} from above list
 
83
  cd-status := {invalid, play, paused}
 
84
  cd-status += {completed, error, no_status}
 
85
  track     := {1..99} CD track
 
86
  abs-time  := HH:MM:SS elapsed since CD start
 
87
  rel-time  := HH:MM:SS elapsed since track start
 
88
.PP
 
89
.SH FILES
 
90
.B /dev/cdrom
 
91
- default cdrom device
 
92
.SH ENVIRONMENT
 
93
.B none 
 
94
.PP
 
95
.SH SEE ALSO
 
96
cdplay(1)
 
97
.SH AUTHORS
 
98
.nf
 
99
Main code:
 
100
.RS
 
101
Thomas Insel <tinsel@tinsel.org>
 
102
.RE
 
103
Enhancements:
 
104
.RS
 
105
Sven Oliver Moll <smol0075@rz.uni-hildesheim.de>
 
106
.RE
 
107
cdctrl extensions:
 
108
.RS
 
109
Wade Hampton <whampton@staffnet.com>
 
110
.RE
 
111
.fi