15.7. LLDP Commands

Command Purpose

To enable LLDP function globally, use the lldp enable command in global configuration mode. To disable this function, use the no form of this command.

Prerequisites

Command Syntax

lldp enable

lldp disable

Command Mode

Global Config

Default

Disable

Usage

None

Examples

The following example shows how to enable LLDP globally:

Switch# configure terminal
Switch(config)# lldp enable

Related Commands

lldp enable(interface)

Command Purpose

To enable LLDP function on interface, use the lldp enable command in interface configuration mode. To disable this function, use the no form of this command.

Prerequisites

Command Syntax

lldp enable ( txonly | txrx | rxonly )

lldp disable

Command Mode

Interface Configuration

Default

Enable

Usage

None

Examples

The following example shows how to enable LLDP on interface:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp enable txrx

Related Commands

lldp enable(global)

Command Purpose

To configure system name for System Name TLV, use the lldp system-name command in Global Config mode. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp system-name NAME

no lldp system-name

Command Mode

Global Config

Default

Default system name is used.

Usage

If no system name is configured, the default system name will be used.

Examples

The following example shows how to configure system name:

Switch# configure terminal
Switch(config)# lldp system-name switch

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure system description for System Description TLV, use the lldp system- description command in Global Config mode. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp system-description LINE

no lldp system-description

Command Mode

Global Config

Default

Default system description is used.

Usage

If no system description is configured, the default system description will be used.

Examples

The following example shows how to configure system description:

Switch# configure terminal
Switch(config)# lldp system-description switch

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure management ip address for Management Address TLV, use the lldp management ip command in Global Config mode. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp management ( ip ADDRESS | interface IFNAME )

no lldp management ( ip | interface )

Command Mode

Global Config

Default

Default management address is used.

Usage

The configured IP address has higher priority than configured interface.If both of themare not be configured, system should use the loopbackinterface, management interface , other interface or system MAC address according descend order of priority.

Examples

The following example shows how to configure the management ip address:

Switch# configure terminal
Switch(config)# lldp management ip 192.168.1.2

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure msg-tx-hold, use the lldp msg-tx-hold command in global configuration. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp msg-tx-hold NUMBER

no lldp msg-tx-hold

Command Mode

Global Config

Default

The default value of msg-tx-hold is 4.

Usage

None

Examples

The following example shows how to configure msg-tx-hold:

Switch# configure terminal
Switch(config)# lldp msg-tx-hold 3

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure msg-tx-interval, use the lldp timer msg-tx-interval command in Global Config. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp timer msg-tx-interval NUMBER

no lldp timer msg-tx-interval

Command Mode

Global Config

Default

The default value of msg-tx-interval is 30s.

Usage

None

Examples

The following example shows how to configure msg-tx-interval:

Switch# configure terminal
Switch(config)# lldp timer msg-tx-interval 20

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure reinitDelay, use the lldp timer reinitDelay command in Global Config. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp timer reinit-delay NUMBER

no lldp timer reinit-delay

Command Mode

Global Config

Default

The default value of reinitDelay is 2s.

Usage

None

Examples

The following example shows how to configure reinitDelay:

Switch# configure terminal
Switch(config)# lldp timer reinit-delay 1

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure tx-delay, use the lldp timer tx-delay command in global configuration. To restore the default configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp timer tx-delay NUMBER

no lldp timer tx-delay

Command Mode

Global Config

Default

The default value of tx-delay is 2s.

Usage

The value of tx-delay should obey the formula: 1 <= tx-delay <= ((0.25)* msg-tx-interval.

Examples

The following example shows how to configure tx-delay:

Switch# configure terminal
Switch(config)# lldp timer tx-delay 3

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To select the basic tlv used in LLDP packet, use the lldp tlv basic command in interface configuration. To cancel the tlv, use the no form of this command…

Prerequisites

Command Syntax

lldp tlv basic { port-description | system-name | system-description | system-capabilities | management-address | all }

no lldp tlv basic { port-description | system-name | system-description | system-capabilities | management-address | all }

Command Mode

Interface Configuration

Default

All basic tlvs is selected.

Usage

None

Examples

The following example shows how to select basic tlv:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv basic system-name

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To select the IEEE 802.1 tlvs used in LLDP packet, use the lldp tlv 8021-org-specific command in interface configuration. To cancel the tlv, use the no form of this command…

Prerequisites

Command Syntax

lldp tlv 8021-org-specific { port-vlan | protocol-vlan | vlan-name | protocol-id | link-aggregation | dcbx | all }

no lldp tlv 8021-org-specific { port-vlan | protocol-vlan | vlan-name | protocol-id | link-aggregation | dcbx | all }

Command Mode

Interface Configuration

Default

All IEEE 802.1 tlvs is selected, exclude Link Aggregation Tlv.

Usage

Link Aggregation Tlv in IEEE 802.3 tlv set is used by default.

Examples

The following example shows how to select IEEE 802.1 tlv:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv 8021-org-specific vlan-name

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To configure the value forVLAN NAME TLV in the IEEE 802.1 tlvs, use the lldp tlv 8021-org-specific vlan-name-value command in interface configuration. To cancel the configuration, use the no form of this command.

Prerequisites

Command Syntax

lldp tlv 8021-org-specific vlan-name-value VLAN_ID

no lldp tlv 8021-org-specific vlan-name-value

Command Mode

Interface Configuration

Default

The VLAN NAME TLV will contain the information of native vlan.

Usage

None

Examples

The following example shows how to configure VLAN NAME TLV:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv 8021-org-specific vlan-name-value 2000

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To select the IEEE 802.3 tlvs used in LLDP packet, use the lldp tlv 8023-org-specific command in interface configuration. To cancel the tlv, use the no form of this command.

Prerequisites

Command Syntax

lldp tlv 8023-org-specific { mac-phy-cfg | power | link-aggregation | max-frame-size | all }

no lldp tlv 8023-org-specific { mac-phy-cfg | power | link-aggregation | max-frame-size | all }

Command Mode

Interface Configuration

Default

All IEEE 802.3 tlvs is selected.

Usage

Link Aggregation Tlv in IEEE 802.3 tlv set is used by default.

Examples

The following example shows how to select IEEE 802.3 tlv:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv 8023-org-specific power

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To select the MED tlvs used in LLDP packet, use the lldp tlv med command in interface configuration. To cancel the tlv, use the no form of this command.

Prerequisites

Command Syntax

lldp tlv med { network-policy | ext-power | inventory | all }

no lldp tlv med { network-policy | ext-power | inventory | all }

Command Mode

Interface Configuration

Default

All MED tlvs is selected, exclude Location Identification Tlv.

Usage

LLDP-MED Capabilities TLV will be added automatically when any other tlv in MED tlv set was selected, and canceled when no other MED tlv except itself was selected.

Examples

The following example shows how to select MED tlv:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv med inventory

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To select and configure the MED Location-id tlv used in LLDP packet, use the lldp tlv med location-id command in interface configuration. To cancel the tlv, use the no form of this command.

Prerequisites

Command Syntax

lldp tlv med location-id ( ecs-elin VALUE | civic DEV-TYPE CODE CA1-TYPE CA1-VALUE ( CA2-TYPE CA2-VALUE ( CA3-TYPE CA3-VALUE ( CA4-TYPE CA4-VALUE ( CA5-TYPE CA5-VALUE ( CA6-TYPE CA6-VALUE ( CA7-TYPE CA7-VALUE ( CA8-TYPE CA8-VALUE ( CA9-TYPE CA9-VALUE ( CA10-TYPE CA10-VALUE | ) | ) | ) | ) | ) | ) | ) | ) | ) )

no lldp tlv med location-id

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

The following example shows how to configure MED location-id tlv:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# lldp tlv med location-id ecs-elin 1234567890

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

Use this command to turn on the debug switches of LLDP module.

To restore the default, use the no form of this command

Prerequisites

Command Syntax

debug lldp ( events | packet | all | tlv-info )

no debug lldp ( events | packet | all | tlv-info )

Command Mode

Privileged EXEC

Default

None

Usage

Use command “terminal monitor” to make debug messages print on the VTY immediately.

Use command “show logging buffer” to check the debug messages in the logging buffer.

Examples

The following is sample to open lldp debug switches:

Switch# debug lldp all

Related Commands

terminal monitor

show logging buffer

Command Purpose

To display the LLDP local information, use the show lldp local command in privileged EXEC mode.

Prerequisites

Command Syntax

show lldp local ( config | tlv-info ) ( interface IFNAME | )

Command Mode

Privileged EXEC

Default

None

Usage

If interface is not specified, this command will display the global information of LLDP.

Examples

The following example shows how to display LLDP configuration:

Switch# show lldp local config

LLDP global configuration: 
============================================================
LLDP function global enabled : NO
LLDP msgTxHold     : 4
LLDP msgTxInterval : 30
LLDP reinitDelay   : 2
LLDP txDelay       : 2
Switch# show lldp local config interface eth-0-4
LLDP configuration on interface eth-0-4 :
============================================================
LLDP admin status : Disabled
Basic optional TLV Enabled:
    Port Description TLV
    System Name TLV
    System Description TLV
    System Capabilities TLV
    Management Address TLV
IEEE 802.1 TLV Enabled:
    Port Vlan ID TLV
    Port and Protocol Vlan ID TLV
    Vlan Name TLV
    Protocol Identity TLV
IEEE 802.3 TLV Enabled:
    MAC/PHY Configuration/Status TLV
    Power Via MDI TLV
    Link Aggregation TLV
    Maximum Frame Size TLV
LLDP-MED TLV Enabled:
    Med Capabilities TLV
    Network Policy TLV
    Extended Power-via-MDI TLV
    Inventory TLV

Related Commands

lldp enable(global)

lldp enable(interface)

lldp tlv basic

lldp tlv med

lldp tlv 8023-org-specific

lldp tlv 8021-org-specific

lldp msg-tx-hold

lldp timer msg-tx-interval

lldp timer reinitDelay

lldp timer tx-delay

Command Purpose

To display LLDP neighbor information, use the show lldp neighbor command in privileged EXEC mode.

Prerequisites

Command Syntax

show lldp neighbor ( interface IFNAME | ) ( brief | )

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to display the LLDP neighbor information.

Examples

The following example shows how to display LLDP neighbor information:

Switch# show lldp neighbor interface eth-0-4 brief

Local Port  : eth-0-4
Remote Port : eth-0-6
Hold Time   : 120
Expire Time : 116
System Name : switch
------------------------------------------------------------

Related Commands

lldp enable(global)

lldp enable(interface)

Command Purpose

To display the statistics of LLDP packets, use the show lldp statistics command in privileged EXEC mode.

Prerequisites

Command Syntax

show lldp statistics ( interface IFNAME | )

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to display detail LLDP statistics.

Examples

The following example shows how to display LLDP statistics:

Switch# show lldp statistics interface eth-0-4

LLDP statistics information:
============================================================
LLDP Port statistics for eth-0-4
Frames transmitted: 568
Frames Aged out: 0
Frames Discarded: 0
Frames with Error: 0
Frames Recieved: 364
TLVs discarded: 0
TLVs unrecognized: 0

Related Commands

clear lldp statistics

Command Purpose

To reset the statistics of LLDP packets , use the clear lldp statistics command in privileged EXEC mode.

Prerequisites

Command Syntax

clear lldp statistics ( interface IFNAME | )

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to reset LLDP statistics.

Examples

The following example shows how to clear LLDP statistics:

Switch# clear lldp statistics

Related Commands

show lldp statistics