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

iosxr

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No

devices (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (iosxr.devices)

Name	Type	Constraint	Mandatory	Default Value
lldp	Class	lldp	No

lldp (iosxr.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
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	Default Value
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