gated(1M) gated(1M)
NAME
gated - gateway routing daemon
SYNOPSIS
in.gated [-cn] [-t [trace_options]] [-f config_file] [trace_file]
DESCRIPTION
The gated command is a routing daemon that handles multiple
routing protocols. gated replaces routed(1M), and any routing
daemons that speak the BGP, EGP, or HELLO routing protocols.
USAGE
gated currently handles the RIP, BGP, EGP, and HELLO routing
protocols. The gated process can be configured to perform all
of these four routing protocols, or any combination of the
four.
Options
gated takes the following options:
-c Specifies that the configuration file will be parsed for
syntax errors and then gated will exit, leaving a dump
file in /usr/tmp/gated_dump. Note that gated does not
need to be run as a privileged user to use the -c
option. The -c option implies the trace flag-tierk.
-n Specifies that gated will not modify the kernel's routing
table. This is used for testing gated configurations
with actual routing data.
-t trace_options
Specifies trace flags to be enabled on startup. If no
flags are specified, -tier is assumed. If no flags are
specified, this option must be followed by another
switch to prevent trace_file from being parsed as flags.
This option must be used to trace events that take place
before the config file is parsed, such as determining
the interface configuration and reading routes from the
kernel.
The trace flags are:
A all
Copyright 1994 Novell, Inc. Page 1
gated(1M) gated(1M)
i internal
e external
k kernel
J job
m mark
r route
t nostamp
P protocol
u update
R RIP
H HELLO
C icmp
p EGP
B BGP
The trace flags are explained in greater detail in
gated.conf(4).
-f config_file
Use the alternate configuration file config_file. By
default, gated uses /etc/inet/gated.conf.
If a config_file is specified, or no trace flags are
specified, gated detaches from the terminal and runs in
the background. If trace flags are specified without
specifying a trace_file, gated assumes that tracing is
desired to the console and remains in the foreground.
Signal Processing
gated catches the following signals and does special
processing.
SIGHUP
Re-read configuration.
A SIGHUP causes gated to reread the configuration file.
gated first performs a clean-up of all allocated policy
structures. All BGP and EGP peers are flagged for
deletion and the configuration file is re-parsed.
If the re-parse 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.
Copyright 1994 Novell, Inc. Page 2
gated(1M) gated(1M)
It should also be possible to enable/disable any protocol
without restarting gated.
SIGINT
Snap-shot of current state.
The current state of all gated tasks, timers, protocols
and tables are written to /usr/tmp/gated_dump.
On systems supporting fork(2), this is done by forking a
subprocess to dump the table information so as not to
impact gated's routing functions. On systems where
memory management does not support copy-on-write, this
will cause the gated address space to be duplicated;
this may cause a noticeable impact on the system. On
systems not supporting fork(2), the main process
immediately processes the dump, which may 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
shutdown. 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 exterior routes (BGP and EGP) are removed from the
kernel's routing table on receipt of a SIGTERM.
Interior routes (all others) remain. To terminate gated
with the exterior routes intact, use SIGKILL or SIGQUIT
(which causes a core dump).
SIGUSR1
Toggle tracing.
On receipt of a SIGUSR1, gated closes 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 if tracing is being performed to the
console.
Copyright 1994 Novell, Inc. Page 3
gated(1M) gated(1M)
REFERENCES
arp(1M), ifconfig(1M), gated.conf(4), netstat(1M), routed(1M)
RFC 891, RFC 904, RFC 1058, RFC 1163, RFC 1164
Copyright 1994 Novell, Inc. Page 4