NAME

ospf_monitor − Monitors OSPF gateways

SYNOPSIS

/usr/sbin/ospf_monitor mon_db_file

DESCRIPTION

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. 

COMMANDS

Upon entering interactive mode, ospf_monitor presents the ’[ # ] dest command 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. 

Local Commands

?Displays all local commands and their functions. 

?RDisplays all remote commands and their functions. 

dDisplays all configured destinations.  This command displays dest_index , the IP address, and the hostname of all potential ospf_monitor command destinations configured in mon_db_file. 

hDisplays the command history buffer showing the last 30 interactive commands. 

xExits the ospf_monitor program. 

@ remote_command
Sends remote_command to the same (previous) destination. 

@dest_index remote_command
Sends remote_command to configured destination dest_index. 

F filename
Sends all ospf_monitor output to filename. 

SSends all ospf_monitor output to stdout. 

Remote Commands

a area_id type ls_id adv_rtr
Displays link state advertisement.

area_idThe OSPF area for which the query is directed. 

typeSpecifies the one of the following type of advertisement to request:

1Requests 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 originating router’s Router ID. 

2Requests 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 interface address of the network’s Designated Router. 

3Requests 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. 

4Requests 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 router. 

5Requests 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_rtrThe router-id of the router that originated this link state advertisement. 

cDisplays 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 summarized and reported as the number of intra-area routes, inter-area routes, and AS external data base entries. 

eDisplays cumulative errors.  This log reports the various error conditions which can occur between OSPF routing neighbors and shows the number of occurrences for each. 

hDisplays the next hop list.  This is a list of valid next hops mostly derived from the SPF calculation. 

l [retrans]
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. 

A [retrans]
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 printed. 

o [which]
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:

1Routes to AS border routers in this area. 

2Routes to area border routers for this area. 

4Summary routes to AS border routers in other areas. 

8Routes to networks in this area. 

16Summary routes to networks in other areas. 

32AS routes to non-OSPF networks. 

IDisplays 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. 

NDisplays all OSPF routing neighbors.  Information reported includes the area, local interface address, router ID, neighbor IP address, state, and mode. 

VDisplays gated version information. 

SEE ALSO

Commands: gated(8), gdc(8), ripquery(8), routed(8)