.\" '\" 
.\" '\" $Id: dag_irigb.1 13292 2010-10-06 22:30:36Z jomi.gregory $
.\" '\" 
.\" .
.TH "dag_irigb" "1" "July 2009" "Endace" "Endace Software Command Manual"
.SH "NAME"
.B dag_irigb
\- Endace DAG card IRIG\-B time reader
.
.SH "SYNOPSIS"
.B dag_irigb
.RI [ options ]
.
.SH "DESCRIPTION"
.B dag_irigb
is used to synchronise the host system clock with an external IRIG\-B 
time device. This tool reads IRIG\-B data from the external device 
and decodes time information. It reads IRIG\-B time and displays it 
to user. Optionally, the user can use this information to set host
system clock time.

If the IRIG\-B device uses time standard different to the host 
sytem clock one then you can specify the delta value between these.

This tool can also be run in daemon mode as an NTP reference clock via 
the ntpd shared memory driver. The IRIG\-B or DUCK time can be used as 
the reference clock.
.SH "OPTIONS"
.HP
\-?,\-\-usage
.TP 
\fB\-h\fR,\-\-help
display help (this page)
.TP 
\fB\-V\fR,\-\-version
display version information
.TP 
\fB\-v\fR,\-\-verbose
increase verbosity
.TP 
\fB\-d\fR,\-\-device <device>
DAG device to use.
.TP 
\fB\-t\fR,\-\-host
year information provided by host (default)
.TP 
\fB\-i\fR,\-\-irigb
year information provided by IRIG\-B
.TP 
\fB\-m\fR,\-\-daemon
fork into background, run as daemon in Linux and update NTP shared memory unit
.TP 
\fB\-s\fR,\-\-set
set host time to IRIG\-B time
.TP 
\fB\-b\fR,\-\-sec <delta>
set the difference between UTC and the IRIG\-B device time in second.
.TP 
\fB\-r\fR,\-\-hour <delta_hour>
set the difference between UTC and the IRIG\-B device time in hours.
.TP 
\fB\-u\fR,\-\-ntp\-shm\-unit <shm_unit>
ntp shared memory\-segment unit(0 \- 3)to use
.TP 
\fB\-D\fR,\-\-duck
use DUCK time as the ntp shared memory reference clock(default is IRIG\-B time)
.SH "EXAMPLES"
Displays host system clock time and IRIG\-B device time:
.RS
.B dag_irigb \-d0 
.RE
.P
Synchronise host system clock time using the data from the IRIG\-B device:
.RS
.B dag_irigb \-d0 \-s
.RE
.P
Specify the delta value between host system clock and the IRIG\-B device in second:
.RS
.B dag_irigb \-d0 \-b 2 
.RE
.P

Run as a daemon to read the IRIG\-B time and write to NTP shared memory unit 2.
.RS
.B dag_irigb \-d0 \-m  \-u 2

Note: For the above command to work, the nptd has to be 
configured  to read the SHM updates. Here is a sample ntp.conf stanza.

.B server 127.127.28.2 
.br 
.B fudge 127.127.28.2  refid SHM

.RE
.P
.
.SH "BUGS"
Report bugs to <support@endace.com>.
.
.SH "LAST UPDATED"
$Author: jomi.gregory $
.br 
$Revision: 13292 $
.br 
$Date: 2010-10-07 11:30:36 +1300 (Thu, 07 Oct 2010) $
.
.SH "COPYRIGHT"
(c) 2004\-2009 Endace Technology, Hamilton, New Zealand.  All Rights Reserved.

.