File: fm.1

package info (click to toggle)
fmtools 1.0.2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 104 kB
  • ctags: 291
  • sloc: ansic: 738; makefile: 74
file content (137 lines) | stat: -rw-r--r-- 2,768 bytes parent folder | download | duplicates (2)
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
.TH FM 1 "fm 1.0.2"
.SH NAME
fm \- control frequency, volume, mute/unmute of FM radio card
.SH SYNOPSIS
.HP
.B fm
[
.B \-h
] [
.B \-o
] [
.B \-q
] [
.B \-d
.I device
] [
.B \-t
.I tuner
] [
.B \-T
.B none
|
.B forever
|
.I time
]
.B on
|
.B off
|
.B +
|
.B \-
|
.B freq
[
.I volume
]
.SH DESCRIPTION
.B fm
is a program to control the frequency, volume, and mute/unmute state
of an FM radio card, using the video4linux interface introduced in
2.1.x series Linux kernels.
.SS OPTIONS
.PP
.TP
.B \-h
Print a usage message to standard output, and exit.
.TP
.B \-o
Ignore frequency range limits of card.  Use if you suspect that the
card supports a wider frequency range than its driver believes.
.TP
.B \-q
Quiet mode.  Keeps information on station and volume from being
printed on standard output.
.TP
\fB\-d \fIdevice
Sets \fIdevice\fR as the device to tune.  The default is
\fB/dev/radio0\fR.
.TP
\fB\-t \fItuner
Sets \fItuner\fR as the tuner on the selected device to adjust.  The
default is tuner 0.  Most radio devices have only a single tuner.
.TP
\fB\-T none \fR| \fBforever \fR| \fItime
After tuning, sleep for the time specified or forever.  Time is
specified in seconds by default.  A suffix of
.B m
indicates minutes,
.B h
indicates hours, or
.D d
indicates days.
.IP
The
.B -T
option is useful with radio card drivers that only maintain the tuner
settings while the tuner's file descriptor remains open.  Try using
this option if running
.B fm
ordinarily produces only a single "pop" from your speakers.
.TP
.BI freq
Frequency to tune the radio to, in MHz.  For instance, \fB88.9\fR
specifies a frequency of 88.9 MHz.  AM tuner values are also specified
in MHz; for instance, 530 kHz would be specified as \fB.530\fR.
.TP
.BI on
Turn the radio on (unmute).
.TP
.BI off
Turn the radio off (mute).
.TP
.BI volume
Specify the desired volume, in percent.  Not all radio devices support
volume control.
.TP
.BI +
Increase the current volume.
.TP
.BI -
Decrease the current volume.
.SH CONFIGURATION
.B fm
reads \fI$HOME\fB/.fmrc\fR, if it exists, to obtain default settings.
Each line may take one of the following forms:
.TP
.BR VOL \ percent
Specifies default volume (default: 12.5%).
.TP
.BR INCR \ percent
Volume increment used for
.B +
and
.B -
options (default: 10%).
.TP
.BR TIME
Default sleep time (default:
.BR none ).
.PP
All other lines are ignored.
.SH SEE ALSO
.TP
Additional documentation:
.B /usr/share/doc/fmtools/README
.TP
The fmtools homepage:
.B http://benpfaff.org/fmtools
.TP
The video4linux webpage:
.B http://www.exploits.org/v4l/
.SH AUTHORS
Russell Kroll <rkroll@exploits.org>, now maintained by Ben Pfaff
<blp@cs.stanford.edu>.  Sleep time feature contributed by Dave Ulrick
<d-ulrick@insightbb.com>.  This manpage written by Ben Pfaff.