gated(1M) gated(1M)
NAME
gated - gateway routing daemon
SYNOPSIS
gated [-c] [-C] [-n] [-N] [-t traceoptions] [-f configfile]
[tracefile]
DESCRIPTION
gated is a routing daemon that handles multiple routing protocols and
replaces routed(1M). gated currently handles the RIP, BGP, EGP, HELLO,
SLSP, ICMP, OSPF, and RDISC routing protocols. The gated process can
be configured for all routing protocols or any subset of them.
OPTIONS
-c Specifies that the configuration file will be parsed for syntax
errors and then gated will terminate, if there were no errors,
gated will leave a dump file in /usr/tmp/gateddump. gated does
not need to be run as the superuser to use the -c option but it
may not be possible to read the kernel routing table and inter-
face configuration if not run as superuser. The -c option implies
-tgeneral. All traceoption clauses in the configuration file
will be ignored.
-C Specifies that the configuration file will just be parsed for
syntax errors. gated will exit with a status 1 if there were any
errors and 0 if there were not. gated does not need to be run as
the superuser to use the -C option but it may not be possible to
read the kernel routing table and interface configuration if not
run as superuser.
-n Specifies that gated will not modify the kernel routing table.
This is used for testing gated configurations with current rout-
ing data.
-N Specifies that gated will not run as a daemon. Normally, if trac-
ing to stderr is not specified gated will start as a daemon if
the parent process ID is not 1. This allows the use of an
/etc/inittab-like method of invoking gated that does not have a
PID of 1.
-t traceoptions
Specifies a comma-separated list of trace options to be enabled
on startup. If no flags are specified, general is assumed. No
space is allowed between this option and its arguments. This
option must be used to trace events that take place before the
config file is parsed, such as determining the interface confi-
guration and reading routes from the kernel.
-f configfile
Use an alternate config file. By default, gated uses
/etc/gated.conf.
Page 1 Reliant UNIX 5.44 Printed 11/98
gated(1M) gated(1M)
If a trace file is specified on the command line, or no trace flags
are specified on the command line, gated detaches from the terminal
and runs in the background. If trace flags are specified without
specifying a trace file, gated assumes that tracing to stderr is
desired and remains in the foreground.
SIGNAL PROCESSING
The following signals may be used to control gated:
SIGHUP Reread configuration. A SIGHUP causes gated to reread the
configuration file. gated first performs a clean-up of all
allocated structures. All BGP and EGP peers are flagged for
deletion and the configuration file is reparsed.
If the reparse is successful, any BGP and EGP peers that are
no longer in the configuration are shut down, and new peers
are started. gated attempts to determine if changes to
existing peers require a shutdown and restart. OSPF is not
capable of reconfiguring, it is shut down and restarted dur-
ing a reconfiguration. This may have an adverse impact on
the routing system.
It should also be possible to enable/disable any protocol
without restarting gated.
SIGINT Dump of current state. The current states of all gated
tasks, timers, protocols, and tables are written to
/usr/tmp/gateddump.
This is done by forking a subprocess to dump the table
information so as not to impact gated's routing functions.
SIGTERM Graceful shutdown. On receipt of a SIGTERM, gated attempts a
graceful shutdown. All tasks and protocols are asked to shut
down. Most will terminate immediately, the exception being
EGP peers which wait for confirmation. It may be necessary
to repeat the SIGTERM once or twice if it this process takes
too long.
All protocol routes are removed from the kernel forwarding
table on receipt of a SIGTERM. Interface routes, routes with
RTFSTATIC [see routing(4)] set (from the route command
where supported) and static routes specifying retain will
remain. To terminate gated with the exterior routes intact,
use SIGKILL.
Page 2 Reliant UNIX 5.44 Printed 11/98
gated(1M) gated(1M)
SIGUSR1 Toggle tracing. On receipt of a SIGUSR1, gated will close
the trace file. A subsequent SIGUSR1 will cause it to be
reopened. This will allow the file to be moved regularly.
It is not possible to use SIGUSR1 if a trace file has not
been specified, or tracing is being performed to stderr.
SIGUSR2 Check for interface changes. On receipt of a SIGUSR2, gated
will rescan the kernel interface list looking for changes.
FILES
Many of the default filenames listed below contain the string gated,
which is replaced by the name with which gated is invoked. Normally
this is gated, but if invoked as gated-test, gated will by default
look for /etc/gated-test.conf. These paths may all be changed at com-
pilation time.
/usr/tmp/gateddump
Where gated writes status information. The default is
/usr/tmp/gateddump. Another common path is /var/tmp/gateddump.
/etc/gated.conf
Where gated looks for its configuration file. The default is
/etc/gated.conf.
/etc/gated.pid
Where gated writes its process id (PID). The default is
/etc/gated.pid, but /var/run/gated.pid is common.
SEE ALSO
arp(1M), ifconfig(1M), netstat(1M), route(1M), routed(1M), fork(2),
gdc(8), ospfmonitor(8), ripquery(8).
Page 3 Reliant UNIX 5.44 Printed 11/98