FarSync T-Series Network Daemon (farnetd)
-----------------------------------------

The FarSync T-Series Network Daemon is a small application that may be used to
monitor the state of one or multiple lines by means of the DCD (V.24/V.35),
Indicate (X.21) signals, or E1 alarms. There are two versions of the daemon,
one for 32 bit systems and one for 64 bit systems.  Please ensure that you
choose the correct one for your architecture.

Once started it runs in the background, continuously monitoring the state of 
each desired port.

When a line state is declared UP an ifconfig up command is run for that line.

When a line state is declared DOWN an ifconfig down command is run for that 
line.

A farnetd.cfg file, resident in the same directory as the executable, defines
the configuration of the application in terms of lines to be monitored, rate
to poll the signals/alarms, debounce count and logfile name.

The lines to be monitored have assigned names such as sync0, sync3 etc. These
are defined with one or more DEVICE= statements in the configuration file.

The rate at which signals are polled is defined in seconds. This is defined 
with a POLLRATE= statement in the configuration file.

The debounce count defines the number of consecutive unchanging poll periods 
for which a signal/alarm change must be seen before it is recoginized as a 
change.  This is defined with a DEBOUNCE= statement in the configuration file.

Application configuration information and time-stamped signal change events are
stored in a user-specified log file. This is defined with a LOGFILE= statement
in the configuration file.

Comments may be introduced in the configuration file with a leading '#'.

Type farnetd -? for command line parameters. '-p' purges (deletes) an existing
log file, normally new log information is appended to the existing file. '-v'
displays each device name and how it relates to a T-Series card and port as
well as the current state of the control signals at start up.

farnetd can be run from the command line, however it may be more useful for the
daemon to be run from a startup script. For example, the network daemon could
be started in /etc/rc.d/init.d/farsync by adding the following:-

-------------------------------------------------------------------------------
#	Start the FarSync T-Series Network Daemon

cd /etc/farsite/farnetd/
./farnetd
-------------------------------------------------------------------------------

where /etc/farsite/farnetd/ contains the farnetd executable and the farnetd.cfg
configuration file.

Copyright (c) 2002-2010 FarSite Communications Limited

Web           http://www.farsite.com
Support       support@farsite.com

