Skip to main content

network device-discovery show

Contributors
Suggest changes
PDFs

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.