Content-type: text/html
Man page of gated
gated
Section: Maintenance Commands (8)
Index
Return to Main Contents
NAME
gated - gateway routing daemon
SYNOPSIS
/usr/sbin/gated [-c] [-C] [-n] [-N] [-t trace_options]
[-f config_file] [trace_file]
FLAGS
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 1, gated runs
as a daemon process. This allows the use of an /etc/inittab-like method
of invoking gated that does not have a PID of 1.
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.
-
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 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 is
desired to stderr and remains in the foreground.
DESCRIPTION
The gated routing daemon is based on Release 3.5 from the Cornell
GateDaemon Project. 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
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.
FILES
Contains gated status information.
Contains the gated configuration information.
Contains the gated process id (PID).
RELATED INFORMATION
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)
delim off
Index
- NAME
-
- SYNOPSIS
-
- FLAGS
-
- DESCRIPTION
-
- SIGNAL PROCESSING
-
- FILES
-
- RELATED INFORMATION
-
This document was created by
man2html,
using the manual pages.
Time: 02:40:31 GMT, October 02, 2010