gated(8)gated(8)NAMEgated - gateway routing daemon
SYNOPSIS
/usr/sbin/gated [-c] [-C] [-n] [-N] [-t trace_options] [-f config_file]
[trace_file]
OPTIONS
Specifies that gated parse the configuration file for syntax, then
exit. If there are no errors, gated leaves a dump file in
/usr/tmp/gated_dump.
You do not need root privileges to use the -c option. However,
if you do not have root privileges, gated might not be able to
read the kernel forwarding table and interface configuration.
The -c option implies -tgeneral. All trace_option clauses in
the configuration file are ignored. Specifies that gated parse
the configuration file for syntax errors. If no errors occur,
gated exits with a status 0. Otherwise, it exits with a status
1.
You do not need root privileges to use the -C option. However,
if you do not have root privileges, gated might not be able to
read the kernel forwarding table and interface configuration.
Specifies that gated not modify the kernel forwarding table.
This is used for testing gated configurations with actual rout‐
ing data. Specifies that gated run as a user process. Nor‐
mally, if tracing to stderr is not specified and if the parent
process is not init, gated runs as a daemon process. This
allows the use of an /etc/inittab-like method of invoking gated.
Specifies a comma-separated list of trace options to be enabled
on startup. If no options are specified, general is assumed.
No space is allowed between this option and its arguments.
Use this to trace events that take place before the configura‐
tion file is parsed, such as determining the interface configu‐
ration and reading routes from the kernel.
See gated.conf(4) for valid trace options and a more detailed
explanation of tracing. Specifies an alternate configuration
file. By default, gated uses /etc/gated.conf.
If a trace file is specified on the command line, or no trace
options are specified on the command line, gated detaches from
the terminal and runs in the background. If trace options are
specified without specifying a trace file, gated assumes that
tracing is desired to stderr and remains in the foreground.
DESCRIPTION
The gated routing daemon is based on Release 4.0.6 from NextHop Tech‐
nologies, Inc. The gated daemon replaces routed and egpup, and cur‐
rently handles the RIP, BGP, EGP, HELLO, and OSPF routing protocols.
The gated process can be configured to perform all routing protocols or
any subset of them.
SIGNAL PROCESSING
You can use the following signals to control gated: Causes gated to
reread the configuration file. The gated daemon first performs a
clean-up of all allocated policy 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 shutdown and restarted during a reconfigu‐
ration. This may have an adverse impact on the routing system.
It should also be possible to enable/disable any protocol with‐
out restarting gated. Causes gated to write the current state
of all tasks, timers, protocols, and tables to the
/usr/tmp/gated_dump file.
On systems supporting fork(), this is done by forking a subpro‐
cess to dump the table information. This does not affect
gated's routing functions. On systems where memory management
does not support copy-on-write, fork() causes the gated address
space to be duplicated; this might cause a noticeable impact on
the system. On systems not supporting fork(), the main process
immediately processes the dump, which might impact gated's rout‐
ing functions. Causes gated to shut down. All tasks and proto‐
cols are asked to shutdown. Most terminate immediately, except
EGP peers, which waits for confirmation. You might have to send
SIGTERM once or twice if it this process takes too long to shut
down.
All protocol routes are removed from the kernel forwarding table
on receipt of a SIGTERM. Interface routes, routes with
RTF_STATIC set (from the route command where supported) and
static routes specifying retain will remain. To terminate gated
with the exterior routes intact, use SIGKILL. Causes gated to
close the trace file. A subsequent SIGUSR1 reopens the trace
file. This allows the file to be moved regularly.
You cannot use SIGUSR1 if a trace file has not been specified or
if tracing is being performed to stderr. Causes gated to rescan
the kernel interface list for changes.
FILES
Contains gated status information. Contains the gated configuration
information. Contains the gated process id (PID).
SEE ALSO
Commands: arp(8), gdc(8), ifconfig(8), netstat(1), ospf_monitor(8),
ripquery(8), routed(8), route(8)
Functions: fork(2)
Files: gated.conf(4), gated.proto(4), gated.control(4)gated(8)