ramd.1m (2010 09)

r
ramd(1M) ramd(1M)
NAME
ramd - Route Administration Manager Daemon (RAMD) for IPv6
SYNOPSIS
/usr/sbin/ramd
[-C][-N][-c][-f
config_file ][-n][-q][-t trace_options][trace_file ]
DESCRIPTION
ramd is a routing daemon that manages routing for IPv6.
ramd handles RIPng, BGP, and IS-IS routing
protocols.
ripngd, bgpd, and isisd are referred to as routing daemons.
ramd can be configured using the configuration file
/etc/ramd.conf
. Upon startup, ramd reads the
configuration file and spawns the routing daemons, if it is configured. However, the command-line option
trace_file is applicable only to
ramd
.
ramd maintains a routing table in user space and synchronizes it with the HP-UX kernel routing table.
ramd periodically checks the kernel interface table and the route table for any updates or changes. It
notifies the corresponding daemons about the updates.
Options
ramd supports the following command-line options:
-C Parses the configuration file for syntax errors and terminates
ramd. ramd exits
with a status 0 if the configuration file contains no errors. If the configuration file
contains errors,
ramd exits with a non-zero value. ramd prints the configuration
file errors, if any, to the standard output.
-N Specifies that ramd runs as a normal process and not as a daemon process.
-c Parses the configuration file for syntax errors and terminates
ramd. It leaves a
dump file,
/var/tmp/ramd/ramd.dump
, if the configuration file does not have
any syntax errors.
-f config_file Specifies an alternate configuration file to be used by ramd
. By default, ramd uses
/etc/ramd.conf.
-n Specifies that ramd does not modify the kernel forwarding table.
-q Suppresses the stderr messages of ramd and routing daemons. Using this
option, ramd can suppress the informational messages that are normally printed to
the standard output, and log error messages through syslogd (1M). By default,
syslog errors are logged in /var/adm/syslog/syslog.log
.
-t trace_options Specifies a comma-separated list of trace options to be enabled during startup. A
space cannot be entered between this option and its arguments.
This option can be used to trace events that occur before the configuration file is
parsed, such as determining the interface configuration and reading routes from the
kernel.
See the ramd.conf (4) manpage for information on tracing and valid trace options.
The trace options,
no, cannot be specified with the -t command-line option.
trace_file Specifies the name of the file used by the daemon to log tracing information.
Signal Processing
The following signals are used to control
ramd:
SIGHUP Specifies ramd to reread the configuration file. ramd reads the configuration file and
reconfigures its policies. ramd also checks if it must start and stop the protocol daemons.
SIGINT Specifies that the current state of ramd is written to /var/tmp/ramd/ramd.dump.
SIGTERM Graceful shutdown. On receipt of SIGTERM, ramd attempts a graceful shutdown.
ramd removes all protocol routes from the HP-UX 11i v1 kernel routing table on receiving
SIGTERM. Interface routes and static routes remain with the retain option. SIGKILL can
be used to terminate ramd with all the routes intact. It may be necessary to repeat the
SIGTERM once or twice if ramd delays its termination.
SIGUSR1 Toggle tracing. If tracing is enabled, ramd suspends tracing and closes the trace file. If
tracing is disabled, ramd opens the trace file and initiates tracing. This is useful for
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1