gated.1m (2010 09)

g
gated(1M) gated(1M)
NAME
gated - gateway routing daemon
SYNOPSIS
gated [-b buffer_size ][
-c][-C][-n][-N][-r][-ttrace_options ][
-f config_file ][trace_file ]
DESCRIPTION
gated is a routing daemon that handles multiple routing protocols and replaces routed, egpup, and any
routing daemon that speaks the HELLO routing protocol.
gated 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 (see WARNINGS below).
Options
The command-line options are:
-b buffer_size Specifies a buffer size for the socket read/write buffer. The buffer size should not be
less than one MB (megabyte) and should not exceed the available system memory. If
this option is not specified, the buffer size will be set to the available system memory.
-c Specifies that the configuration file will be parsed for syntax errors and then
gated
will exit. gated will leave a dump file in
/var/tmp/gated_dump
if there were
no errors.
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 forwarding table and interface configuration
if not run as superuser. The
-c option implies -tgeneral. All trace_option
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 (zero) if there were not.
gated
does not need to be run as the superuser to use the -C option but it may not be possi-
ble to read the kernel forwarding table and interface configuration if not run as the
superuser.
-n Specifies that gated will not modify the kernel forwarding table. This is used for
testing gated configurations with actual routing data.
-N Specifies that gated will not daemonize. Normally, if tracing to stderr is not
specified gated will daemonize if the parent process ID is not that of the initializa-
tion process (aka init). This allows the use of an /etc/inittab-like method of
invoking gated that does not have a PID of the initialization process.
-r Specifies that gated will add routes to the kernel in the decreasing order of IP
addresses of gateways when there are multiple routes to a destination.
-ttrace_options 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 it’s
arguments.
This option must be used 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 the GateD Configuration Guide for valid trace options and a more detailed expla-
nation of tracing.
-f config_file Use an alternate config file. By default, gated uses /etc/gated.conf.
trace_file Trace file in which to place trace information.
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.
Signal Processing
The following signals may be used to control
gated:
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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1