{"id":6363,"date":"2026-05-04T12:10:33","date_gmt":"2026-05-04T12:10:33","guid":{"rendered":"http:\/\/docs.connexite.co.uk\/index.php\/docs\/connexite-documentation\/synapse-cli-documentation\/cli-configuring-lldp\/"},"modified":"2026-05-04T12:19:09","modified_gmt":"2026-05-04T12:19:09","slug":"cli-configuring-lldp","status":"publish","type":"docs","link":"https:\/\/docs.connexite.co.uk\/index.php\/docs\/network\/synapse-cli-documentation\/cli-configuring-lldp\/","title":{"rendered":"Configuring LLDP"},"content":{"rendered":"<h2 class=\"connexite-doc-h2\">Overview of LLDP<\/h2>\n<p>LLDP (Link Layer Discovery Protocol) provides a standard link layer discovery method, enabling devices of different manufacturers to discover each other in the network and exchange their system and configuration information. LLDP encapsulates the information of the local device (including main capabilities, management address, device identification, interface identification, etc.) in LLDPDU (Link Layer Discovery Protocol Data Unit) It is released to the neighbors directly connected to itself. After receiving the information, the neighbors save it in the form of standard MIB up for the network management system to query and judge the communication status of the link.<\/p>\n<h2 class=\"connexite-doc-h2\">LLDPDU<\/h2>\n<p>LLDPDU is a data unit encapsulated in the data part of an LLDP message. Before forming an LLDPDU, the device first encapsulates the local information into a TLV format, and then combines several TLVs into one LLDPDU and encapsulates it in the data part of the LLDP packet for transmission. Figure 1 LLDPDU encapsulation format As shown in Figure 1, the blue Chassis ID TLV, Port ID TLV, and Time To Live TLV must be carried by each LLDPDU, and the remaining TLVs are optional. Each LLDPDU can carry up to 32 TLVs.<\/p>\n<h2 class=\"connexite-doc-h2\">TLV<\/h2>\n<p>TLV is the unit that makes up LLDPDU, and each TLV represents a piece of information. The TLVs that LLDP can encapsulate include basic TLVs, 802.1 organization-defined TLVs, 802.3 organization-defined TLVs, and LLDP-MED (Link Layer Discovery Protocol Media Endpoint Discovery, Link Layer Discovery Protocol Media Endpoint Discovery) TLVs.<\/p>\n<h2 class=\"connexite-doc-h2\">Basic TLV<\/h2>\n<p>Basic TLVs are a set of TLVs that are the basis for network device management. 802.1 organization-defined TLVs, 802.3 organization-defined TLVs, and LLDP-MED TLVs are TLVs defined by standards organizations or other organizations to enhance the management of network devices. Need to choose whether to send in LLDPDU. Among the basic TLVs, there are several TLVs that are mandatory for implementing the LLDP function, that is, they must be published in the LLDPDU, as shown in Table 1. Table 1 Basic TLV<\/p>\n<h2 class=\"connexite-doc-h2\">TLV name<\/h2>\n<p>instruction Must be published Chassis ID Bridge MAC address of the sending device Yes<\/p>\n<h2 class=\"connexite-doc-h2\">Port ID<\/h2>\n<p>Identifies the port of the sender of the LLDPDU. If LLDP-MED TLV is carried in LLDPDU, its content is the MAC address of the port; otherwise, its content is the name of the port Yes Time To Live The survival time of this device information on the neighbor device Yes<\/p>\n<h2 class=\"connexite-doc-h2\">End of LLDPDU<\/h2>\n<p>The end identifier of the LLDPDU, which is the last TLV of the LLDPDU no Port Description<\/p>\n<h2 class=\"connexite-doc-h2\">Description of the port<\/h2>\n<p>no<\/p>\n<h2 class=\"connexite-doc-h2\">System Name<\/h2>\n<p>the name of the device no<\/p>\n<h2 class=\"connexite-doc-h2\">System Description<\/h2>\n<p>description of the system no System Capabilities The main functions of the system and the function items that have been turned on no Management<\/p>\n<h2 class=\"connexite-doc-h2\">Address<\/h2>\n<p>Management address, as well as the interface number and OID (Object Identifier) corresponding to the address no 802.1 Organization-Defined TLV The content of TLV defined by IEEE 802.1 organization is shown in Table2. Currently, the devices do not support sending Protocol Identity TLV and VID Usage Digest TLV, but can receive these two types of TLVs. Layer 3 Ethernet interfaces only support Link Aggregation TLVs. Table2 IEEE 802.1Organization defined TLV<\/p>\n<h2 class=\"connexite-doc-h2\">TLV name<\/h2>\n<p>instruction Port VLAN ID (PVID)<\/p>\n<h2 class=\"connexite-doc-h2\">Port VLAN ID<\/h2>\n<p>Port and protocol VLAN ID (PPVID) Port Protocol VLAN ID VLAN Name The name of the VLAN to which the port belongs Protocol Identity The type of protocol supported by the port DCBX Data Center Bridging Exchange Protocol<\/p>\n<h2 class=\"connexite-doc-h2\">EVB module<\/h2>\n<p>(Not currently supported) Edge Virtual Bridging module, including EVB TLV and CDCP (S-Channel Discovery and Configuration Protocol, S-Channel Discovery and Configuration Protocol) TLV. For the detailed introduction of these two TLVs, please refer to &quot;EVB Configuration Guide&quot; Link Aggregation Whether the port supports link aggregation and whether link aggregation is enabled<\/p>\n<h2 class=\"connexite-doc-h2\">Management VID<\/h2>\n<p>management VLAN VID Usage Digest Data containing a summary of VLAN ID usage ETS Configuration Enhanced Transmission Selection configuration ETS Recommendations Enhanced transfer selection recommendation<\/p>\n<h2 class=\"connexite-doc-h2\">PFC<\/h2>\n<p>Priority-based Flow Control APP Application Protocol<\/p>\n<h2 class=\"connexite-doc-h2\">QCN<\/h2>\n<p>(Not currently supported) Quantized Congestion Notification 802.3 Organization-Defined TLV The content of TLV defined by Table3. The Power Stateful Control TLV was defined in the IEEE P802.3at D1.0 version, and later versions no longer support this TLV. The device will only send this type of TLV after receiving the Power Stateful Control TLV. Table3 IEEE 802.3Organization defined TLV<\/p>\n<h2 class=\"connexite-doc-h2\">TLV name<\/h2>\n<p>instruction MAC\/PHY Configuration\/Status The rate and duplex status supported by the port, whether it supports port rate auto-negotiation, whether the auto-negotiation function is enabled, and the current rate and duplex status Link Aggregation Whether the port supports link aggregation and whether link aggregation is enabled<\/p>\n<h2 class=\"connexite-doc-h2\">Power Via MDI<\/h2>\n<p>The power supply capability of the port, including the type of PoE (Power over Ethernet) (including PSE (Power Sourcing Equipment) and PD (Powered Device)), the remote power supply mode of the PoE port, Whether PSE power supply is supported, whether PSE power supply is enabled, whether the power supply mode is controllable, power supply type, power source, power priority, PD requested power value, and PSE allocated power value Maximum Frame Size Maximum frame length supported by the port<\/p>\n<h2 class=\"connexite-doc-h2\">Power Stateful Control<\/h2>\n<p>Power status control of ports, including the type of power used by the PSE\/PD, the priority of supplying\/receiving power, and the power supplied\/received Energy-Efficient Ethernet<\/p>\n<h2 class=\"connexite-doc-h2\">Energy Efficient Ethernet<\/h2>\n<p>management address The management address is an address for the network management system to identify and manage network devices. The management address can clearly identify a device, which facilitates the drawing of network topology and facilitates network management. The management address is encapsulated in the Management Address TLV of the LLDP packet and advertised.<\/p>\n<h2 class=\"connexite-doc-h2\">LLDP Mode<\/h2>\n<p>Under the specified type of LLDP proxy, LLDP has the following four working modes:<\/p>\n<ul class=\"connexite-doc-list\">\n<li>TxRx: Both send and receive LLDP packets.<\/li>\n<li>Tx: Only sends and does not receive LLDP packets.<\/li>\n<li>Rx: only receives and does not send LLDP packets.<\/li>\n<li>Disable: Neither sends nor receives LLDP packets.<\/li>\n<\/ul>\n<p>When the LLDP working mode of the port changes, the port will initialize the protocol state machine. To prevent the port from continuously performing initialization operations due to frequent changes in the working mode of the port, you can configure the port initialization delay time.<\/p>\n<h2 class=\"connexite-doc-h2\">Protocol Specification<\/h2>\n<p>The protocol specifications related to LLDP are:<\/p>\n<ul class=\"connexite-doc-list\">\n<li>IEEE 802.1AB-2005: Station and Media Access Control Connectivity Discovery.<\/li>\n<li>IEEE 802.1AB 2009: Station and Media Access Control Connectivity Discovery.<\/li>\n<li>ANSI\/TIA-1057: Link Layer Discovery Protocol for Media Endpoint Devices.<\/li>\n<li>IEEE Std 802.1Qaz-2011: Media Access Control (MAC) Bridges and Virtual Bridged Local Area Networks-Amendment 18: Enhanced Transmission Selection for Bandwidth Sharing Between Traffic Classes.<\/li>\n<\/ul>\n<h2 class=\"connexite-doc-h2\">Configuring<\/h2>\n<h2 class=\"connexite-doc-h2\">Configuring Switch and Operating Mode<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Enabling\/disabling the LLDP Function Globally<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# lldp run<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# no lldp run<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Global configuration mode. Enable\/disable LLDP function. required.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# lldp -agent<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# exit<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface configuration mode. Enter the LLDP interface proxy configuration mode. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp enable { rxonly | txonly | txrx }<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp disable<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. Configure the working mode of the LLDP interface. Optional.<\/p>\n<h2 class=\"connexite-doc-h2\">Configuring Optional Basic Parameter<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Configuring System Name<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# lldp system-name NAME<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# no lldp system-name<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Global configuration mode. Configure\/reset the system name. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# lldp system-description LINE<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# no lldp system-description<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Global configuration mode. Configure \/reset system descriptors. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# lldp chassis locally-assigned NAME<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# no lldp chassis locally-assigned<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Global configuration mode. Configure\/reset the device locally-assigned . Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# lldp locally-assigned NAME<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no lldp locally-assigned<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface configuration mode. Configure\/reset the interface locally-assigned . Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# lldp agt-circuit-id VALUE<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no lldp agt-circuit-id<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface configuration mode. Configuration\/reset interfaceagt-circuit-id.can be used as a value for port-id-tlv. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# lldp port-description LINE<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no lldp port-description<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface configuration mode. Configure\/reset interface port descriptors. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp chassis-id-tlv { if-alias | if-name | ip-address | locally-assigned | mac-address }<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp chassis-id-tlv<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. Configure the device identification type of the LLDP interface. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp management-address-tlv { ip-address | mac-address }<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp management-address-tlv<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. Configure the management address type of the LLDP interface. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp port-id-tlv { agt-circuit-id | if-alias | if-name | ip-address | locally-assigned | mac-address }<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp port-id-tlv<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. Configure the port ID type of the LLDP interface. Optional.<\/p>\n<h2 class=\"connexite-doc-h2\">Configuring Optional State Machine Parameter<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Configuring the MsgTxHold Parameter of an LLDP Interface<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp msg-tx-hold &lt;1-100&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp msg-tx-hold<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. This variable is used as a multiplier for msgTxInterval to determine the value of txTTL carried in LLDP frames transmitted by the LLDP proxy.The default msgTxHold is 4. Administrators can change this value to any value in the range 1 to 100.TTL= msgTxInterval * msgTxHold + 1 . Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp tx-fast-init &lt;1-8&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp tx-fast-init<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. This variable is used as the initial value of the txFast variable. This value determines the number of LLDPDUs transmitted during the fast transmission period.The default value of txFastInit is 4. Administrators can change this value to any value between 1 and 8. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp tx-max-credit &lt;1-8&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp tx-max-credit<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. Configure the maximum value of txCredit.The default value is 5. Administrators can change this value to any value in the range 1 to 10. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp timer msg-fast-tx &lt;1-3600&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp timer msg-fast-tx<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. This variable defines the time interval of the timer interval between two transfers in a fast transfer period (i.e. txFast is not zero). The default value for msgFastTx is 1; administrators can change this value to any value between 1 and 3600. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp timer msg-tx-interval &lt;5-3600&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp timer msg-tx-interval<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. This variable defines the timer interval between normal transfers (i.e. txFast is zero). The default value for msgTxInterval is 30 s; admin can change this value to any value between5and 300. Optional.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# lldp timer reinit-delay &lt;1-10&gt;<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# no lldp timer reinit-delay<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. This parameter represents the amount of delay between when adminStatus becomes &quot;disabled&quot; and when reinitialization is attempted. The default value of reinitDelay is 2 s. Optional.<\/p>\n<h2 class=\"connexite-doc-h2\">Configuring Send Tlv List<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Configuring Tlv Selection for LLDP Interfaces<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# [ no ] lldp tlv-select basic-mgmt { management-address | port-description | system-capabilities | system-description | system-name}<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# [ no ] lldp tlv-select ieee-8021-org-specific { link-agg | mgmt-vid | port-ptcl-vlanid | port-vlanid | ptcl-identity | vid-digest | vlan-name }<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(lldp-agent)# [ no ] lldp tlv-select ieee-802 3 -org-specific { mac-phy | max-mtu-size }<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">LLDP interface proxy configuration mode. tlvs can be selected with multiple commands. Optional. Note: When there are many VLAN configurations on the device, the VLAN-related tlv may cause the packet length to exceed the MTU, resulting in packet sending errors. It is necessary to configure not to send this type of tlv.<\/p>\n<h2 class=\"connexite-doc-h2\">Examples<\/h2>\n<p>LLDP Basic Function Configuration Example<\/p>\n<h2 class=\"connexite-doc-h2\">Requirements<\/h2>\n<p>NMS (Network Management System, network management system) is connected to Switch A, and Switch A is connected to the Terminal device and Switch B respectively. By configuring the LLDP function on Switch A and Switch B, the NMS can judge the communication status of the link between Switch A and the terminal device, and between Switch A and Switch B.<\/p>\n<h2 class=\"connexite-doc-h2\">Network diagram<\/h2>\n<p>Figure2 LLDP basic function configuration network diagram<\/p>\n<h2 class=\"connexite-doc-h2\">Typical configuration example<\/h2>\n<p>Switch A\/B: Lldp run<\/p>\n<h2 class=\"connexite-doc-h2\">Display Information<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Display the Status of the LLDP Interface<\/li>\n<\/ul>\n<p>#show lldp interface gigabitEthernet0\/2 Agent Mode : Nearest bridge Enable (tx\/rx): Y\/Y Message fast transmit time:1 Message transmission interval: 30 Reinitialisation delay: 2 MED Enabled:Y Device Type: NOT_DEFINED LLDP Agent traffic statistics: Total frames transmitted: 4608 Total entries aged: 0 Total frames received: 150 Total frames received in error: 0 Total frames discarded: 0 Total discarded TLVs: 0 Total unrecognised TLVs: 0<\/p>\n<ul class=\"connexite-doc-list\">\n<li>Show LLDP Interface Neighbors<\/li>\n<\/ul>\n<p>#show lldp interface gigabitEthernet0\/2 neighbor<\/p>\n<h2 class=\"connexite-doc-h2\">Nearest bridge Neighbors<\/h2>\n<p>Interface Name : gigabitEthernet0\/2 System Name : System Description : Port Description : TTL: 3601 System Capabilities : Routing Mandatory TLVs : CHASSIS ID TYPE : Chassis MAC Address: 000e.c6c1.3841 PORT ID TYPE : Port MAC Address: 000e.c6c1.3841 8021 ORIGIN SPECIFIC TLV Port Vlan id :0 PP Vlan id :0 Remote Protocols Advertised : Remote VID Usage Digest : 0 Remote Management Vlan : 0 Link Aggregation Status : Disabled Link Aggregation Port ID : 0 8023 ORIGIN SPECIFIC TLV AutoNego Support : Supported Enabled AutoNego Capability : 1 Operational MAU Type : 0 Max Frame Size : 0 MED Capabilities : Capabilities MED Capabilities Dev Type : End Point Class-1 MED Application Type : Reserved MED Vlan id : 0 MED Tag\/Untag: Untagged MED L2 Priority : 0 MED DSCP Val : 0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Networking \u203a Switching \u203a Edge \u203a Synapse<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":6349,"menu_order":14,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[115,119,116],"class_list":["post-6363","docs","type-docs","status-publish","hentry","doc_tag-connexite","doc_tag-network","doc_tag-synapse-cli-documentation","no-post-thumbnail"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6363","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/comments?post=6363"}],"version-history":[{"count":1,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6363\/revisions"}],"predecessor-version":[{"id":6411,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6363\/revisions\/6411"}],"up":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6349"}],"wp:attachment":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/media?parent=6363"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/doc_tag?post=6363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}