gated - gateway routing daemon
/usr/sbin/gated [-c] [-C] [-n] [-N] [-t trace_options] [-f
config_file] [trace_file]
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 routing data. Specifies that
gated run as a user process. Normally, 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
configuration file is parsed, such as determining
the interface configuration 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.
The gated routing daemon is based on Release 4.0.6 from
NextHop Technologies, Inc. The gated daemon replaces
routed and egpup, and currently 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 [Toc] [Back]
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
reconfiguration. This may have an adverse impact on
the routing system.
It should also be possible to enable/disable any
protocol without 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 subprocess 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 routing functions.
Causes gated to shut down. All tasks and
protocols 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.
Contains gated status information. Contains the gated
configuration information. Contains the gated process id
(PID).
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)
[ Back ] |
