File: alevt-date.1.in

package info (click to toggle)
alevt 1:1.6.2-4
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 956 kB
  • ctags: 662
  • sloc: ansic: 6,284; makefile: 119; perl: 104; sh: 15
file content (78 lines) | stat: -rw-r--r-- 1,934 bytes parent folder | download | duplicates (3)
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
.na
.TH ALEVT-DATE 1 "VERSION" LINUX "Teletext time"
.SH NAME
alevt-date \- display/set time received via Teletext

.SH SYNOPSIS
.B alevt-date
.RI [ options ]

.SH "DESCRIPTION"
.B alevt-date
displays the time received from a Teletext source.  It can be used to
set the system time.  The date is not interpreted (not even
transmitted on most channels).  So it allows only adjustment of +/-12 hours.
The default allowed adjustment is limited to +/-2 hours (use -delta to
change).  Without the -set option it just displays the date in the format
of the
.BR date (1)
command.

.SH OPTIONS
A summary of options is included below.
.TP 18
.B \-set
Set system time from time received via Teletext.
.TP
.BI \-delta \ seconds
Maximum allowed adjustment made to the system time.  The default is
7200 seconds (2 hours) and the maximum that may be given is 12 hours.
.TP
.BI \-format \ string
Format string to used to print the time.  Look at
.BR strftime (3)
for possible control sequences.
.TP
.BI \-vbi \ device
Use the given device name (default: /dev/vbi0).
.TP
.BI \-timeout \ seconds
If the time can't be detected in
.IR seconds ,
the program is terminated with a SIGALRM.
.TP
.B \-\-help
Show summary of options.
.TP
.B \-\-version
Show version of program.
.PP
Before starting this program, you have to set the TV channel
with another program like
.B xawtv
of
.BR set-tv .
.PP
Note: This program does
.B not
set the battery backed up clock of your computer.
.I clock -w
will do this.

.SH FILES
.I /dev/vbi*

.SH SEE ALSO
.BR alevt (1x),
.BR alevt-cap (1),
.BR strftime (3),
.BR date (1),
.BR clock (8).

.SH BUGS
This program is just a toy.  The time transmitted by the TV stations
is more than inaccurate.  Some are within a few seconds of your local
time reference but others are more then 15 minutes off.  You've been warned.
(And don't assume the pkt8/30 time is better.  It's even worse.)
.PP
No bug reports to <froese@gmx.de> *g*.