gdc.1m (2010 09)

g
gdc(1M) gdc(1M)
NAME
gdc - operational user interface for gated
SYNOPSIS
gdc [-q][-n][
-c coresize ][-f filesize][-m datasize ][-s stacksize ][
-t seconds ] command
DESCRIPTION
gdc provides a user-oriented interface for the operation of the
gated routing daemon. It provides sup-
port for starting and stopping the daemon, for the delivery of signals to manipulate the daemon when it is
operating, for the maintenance and syntax checking of configuration files, and for the production and
removal of state dumps and core dumps.
gdc can reliably determine gated’s running state and produces a reliable exit status when errors occur,
making it advantageous for use in shell scripts which manipulate
gated. Commands executed using
gdc and, optionally, error messages produced by the execution of those commands, are logged via the
same syslogd facility which gated itself uses, providing an audit trail of operations performed on the
daemon.
If installed as a setuid root program
gdc will allow non-root users who are members of a trusted group
(by default the
gdmaint group) to manipulate the routing daemon while denying access to others. The
name of the user is logged along via
syslogd along with an indication of each command executed, for
audit purposes.
The command-line options are:
-n Run without changing the kernel forwarding table. Useful for testing, and when operat-
ing as a route server which does no forwarding.
-q Run quietly. With this option informational messages which are normally printed to the
standard output are suppressed and error messages are logged via syslogd instead of
being printed to the standard error output. This is often convenient when running gdc
from a shell script.
-t seconds Specifies the time in seconds which gdc will spend waiting for gated
to complete cer-
tain operations, in particular at termination and startup. By default this value is set to
10 seconds.
These additional command-line options may be present, depending on the options used to compile
gdc:
-c coresize Sets the maximum size of a core dump a gated started with gdc will produce. Useful on
systems where the default maximum core dump size is too small for gated to produce a
full core dump on errors.
-f filesize Sets the maximum file size a gated started with gdc will produce. Useful on systems
where the default maximum file dump size is too small for gated to produce a full state
dump when requested.
-m datasize Sets the maximum size of the data segment of a gated started with gdc. Useful on sys-
tems where the default data segment size is too small for gated to run.
-s stacksize Sets the maximum size of stack of a gated started with gdc. Useful on systems where
the default maximum stack size is too small for gated to run.
The following commands cause signals to be delivered to
gated for various purpose:
COREDUMP Sends an abort signal to gated, causing it to terminate with a core dump.
dump Signal gated to dump its current state into the file /usr/tmp/gated_dump.
interface Signal gated to recheck the interface configuration. gated normally does this periodi-
cally in any event, but the facility can be used to force the daemon to check interface
status immediately when changes are known to have occurred.
KILL Cause gated to terminate ungracefully. Normally useful when the daemon has hung.
reconfig Signal gated to reread its configuration file, reconfiguring its current state as appropri-
ate.
term Signal gated to terminate after shutting down all operating routing protocols gracefully.
Executing this command a second time should cause gated to terminate even if some
protocols have not yet fully shut down.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1