ospf_monitor(8) ospf_monitor(8)
NAME
ospfmonitor - monitor OSPF gateways
SYNOPSIS
ospfmonitor mondbfile
DESCRIPTION
Use the ospfmonitor command to query OSPF routers. The ospfmonitor
command operates in interactive mode. It allows the user to query the
various OSPF routers to provide detailed information on IO statistics,
error logs, link-state data bases, AS external data bases, the OSPF
routing table, configured OSPF interfaces, and OSPF neighbors.
mondbfile is the complete pathname of a database composed of records
configuring destinations for ospfmonitor remote commands. Each desti-
nation record is a single-line entry which lists the destination IP
address, the destination hostname, and an OSPF authentication key (if
authentication is activated by the destination). Since authentication
keys may be present in the destination records, it is recommended that
general access to this database be restricted.
Refer to RFC-1583 (OSPF Specification, version 2) for details about
OSPF database and packet formats.
COMMANDS
Upon entering interactive mode, ospfmonitor presents the "[ # ] dest
command params >" prompt, at which you can enter any of ospfmonitor's
interactive commands. Interactive commands can be interrupted at any
time via a keyboard interrupt. Note that the command line length must
be less than 200 characters.
Local Commands
? Display all local commands and their functions.
?R Display all remote commands and their functions.
d Display all configured destinations. This command displays
destindex, the IP address, and the hostname of all potential
ospfmonitor command destinations configured in mondbfile.
h Display the command history buffer showing the last 30 interac-
tive commands.
x Exit the ospfmonitor program.
@ remotecommand
Send remotecommand to the same (previous) destination.
@destindex remotecommand
Send remotecommand to configured destination destindex.
Page 1 Reliant UNIX 5.44 Printed 11/98
ospf_monitor(8) ospf_monitor(8)
F filename
Send all ospfmonitor output to filename.
S Send all ospfmonitor output to stdout.
Remote Commands
a areaid type lsid advrtr
Display link state advertisement. areaid is the OSPF area for
which the query is directed. advrtr is the router-id of the
router which originated this link state advertisement. type
specifies the type of advertisement to request and should be
specified as follows:
1 Request the router links advertisements. They describe the
collected states of the router's interfaces. For this type of
request, the lsid field should be set to the originating
router's Router ID.
2 Request the network links advertisements. They describe the
set of routers attached to the network. For this type of
request, the lsid field should be set to the IP interface
address of the network's Designated Router.
3 Request the summary link advertisements describing routes to
networks. They describe inter-area routes, and enable the con-
densing of routing information at area borders. For this type
of request, the lsid field should be set to the destination
network's IP address.
4 Request the summary link advertisements describing routes to
AS boundary routers. They describe inter-area routes, and
enable the condensing of routing information at area borders.
For this type of request, the lsid field should be set to the
Router ID of the described AS boundary router.
5 Request the AS external link advertisements. They describe
routes to destinations external to the Autonomous System. For
this type of request, the lsid field should be set to the
destination network's IP address.
c Display cumulative log. This log includes input/output statistics
for monitor request, hello, data base description, link-state
request, link-state update, and link-state ack packets. Area
statistics are provided which describe the total number of rout-
ing neighbors and number of active OSPF interfaces. Routing table
statistics are summarized and reported as the number of intra-
area routes, inter-area routes, and AS external data base
entries.
Page 2 Reliant UNIX 5.44 Printed 11/98
ospf_monitor(8) ospf_monitor(8)
e Display cumulative errors. This log reports the various error
conditions which can occur between OSPF routing neighbors and
shows the number of occurrences for each.
h Displays the next hop list. This is a list of valid next hops
mostly derived from the SPF calculation.
l [retrans]
Display the link-state database (except for ASE's). This table
describes the routers and networks making up the AS. If retrans
is non-zero, the retransmit list of neighbors held by this lsdb
structure will be printed.
A [retrans]
Display the AS external data base entries. This table reports the
advertising router, forwarding address, age, length, sequence
number, type, and metric for each AS external route. If retrans
is non-zero, the retransmit list of neighbors held by this lsdb
structure will be printed.
o [which]
Display the OSPF routing table. This table reports the AS border
routes, area border routes, summary AS border routes, networks,
summary networks and AS external networks currently managed via
OSPF. If which is omitted, all of the above will be listed. If
specified, the value of which (between 1 and 63) specifies that
only certain tables should be displayed. The appropriate value is
determined by adding up the values for the desired tables from
the following list:
1 Routes to AS border routers in this area.
2 Routes to area border routers for this area.
4 Summary routes to AS border routers in other areas.
8 Routes to networks in this area.
16 Summary routes to networks in other areas.
32 AS routes to non-OSPF networks.
I Display all interfaces. This report shows all interfaces config-
ured for OSPF. Information reported includes the area, interface
IP address, interface type, interface state, cost, priority, and
the IP address of the DR and BDR for the network.
N Display all OSPF routing neighbors. Information reported includes
the area, local interface address, router ID, neighbor IP
address, state, and mode.
V Display gated version information.
Page 3 Reliant UNIX 5.44 Printed 11/98
ospf_monitor(8) ospf_monitor(8)
SEE ALSO
gated(1M), routed(1M), gdc(8), ripquery(8).
Page 4 Reliant UNIX 5.44 Printed 11/98