LLDP

LLDP operates at Layer 2 and enables network devices to advertise their identity, capabilities, and management addresses to directly connected neighbors. It is commonly used in multi-vendor environments where Cisco CDP is not available, and supports standard TLVs for system name, description, port information, and management address.

Diagram

Classes

configuration (iosxr.devices)

Name	Type	Constraint	Mandatory	Default Value
lldp	Class	`[lldp]`	No

lldp (iosxr.devices.configuration)

Name	Type	Constraint	Mandatory
chassis_id	String		No
chassis_id_type	Choice	`chassis_component`, `interface_alias`, `interface_name`, `local`, `mac_address`, `network_address`, `port_component`	No
extended_show_width_enable	Boolean	`true`, `false`	No
holdtime	Integer	min: `0`, max: `65535`	No
management_enable	Boolean	`true`, `false`	No
priorityaddr_enable	Boolean	`true`, `false`	No
reinit	Integer	min: `2`, max: `5`	No
subinterfaces_enable	Boolean	`true`, `false`	No
subinterfaces_tagged	Boolean	`true`, `false`	No
system_description	String		No
system_name	String		No
timer	Integer	min: `5`, max: `65534`	No
tlv_select	Class	`[tlv_select]`	No

tlv_select (iosxr.devices.configuration.lldp)

Name	Type	Constraint	Mandatory
management_address_disable	Boolean	`true`, `false`	No
port_description_disable	Boolean	`true`, `false`	No
system_capabilities_disable	Boolean	`true`, `false`	No
system_description_disable	Boolean	`true`, `false`	No
system_name_disable	Boolean	`true`, `false`	No

Example YAML Code:

Example-1: Tune LLDP timers for faster neighbor detection.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        lldp:
          holdtime: 180
          timer: 10
          reinit: 3

Example-2: Enable LLDP on subinterfaces and management interfaces for a provider edge router.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        lldp:
          subinterfaces_enable: true
          subinterfaces_tagged: true
          management_enable: true
          priorityaddr_enable: true

Example-3: Restrict TLV advertisements to minimize information exposure on an untrusted peering interface.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        lldp:
          tlv_select:
            system_name_disable: true
            system_description_disable: true
            system_capabilities_disable: true
            management_address_disable: true

Example-4: Override the chassis ID with a local serial number for asset tracking.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        lldp:
          system_name: router-1
          system_description: "NCS-5508-Router"
          chassis_id: FOC2249N1GH
          chassis_id_type: local