NAME
alevt-date - display/set time received via Teletext
SYNOPSIS
alevt-date [options]
DESCRIPTION
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 date(1) command.
OPTIONS
A summary of options is included below.
-set Set system time from time received via Teletext.
-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.
-format string Format string to used to print the time. Look at
strftime(3) for possible control sequences.
-vbi device Use the given device name. Default: /dev/vbi,
/dev/vbi0, /dev/video0, /dev/dvb/adapter0/demux0
tried in this order.
-timeout seconds If the time can’t be detected in seconds, the program
is terminated with a SIGALRM.
-progname name Specifies the program name if using the DVB
interface.
-pid pid Specifies the teletext PID if using the DVB
interface.
--help Show summary of options.
--version Show version of program.
Before starting this program, you have to set the TV channel with
another program like xawtv of set-tv.
Note: This program does not set the battery backed up clock of your
computer. clock -w will do this.
The -progname or -pid option specifies the program or teletext PID if
using the DVB interface.
If neither of these two options is used, alevt outputs informations
about the currently accessible streams and uses the first of these PIDs
as default. This output contains the PIDs and names that can be used as
an input for the -progname or -pid option in the context of the
currently chosen TV channel.
FILES
/dev/vbi*
/dev/dvb/adapter*/demux*
SEE ALSO
alevt(1x), alevt-cap(1), strftime(3), date(1), clock(8).
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.)
No bug reports to <froese@gmx.de> *g*.