This command displays information about OSPF neighbors for the specified virtual router. If no router is specified, it displays information for the default router. If you do not specify a neighbor IP address, the output displays summary information in a table. If you specify an interface or tunnel, only the information for that interface or tunnel displays, if the interface is a physical routing interface and vlan format if the interface is a routing vlan. The ip-address is the IP address of the neighbor, and when you specify this, detailed information about the neighbor displays. The information below only displays if OSPF is enabled and the interface has a neighbor.
Format | show ip ospf neighbor [vrf vrf-name][interface {unit/slot/port|vlan 1-4093}] [ip-address] |
Mode |
|
If you do not specify an IP address, a table with the following columns displays for all neighbors or the neighbor associated with the interface that you specify:
Term | Definition |
---|---|
Router ID | The 4-digit dotted-decimal number of the neighbor router. |
Priority | The OSPF priority for the specified interface. The priority of an interface is a priority integer from 0 to 255. A value of '0' indicates that the router is not eligible to become the designated router on this network. |
IP Address | The IP address of the neighbor. |
Interface | The interface of the local router in unit/slot/port format. |
State | The state of the neighboring routers. Possible values are:
|
Dead Time | The amount of time, in seconds, to wait before the router assumes the neighbor is unreachable. |
If you specify an IP address for the neighbor router, the following fields display:
Term | Definition |
---|---|
Interface | unit/slot/port |
Neighbor IP Address | The IP address of the neighbor router. |
Interface Index | The interface ID of the neighbor router. |
Area ID | The area ID of the OSPF area associated with the interface. |
Options | An integervalue that indicates the optional OSPF capabilities supported by the neighbor. The neighbor's optional OSPF capabilities are also listed in its Hello packets. This enables received Hello Packets to be rejected (i.e., neighbor relationships will not even start to form) if there is a mismatch in certain crucial OSPF capabilities. |
Router Priority | The OSPF priority for the specified interface. The priority of an interface is a priority integer from 0 to 255. A value of '0' indicates that the router is not eligible to become the designated router on this network. |
Dead Timer Due | The amount of time, in seconds, to wait before the router assumes the neighbor is unreachable. |
Up Time | Neighbor uptime; how long since the adjacency last reached the Full state. |
State | The state of the neighboring routers. |
Events | The number of times this neighbor relationship has changed state, or an error has occurred. |
Retransmitted LSAs | The number of LSAs retransmitted to this neighbor. |
Retransmission Queue Length | An integer representing the current length of the retransmission queue of the specified neighbor router Id of the specified interface. |
Restart Helper Status | Indicates the status of this router as a helper during a graceful restart of the router specified in the command
line:
|
Restart Reason | When this router is in helpful neighbor mode, this indicates the reason for the restart as provided by the restarting
router:
|
Remaining Grace Time | The number of seconds remaining the in current graceful restart interval. This is displayed only when this router is currently acting as a helpful neighbor for the router specified in the command. |
Restart Helper Exit Reason | Indicates the reason that the specified router last exited a graceful restart.
|
Example: The following shows example CLI display output for the command.
(alpha1) #show ip ospf neighbor 170.1.1.50 Interface.....................................0/17 Neighbor IP Address...........................170.1.1.50 Interface Index...............................17 Area Id.......................................0.0.0.2 Options.......................................0x2 Router Priority...............................1 Dead timer due in (secs)......................15 Up Time.......................................0 days 2 hrs 8 mins 46 secs State.........................................Full/BACKUP-DR Events........................................4 Retransmitted LSAs............................32 Retransmission Queue Length...................0 Restart Helper Status........................ Helping Restart Reason............................... Software Restart (1) Remaining Grace Time......................... 10 sec Restart Helper Exit Reason................... In Progress