.na .TH ALEVT-DATE 1 "1.8.0" 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/vbi, /dev/vbi0, /dev/video0, /dev/dvb/adapter0/demux0 tried in this order. .TP .BI \-timeout \ seconds If the time can't be detected in .IR seconds , the program is terminated with a SIGALRM. .TP .BI \-progname \ name Specifies the program name if using the DVB interface. .TP .BI \-pid \ pid Specifies the teletext PID if using the DVB interface. .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. The .B \-progname or .B \-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 .B \-progname or .B \-pid option in the context of the currently chosen TV channel. .SH FILES .I /dev/vbi* .I /dev/dvb/adapter*/demux* .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 Bug reports to .