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 moving trace files.
SIGUSR1
signal cannot be used, if
ramd
does not enable tracing in the configuration file.
- SIGUSR2
Checks for interface changes.
On receipt of
SIGUSR2,
ramd
rescans the kernel interface list for changes.
EXAMPLES
To use an alternate configuration file for
ramd
instead of the default
/etc/ramd.conf
configuration file,
invoke
ramd
as follows:
/usr/sbin/ramd -f /tmp/sample.conf
To log tracing related information to the trace options
iflist
and
parse,
invoke
ramd
as follows :
/usr/sbin/ramd -t parse,iflist /tmp/ramd_log
ramd
logs the trace information that is related to the configuration file
and the kernel interface table, in the log file
/tmp/ramd_log.
AUTHOR
ramd
was developed by Future software Ltd.
Printable version
