gated(1M) DG/UX R4.11MU05 gated(1M)
NAME
gated - start gateway routing server program
SYNOPSIS
gated [-c] [-C] [-n] [-N] [-ttraceopts] [-fconfigfile] [tracefile]
where:
traceopts Any of the trace flags listed under "Trace Options" in
the gated-config(4M) man page; default = general
configfile Name of configuration file; default = /etc/gated.conf
tracefile Name of trace file; default = stderr
DESCRIPTION
Gated is a routing server (daemon) that handles multiple routing
protocols and replaces routed(1M) and any routing server that speaks
the HELLO routing protocol. gated currently handles the RIP, HELLO,
and OSPF routing protocols. The gated process can be configured to
perform all routing protocols or any combination of the three.
Options
-c Specify that the configuration file will be parsed for syntax
errors and then gated will exit. If there were no errors,
gated leaves a dump file in /var/tmp/gateddump. You do not
need to run gated as a user with appropriate privilege to use
the -c option, but it will be unable to read the kernel
routing table and interface configuration if you do not have
appropriate privilege. The -c option implies
-tgeneral,kernel,nostamp. All traceoption and tracefile
clauses in the configuration file will be ignored.
-C Specify that the configuration file will just be parsed for
syntax errors. Exit status is 1 if there were any errors, 0
if there were not. You do not need to run gated as a user
with appropriate privilege to use the -C option, but it will
not be possible to read the kernel routing table and interface
configuration if you do not have appropriate privilege. The
-c option implies -tnostamp.
-n Specify that gated will not modify the kernel's routing table.
This is used for testing gated configurations with actual
routing data.
-N Specify that gated will not divorce itself from the
controlling terminal (daemonize). If tracing to stderr is not
specified and the parent pid is not 1, gated detaches from the
parent process and runs in the background.
-t Specify a comma-separated list of trace options to be enabled
on startup [see gated-config(4M)]. No space is allowed
between this option and its arguments. You can use -t to
trace events that take place before the configuration file is
parsed, such as determining the interface configuration and
reading routes from the kernel.
-f Use an alternate configuration file.
If on the command line a trace 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 stderr and remains in
the foreground.
Signal Processing
Gated catches a the following signals and does special processing:
SIGHUP Reread the configuration file. gated first performs a
clean-up of all allocated policy structures. You can enable
or disable any protocol without restarting gated.
SIGINT Write the current state of all gated tasks, timers,
protocols, and tables to /var/tmp/gateddump.
SIGTERM Gracefully shut gated down. All tasks and protocols are
asked to shut down. All gated-managed routes will be
flushed from the kernel routing table.
SIGUSR1 Toggle tracing. gated closes the trace file. A subsequent
SIGUSR1 causes it to be reopened. This lets you move the
file regularly. Signaling gated with SIGUSR1 will not
toggle tracing if you have not specified a trace file or if
tracing is being performed to stderr.
SIGUSR2 Check for interface changes. gated will rescan the kernel
interface list looking for network interface additions and
deletions.
AUTHORS
Mark Fedor <fedor@psi.com>, Jeffrey C Honig <jch@gated.cornell.edu>,
Rob Coltun <rcoltun@ni.umd.edu> and Dennis Ferguson <dennis@ans.net>
SEE ALSO
arp(1M), gdc(1M), ifconfig(1M), netstat(1M), ripquery(1M),
routed(1M), gated-config(4M).
capdefaults(5), appropriateprivilege(5).
RFC 891: DCN Local-Network Protocols (HELLO)
RFC 1058: Routing Information Protocol
RFC 1247: OSPF Specification, Version 2
NOTES
If the system time is changed after gated has started, it will be
necessary to stop and restart gated. See the admtcpipdaemon(1M) man
page for information on how to perform this operation.
For systems supporting the DG/UX Capability Option, appropriate
privilege is defined as having one or more specific capabilities
enabled in the effective capability set of the user. See
capdefaults(5) for the default capabilities for this command.
On systems without the DG/UX Capability Option, appropriate privilege
means that your process has an effective UID of root. See the
appropriateprivilege(5) man page for more information.
COPYRIGHT INFORMATION
This software and associated documentation is Copyright © 1990, 1991,
1992 Cornell University., all rights reserved.
This server contains code that is Copyright © 1988 Regents of the
University of California., all rights reserved.; it also contains
code that is Copyright © 1989, 1990, 1991 The University of Maryland,
College Park, Maryland., all rights reserved; and also contains code
that is Copyright 1991 D.L.S. Associates., all rights reserved.
Licensed material--property of copyright holder(s)