Skip to main content

network device-discovery show

Display device discovery information

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The network device-discovery show command displays information about discovered devices. This information may be useful in determining the network topology or investigating connectivity issues. By default, the command displays the following information:

  • Local interface
  • Discovered device
  • Discovered interface
  • Discovered platform

Parameters

{ [-fields <fieldname>, ...]
Include the specified field or fields in the command output. Use '-fields ?' to display the valid fields.
| [-instance ]}
Use this parameter to display detailed information about all fields.
[-node <nodename>] - Node
Displays the discovery ports that match the node name.
[-protocol {cdp|lldp}] - Protocol
Displays the devices that are discovered by the given protocol.
[-port <text>] - Port
Displays the discovery ports that match the physical network port. For example, e0a will display devices discovered on port e0a.
[-discovered-device <text>] - Discovered Device
Displays the discovered devices that match the discovered device name.
[-interface <text>] - Discovered Device Interface
Displays the discovered devices that match this interface port name. The format is dependent on the reporting device. For example: FastEthernet0/12
[-device-ip <IP Address>, ...] - Discovered Device IP Addresses
Displays the discovered devices that match the IP address(es). At present, only IPv4 addresses are included. It is recommended to use wildcards around the desired value.
[-platform <text>] - Discovered Device Platform
Displays the discovery ports that contain the platform of discovered devices. For example: N5K-C5010P-BF
[-version <text>] - Discovered Device Version
Displays the discovery ports that contain the version of discovered devices.
[-chassis-id <text>] - Discovered Device Chassis ID
Displays the discovered devices that match the chassis ID.
[-system-name <text>] - Discovered Device System Name
Displays the discovered devices that match the system name.
[-hold-time-remaining <integer>] - Discovered Device's Remaining Hold Time
Displays the discovered devices that match the remaining packet hold time in seconds. If an advertisement from the device isn't received before this time reaches zero, the entry will expire and be removed from the list. For example, "<120" will display discovered devices which will expire within the next 120 seconds.
[-capabilities {router|trans-bridge|source-route-bridge|switch|host|igmp|repeater|phone}, ...] - Discovered Device Capabilities
Displays the discovered devices that match the capability or capabilities. Possible values:
  • "router" - Router
  • "trans-bridge" - Trans Bridge
  • "source-route-bridge" - Source Route Bridge
  • "switch" - Switch
  • "host" - Host
  • "igmp" - IGMP
  • "repeater" - Repeater
  • "phone" - Phone

Examples

cluster1::> network device-discovery show

Node/ Local Discovered
Protocol Port Device Interface Platform
----------- ------ ------------------------- ---------------- ----------------
node1/cdp
e0a US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/17 N5K-C5010P-BF
e0b US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/18 N5K-C5010P-BF
e1a US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/2 N5K-C5010P-BF
node2/cdp
e0a US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/19 N5K-C5010P-BF
e0b US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/20 N5K-C5010P-BF
e1a US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/4 N5K-C5010P-BF
e1c US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/36 N5K-C5010P-BF
e1d US-LS01-5010-F11-NX.example.com(SSI142311PD)
Ethernet100/1/35 N5K-C5010P-BF
8 entries were displayed.