Fortinet white logo
Fortinet white logo

CLI Reference

diagnose lldprx neighbor

diagnose lldprx neighbor

Use this command to view LLDP neighbor information received on the FortiADC device. It displays details about the directly connected devices discovered via the Link Layer Discovery Protocol (LLDP) on the device’s interfaces. This information can help network administrators verify connectivity, troubleshoot physical link issues, and maintain an accurate view of the network topology.

Syntax

diagnose lldprx neighbor summary

diagnose lldprx neighbor details

summary

Displays a summary of LLDP neighbors, including the port, MAC address, chassis, port, and system information for each neighbor.

details

Displays additional metadata for each neighbor entry:

  • port.index — The index of the port that received the LLDP frame. This is used internally to identify the specific port on the device where the LLDP neighbor information was discovered.

  • port.txt —The name of the port (e.g., port1) that received the LLDP frame. This is used for reference when analyzing which interface is connected to the discovered device.

  • mac — The MAC address of the neighboring device discovered by LLDP. This address identifies the network interface on the connected device.

  • created.ticks — The number of ticks (a unit of time used internally by FortiADC) since the LLDP information was first received. This represents the timestamp in a raw format.

  • created.ago — The amount of time, in seconds, that has passed since the LLDP information was first received.

  • created.local — The local time at which the LLDP information was first received, formatted according to the local timezone.

  • created.utc — The Coordinated Universal Time (UTC) at which the LLDP information was first received, ensuring a consistent time reference.

  • expire.ticks — The number of ticks since the LLDP information will expire. This is a countdown from when the LLDP information was first received to the time it will be considered stale.

  • expire.after — The time, in seconds, remaining until the LLDP information expires. This shows the time left before the information is no longer valid.

  • expire.local — The local time at which the LLDP information will expire, formatted according to the local timezone.

  • expire.utc — The UTC time at which the LLDP information will expire, providing an international time reference.

  • updated.count — The number of times the LLDP neighbor information has been updated. This is an indicator of how frequently the LLDP information has been refreshed.

  • updated.last.ticks — The number of ticks since the last update of the LLDP neighbor information, representing the internal timestamp of the most recent update.

  • updated.last.ago — The amount of time, in seconds, that has passed since the last update of the LLDP neighbor information.

  • updated.last.local — The local time at which the LLDP neighbor information was last updated, formatted according to the local timezone.

  • updated.last.utc — The UTC time at which the LLDP neighbor information was last updated.

  • chassis.type — The type of chassis information provided by the neighboring device. A value of 4 typically indicates that the chassis information refers to the device's MAC address.

  • chassis.type.txt — A textual description of the chassis type, in this case, "interface-mac," which indicates that the chassis information is identified by the MAC address.

  • chassis.data — The actual data corresponding to the chassis type, in this case, the MAC address (00:50:56:81:74:39) of the neighbor's interface.

  • port.id.type — The type of identifier used for the port. A value of 5 usually represents that the identifier is the interface name.

  • port.id.type.txt — A textual description of the port identifier type, in this case, "interface-name," meaning the port is identified by its name.

  • port.id.len — The length of the port identifier, in this case, 5, indicating the number of characters in the interface name.

  • port.id.data — The name of the port receiving the LLDP frame (e.g., port1), used to identify the port on the local device.

  • ttl — The Time-to-Live (TTL) value in seconds, indicating how long the LLDP information is valid before it expires. This value helps prevent outdated neighbor information from being used.

  • system.name.len — The length of the system name field, indicating how many characters the system name occupies in the LLDP information.

  • system.name.data — The name of the neighboring system, in this case, FGT-TEST, which identifies the device connected via LLDP.

  • system.desc.len — The length of the system description field, which indicates how many characters the system description occupies.

  • system.desc.data — A description of the neighboring system. This may include the device type and software version, such as FortiGate-VM64 v7.4.3, build2573,240201 (GA.F).

  • system.caps.available — A bitmask representing the capabilities that the neighboring device advertises as available. In this case, 0014 indicates that the device supports both bridge and router capabilities.

  • system.caps.available.txt — A human-readable description of the available capabilities of the neighboring device, such as "bridge router."

  • system.caps.enabled — A bitmask indicating which capabilities are currently enabled on the neighboring device. Here, 0010 means the device has the router capability enabled.

  • system.caps.enabled.txt — A human-readable description of the capabilities that are currently enabled on the neighboring device, such as "router."

  • address.count — The number of IP addresses associated with the neighboring device. This helps to understand how many interfaces the device has.

  • address.1.type — The type of address associated with the neighboring device. A value of 1 corresponds to an IPv4 address.

  • address.1.type.txt — A human-readable description of the address type, in this case, "ipv4."

  • address.1.len — The length of the address in bytes. For IPv4, this value is 4.

  • address.1.addr —The actual IP address of the neighboring device, in this case, 10.106.212.100.

  • address.1.addr.interface.type — The type of interface associated with the IP address. A value of 2 refers to the interface identified by an index.

  • address.1.addr.interface.type.txt — A human-readable description of the interface type, in this case, "if-index," meaning the interface is identified by its index number.

  • address.1.addr.interface.number — The number of the interface on which the IP address is assigned. In this case, it's 1.

  • vlan.id — The VLAN ID associated with the neighboring device. A value of 0 indicates no VLAN tagging.

  • aggregation.status — The aggregation status of the interface, indicating whether link aggregation (LAG) is active. A value of 0 means there is no aggregation.

  • aggregation.status.txt — A textual description of the aggregation status, which in this case is empty, meaning aggregation is not applied.

  • aggregation.port — The port number associated with the aggregation group. In this case, the port number is 1.

Example

diagnose lldprx neighbor summary 
1 port 'port1' 4  mac 00:50:56:81:74:39  chassis 00:50:56:81:74:39 port 'port1' system 'FGT-TEST'
2 port 'port1' 4  mac 00:50:56:81:77:54  chassis 00:50:56:81:77:54 port 00:50:56:81:77:54 system 'ubuntu-20'
3 port 'port1' 4  mac 00:50:56:81:FF:A9  chassis 00:50:56:81:FF:A9 port 'port1' system 'ADC-212-8'
4 port 'port1' 4  mac 00:50:56:81:07:FE  chassis 00:50:56:81:07:FE port 'port1' system 'ADC-212-1'
5 port 'port1' 4  mac 00:50:56:81:FF:7A  chassis 00:50:56:81:FF:7A port 'port1' system 'ADC-122-5'
6 port 'port2' 7  mac 00:50:56:81:5D:FB  chassis 00:50:56:81:77:54 port 00:50:56:81:5D:FB system 'ubuntu-20'
7 port 'port2' 7  mac 00:50:56:81:8F:93  chassis 00:50:56:81:FF:A9 port 'port2' system 'ADC-212-8'
8 port 'port2' 7  mac 00:50:56:81:B9:0F  chassis 00:50:56:81:FF:7A port 'port2' system 'ADC-122-5'
9 port 'port6' 8  mac 00:50:56:81:D0:96  chassis 00:50:56:81:FF:A9 port 'port6' system 'ADC-212-8'
10 port 'port6' 8  mac 00:50:56:81:F4:20  chassis 00:50:56:81:FF:7A port 'port6' system 'ADC-122-5'
11 port 'port10' 9  mac 00:50:56:81:6B:B7  chassis 00:50:56:81:FF:A9 port 'port10' system 'ADC-212-8'
12 port 'port3' 10  mac 00:50:56:81:7A:5E  chassis 00:50:56:81:74:39 port 'port3' system 'FGT-TEST'
13 port 'port3' 10  mac 00:50:56:81:C8:09  chassis 00:50:56:81:FF:A9 port 'port3' system 'ADC-212-8'
14 port 'port3' 10  mac 00:50:56:81:AF:B2  chassis 00:50:56:81:07:FE port 'port3' system 'ADC-212-1'
15 port 'port8' 13  mac 00:50:56:81:37:1F  chassis 00:50:56:81:FF:7A port 'port8' system 'ADC-122-5'
diagnose lldprx neighbor details
1 port.index: 4
1 port.txt: port1
1 mac: 00:50:56:81:74:39
1 created.ticks: 8158600
1 created.ago: 105277
1 created.local: 2025-04-03 14:55:34 -0700
1 created.utc: 2025-04-03 21:55:34
1 expire.ticks: 18697900
1 expire.after: 116
1 expire.local: 2025-04-04 20:12:07 -0700
1 expire.utc: 2025-04-05 03:12:07
1 updated.count: 3510
1 updated.last.ticks: 18685900
1 updated.last.ago: 4
1 updated.last.local: 2025-04-04 20:10:07 -0700
1 updated.last.utc: 2025-04-05 03:10:07
1 chassis.type: 4
1 chassis.type.txt: interface-mac
1 chassis.data: 00:50:56:81:74:39
1 port.id.type: 5
1 port.id.type.txt: interface-name
1 port.id.len: 5
1 port.id.data: port1
1 ttl: 120
1 system.name.len: 8
1 system.name.data: FGT-TEST
1 system.desc.len: 45
1 system.desc.data: FortiGate-VM64 v7.4.3,build2573,240201 (GA.F)
1 system.caps.available: 0014
1 system.caps.available.txt: bridge router
1 system.caps.enabled: 0010
1 system.caps.enabled.txt: router
1 address.count: 1
1 address.1.type: 1
1 address.1.type.txt: ipv4
1 address.1.len: 4
1 address.1.addr: 10.106.212.100
1 address.1.addr.interface.type: 2
1 address.1.addr.interface.type.txt: if-index
1 address.1.addr.interface.number: 1
1 vlan.id: 0
1 aggregation.status: 0
1 aggregation.status.txt:
1 aggregation.port: 1

diagnose lldprx neighbor

diagnose lldprx neighbor

Use this command to view LLDP neighbor information received on the FortiADC device. It displays details about the directly connected devices discovered via the Link Layer Discovery Protocol (LLDP) on the device’s interfaces. This information can help network administrators verify connectivity, troubleshoot physical link issues, and maintain an accurate view of the network topology.

Syntax

diagnose lldprx neighbor summary

diagnose lldprx neighbor details

summary

Displays a summary of LLDP neighbors, including the port, MAC address, chassis, port, and system information for each neighbor.

details

Displays additional metadata for each neighbor entry:

  • port.index — The index of the port that received the LLDP frame. This is used internally to identify the specific port on the device where the LLDP neighbor information was discovered.

  • port.txt —The name of the port (e.g., port1) that received the LLDP frame. This is used for reference when analyzing which interface is connected to the discovered device.

  • mac — The MAC address of the neighboring device discovered by LLDP. This address identifies the network interface on the connected device.

  • created.ticks — The number of ticks (a unit of time used internally by FortiADC) since the LLDP information was first received. This represents the timestamp in a raw format.

  • created.ago — The amount of time, in seconds, that has passed since the LLDP information was first received.

  • created.local — The local time at which the LLDP information was first received, formatted according to the local timezone.

  • created.utc — The Coordinated Universal Time (UTC) at which the LLDP information was first received, ensuring a consistent time reference.

  • expire.ticks — The number of ticks since the LLDP information will expire. This is a countdown from when the LLDP information was first received to the time it will be considered stale.

  • expire.after — The time, in seconds, remaining until the LLDP information expires. This shows the time left before the information is no longer valid.

  • expire.local — The local time at which the LLDP information will expire, formatted according to the local timezone.

  • expire.utc — The UTC time at which the LLDP information will expire, providing an international time reference.

  • updated.count — The number of times the LLDP neighbor information has been updated. This is an indicator of how frequently the LLDP information has been refreshed.

  • updated.last.ticks — The number of ticks since the last update of the LLDP neighbor information, representing the internal timestamp of the most recent update.

  • updated.last.ago — The amount of time, in seconds, that has passed since the last update of the LLDP neighbor information.

  • updated.last.local — The local time at which the LLDP neighbor information was last updated, formatted according to the local timezone.

  • updated.last.utc — The UTC time at which the LLDP neighbor information was last updated.

  • chassis.type — The type of chassis information provided by the neighboring device. A value of 4 typically indicates that the chassis information refers to the device's MAC address.

  • chassis.type.txt — A textual description of the chassis type, in this case, "interface-mac," which indicates that the chassis information is identified by the MAC address.

  • chassis.data — The actual data corresponding to the chassis type, in this case, the MAC address (00:50:56:81:74:39) of the neighbor's interface.

  • port.id.type — The type of identifier used for the port. A value of 5 usually represents that the identifier is the interface name.

  • port.id.type.txt — A textual description of the port identifier type, in this case, "interface-name," meaning the port is identified by its name.

  • port.id.len — The length of the port identifier, in this case, 5, indicating the number of characters in the interface name.

  • port.id.data — The name of the port receiving the LLDP frame (e.g., port1), used to identify the port on the local device.

  • ttl — The Time-to-Live (TTL) value in seconds, indicating how long the LLDP information is valid before it expires. This value helps prevent outdated neighbor information from being used.

  • system.name.len — The length of the system name field, indicating how many characters the system name occupies in the LLDP information.

  • system.name.data — The name of the neighboring system, in this case, FGT-TEST, which identifies the device connected via LLDP.

  • system.desc.len — The length of the system description field, which indicates how many characters the system description occupies.

  • system.desc.data — A description of the neighboring system. This may include the device type and software version, such as FortiGate-VM64 v7.4.3, build2573,240201 (GA.F).

  • system.caps.available — A bitmask representing the capabilities that the neighboring device advertises as available. In this case, 0014 indicates that the device supports both bridge and router capabilities.

  • system.caps.available.txt — A human-readable description of the available capabilities of the neighboring device, such as "bridge router."

  • system.caps.enabled — A bitmask indicating which capabilities are currently enabled on the neighboring device. Here, 0010 means the device has the router capability enabled.

  • system.caps.enabled.txt — A human-readable description of the capabilities that are currently enabled on the neighboring device, such as "router."

  • address.count — The number of IP addresses associated with the neighboring device. This helps to understand how many interfaces the device has.

  • address.1.type — The type of address associated with the neighboring device. A value of 1 corresponds to an IPv4 address.

  • address.1.type.txt — A human-readable description of the address type, in this case, "ipv4."

  • address.1.len — The length of the address in bytes. For IPv4, this value is 4.

  • address.1.addr —The actual IP address of the neighboring device, in this case, 10.106.212.100.

  • address.1.addr.interface.type — The type of interface associated with the IP address. A value of 2 refers to the interface identified by an index.

  • address.1.addr.interface.type.txt — A human-readable description of the interface type, in this case, "if-index," meaning the interface is identified by its index number.

  • address.1.addr.interface.number — The number of the interface on which the IP address is assigned. In this case, it's 1.

  • vlan.id — The VLAN ID associated with the neighboring device. A value of 0 indicates no VLAN tagging.

  • aggregation.status — The aggregation status of the interface, indicating whether link aggregation (LAG) is active. A value of 0 means there is no aggregation.

  • aggregation.status.txt — A textual description of the aggregation status, which in this case is empty, meaning aggregation is not applied.

  • aggregation.port — The port number associated with the aggregation group. In this case, the port number is 1.

Example

diagnose lldprx neighbor summary 
1 port 'port1' 4  mac 00:50:56:81:74:39  chassis 00:50:56:81:74:39 port 'port1' system 'FGT-TEST'
2 port 'port1' 4  mac 00:50:56:81:77:54  chassis 00:50:56:81:77:54 port 00:50:56:81:77:54 system 'ubuntu-20'
3 port 'port1' 4  mac 00:50:56:81:FF:A9  chassis 00:50:56:81:FF:A9 port 'port1' system 'ADC-212-8'
4 port 'port1' 4  mac 00:50:56:81:07:FE  chassis 00:50:56:81:07:FE port 'port1' system 'ADC-212-1'
5 port 'port1' 4  mac 00:50:56:81:FF:7A  chassis 00:50:56:81:FF:7A port 'port1' system 'ADC-122-5'
6 port 'port2' 7  mac 00:50:56:81:5D:FB  chassis 00:50:56:81:77:54 port 00:50:56:81:5D:FB system 'ubuntu-20'
7 port 'port2' 7  mac 00:50:56:81:8F:93  chassis 00:50:56:81:FF:A9 port 'port2' system 'ADC-212-8'
8 port 'port2' 7  mac 00:50:56:81:B9:0F  chassis 00:50:56:81:FF:7A port 'port2' system 'ADC-122-5'
9 port 'port6' 8  mac 00:50:56:81:D0:96  chassis 00:50:56:81:FF:A9 port 'port6' system 'ADC-212-8'
10 port 'port6' 8  mac 00:50:56:81:F4:20  chassis 00:50:56:81:FF:7A port 'port6' system 'ADC-122-5'
11 port 'port10' 9  mac 00:50:56:81:6B:B7  chassis 00:50:56:81:FF:A9 port 'port10' system 'ADC-212-8'
12 port 'port3' 10  mac 00:50:56:81:7A:5E  chassis 00:50:56:81:74:39 port 'port3' system 'FGT-TEST'
13 port 'port3' 10  mac 00:50:56:81:C8:09  chassis 00:50:56:81:FF:A9 port 'port3' system 'ADC-212-8'
14 port 'port3' 10  mac 00:50:56:81:AF:B2  chassis 00:50:56:81:07:FE port 'port3' system 'ADC-212-1'
15 port 'port8' 13  mac 00:50:56:81:37:1F  chassis 00:50:56:81:FF:7A port 'port8' system 'ADC-122-5'
diagnose lldprx neighbor details
1 port.index: 4
1 port.txt: port1
1 mac: 00:50:56:81:74:39
1 created.ticks: 8158600
1 created.ago: 105277
1 created.local: 2025-04-03 14:55:34 -0700
1 created.utc: 2025-04-03 21:55:34
1 expire.ticks: 18697900
1 expire.after: 116
1 expire.local: 2025-04-04 20:12:07 -0700
1 expire.utc: 2025-04-05 03:12:07
1 updated.count: 3510
1 updated.last.ticks: 18685900
1 updated.last.ago: 4
1 updated.last.local: 2025-04-04 20:10:07 -0700
1 updated.last.utc: 2025-04-05 03:10:07
1 chassis.type: 4
1 chassis.type.txt: interface-mac
1 chassis.data: 00:50:56:81:74:39
1 port.id.type: 5
1 port.id.type.txt: interface-name
1 port.id.len: 5
1 port.id.data: port1
1 ttl: 120
1 system.name.len: 8
1 system.name.data: FGT-TEST
1 system.desc.len: 45
1 system.desc.data: FortiGate-VM64 v7.4.3,build2573,240201 (GA.F)
1 system.caps.available: 0014
1 system.caps.available.txt: bridge router
1 system.caps.enabled: 0010
1 system.caps.enabled.txt: router
1 address.count: 1
1 address.1.type: 1
1 address.1.type.txt: ipv4
1 address.1.len: 4
1 address.1.addr: 10.106.212.100
1 address.1.addr.interface.type: 2
1 address.1.addr.interface.type.txt: if-index
1 address.1.addr.interface.number: 1
1 vlan.id: 0
1 aggregation.status: 0
1 aggregation.status.txt:
1 aggregation.port: 1