unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



ospf_monitor(8)						      ospf_monitor(8)



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

  Local	Commands


  ?   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
      commands.

  x   Exits 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.

  S   Sends all	ospf_monitor output to stdout.

  Remote Commands


  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
	      request:

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

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

  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.

  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:

      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,
      and mode.

  V   Displays gated version information.

SEE ALSO

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