ospf_monitor - Monitors OSPF gateways
The ospf_monitor command enables you to query OSPF routers to obtain
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. The ospf_monitor command operates in interactive mode.
The Mon_db_file file is the complete pathname of a database composed of
records configuring destinations for ospf_monitor remote commands. Each
destination record is a single-line entry which lists the destination IP
address, the destination host name, 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.
Upon entering interactive mode, ospf_monitor presents the '[ # ] dest com-
mand params >' prompt, at which you can enter any of ospf_monitor's
interactive commands. Interactive commands can be interrupted at any time
by a keyboard interrupt. Note that the command line length must be less
than 200 characters.
? Displays all local commands and their functions.
?R Displays all remote commands and their functions.
d Displays all configured destinations. This command displays dest_index
, the IP address, and the hostname of all potential ospf_monitor com-
mand destinations configured in mon_db_file.
h Displays the command history buffer showing the last 30 interactive
x Exits the ospf_monitor program.
Sends remote_command to the same (previous) destination.
Sends remote_command to configured destination dest_index.
Sends all ospf_monitor output to filename.
S Sends all ospf_monitor output to stdout.
a area_id type ls_id adv_rtr
Displays link state advertisement.
area_id The OSPF area for which the query is directed.
type Specifies the one of the following type of advertisement to
1 Requests the router links advertisements. They describe
the collected states of the router's interfaces. For this
type of request, the ls_id field should be set to the ori-
ginating router's Router ID.
2 Requests the network links advertisements. They describe
the set of routers attached to the network. For this type
of request, the ls_id field should be set to the IP inter-
face address of the network's Designated Router.
3 Requests the summary link advertisements describing routes
to networks. They describe inter-area routes, and enable
the condensing of routing information at area borders. For
this type of request, the ls_id field should be set to the
destination network's IP address.
4 Requests 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 ls_id field should
be set to the Router ID of the described AS boundary
5 Requests the AS external link advertisements. They
describe routes to destinations external to the Autonomous
System. For this type of request, the ls_id field should
be set to the destination network's IP address.
adv_rtr The router-id of the router that originated this link state
c Displays 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 routing neighbors and
number of active OSPF interfaces. Routing table statistics are summar-
ized and reported as the number of intra-area routes, inter-area
routes, and AS external data base entries.
e Displays cumulative errors. This log reports the various error condi-
tions 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.
Displays 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.
Displays 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
Displays 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 Displays all interfaces. This report shows all interfaces configured
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 Displays all OSPF routing neighbors. Information reported includes the
area, local interface address, router ID, neighbor IP address, state,
V Displays gated version information.
Commands: gated(8), gdc(8), ripquery(8), routed(8)