Netgate Logo Netgate Docs
  • Appliances
  • Platforms
  • Support
  • Training
latest (v25.02)
  • Introduction
  • Supported Platforms
  • Installation
  • Default Behavior
  • Zero-to-Ping: Getting Started
  • Command Line Basics
  • Basic Configuration
  • Updates and Packages
  • Interfaces
  • VPF Firewall
  • Access Lists
  • Static Routing
  • Dynamic Routing
  • ACL-Based Forwarding
  • Virtual Router Redundancy Protocol
  • IPsec
  • WireGuard
  • Tunnel Next Hops
  • Network Address Translation
  • MAP (Mapping of Address and Port)
  • Dynamic Host Configuration Protocol
  • DNS Resolver
  • Network Time Protocol
  • Link Layer Discovery Protocol
    • Configuring the LLDP Service
      • LLDP Router Configuration
      • LLDP Interface Configuration
    • LLDP Status
  • Public Key Infrastructure
  • Bidirectional Forwarding Detection
  • Unicast Reverse Path Forwarding
  • Snort® IDS/IPS
  • Authentication and User Management
  • NETCONF Access Control Model (NACM)
  • RESTCONF Server
  • Monitoring
  • TNSR Configuration Example Recipes
  • Advanced Configuration
  • Troubleshooting
  • Release Notes

References

  • Commands
  • API Endpoints
  • Glossary of Terms
  • Reference Topics
  • Licensing
TNSR
  • Docs »
  • TNSR® software

Next
Public Key Infrastructure
Previous
NTP Service Control and Status

On This Page

  • Link Layer Discovery Protocol
    • Configuring the LLDP Service
      • LLDP Router Configuration
      • LLDP Interface Configuration
    • LLDP Status

Link Layer Discovery Protocol¶

The Link Layer Discovery Protocol (LLDP) service provides a method for discovering which routers are connected to a LAN segment, and offers a way to discover the topology of a network.

Configuring the LLDP Service¶

LLDP is configured in two places: Global router parameters and per-interface parameters.

To enable LLDP, TNSR requires global settings for LLDP and at least one interface must participate in LLDP.

LLDP Router Configuration¶

Three LLDP commands are available in configuration mode (Configuration Mode) to configure global LLDP parameters for this router. All of these commands are required to activate LLDP.

lldp system-name <name>:

The router hostname advertised by LLDP.

lldp tx-interval <seconds>:

Transmit interval, which controls the time between LLDP messages in seconds.

lldp tx-hold <value>:

Transmit hold multiplier, which is multiplied by the transmit interval to calculate the total time used for the Time-To-Live (TTL) of the LLDP message.

Tip

If the transmit interval is 30 and the transmit hold multiplier is 4, then the advertised TTL of the LLDP message is 120 (4*30=120).

Warning

The LLDP timer options do not have default values and must be manually set.

Example:

tnsr(config)# lldp system-name MyRouter
tnsr(config)# lldp tx-interval 30
tnsr(config)# lldp tx-hold 4

These parameters can be changed at any time.

LLDP Interface Configuration¶

Additional LLDP commands are available in config-interface mode (Interface Command) to configure per-interface LLDP identification:

lldp port-name <name>:

The name of the interface as advertised by LLDP. This must be present on an interface for it to participate in LLDP.

lldp management (ipv4|ipv6) <ip-address>:

The IPv4 and/or IPv6 address advertised by LLDP as a means to manage this router on this interface.

lldp management oid <oid>:

An object identifier associated with the management IP address on this interface.

Warning

LLDP requires lldp port-name to be present on at least one interface to function.

Example:

tnsr(config)# interface TenGigabitEthernet3/0/0
tnsr(config-interface)# lldp port-name MyPort
tnsr(config-interface)# lldp management ipv4 192.0.2.123
tnsr(config-interface)# lldp management ipv6 2001:db8::1:2:3:4
tnsr(config-interface)# exit
tnsr(config)#

Warning

Due to a limitation of the underlying API, all LLDP interface parameters must be configured at the same time. When LLDP parameters change, TNSR requires a dataplane restart for the new settings to take effect. See Known Issues.

LLDP Status¶

LLDP status cannot be viewed natively in TNSR at this time, but the status may be obtained directly from the dataplane at the CLI using the command dataplane shell sudo vppctl show lldp:

tnsr# dataplane shell sudo vppctl show lldp
Local interface          Peer chassis ID    Remote port ID  Last heard  Last sent  Status
TenGigabitEthernet3/0/0  54:78:1a:c0:ab:80  Fa0/1           17.1s ago   25.3s ago  active

Alternately, run the command directly from a host shell prompt and not through the TNSR CLI using sudo dp-exec vppctl show lldp.

Warning

In either of these examples, the user account must have access to sudo to run the command.


Next
Public Key Infrastructure
Previous
NTP Service Control and Status
Was this page helpful?

Documentation Feedback


© 2025 Rubicon Communications LLC | Privacy Policy | Legal

This page was last updated on Jun 16 2022.

    Other Resources
  • Platforms Overview
  • TNSR Solutions
  • pfSense Solutions
  • Appliances
  • Find a Partner
  • Support Plans
  • Training
  • Professional Services
  • Blog
  • Resource Library
  • Security Information
  • About Us
  • Careers
  • Contact Us
Our Mission

We provide leading-edge network security at a fair price - regardless of organizational size or network sophistication. We believe that an open-source security model offers disruptive pricing along with the agility required to quickly address emerging threats.

Subscribe to our Newsletter

Product information, software announcements, and special offers. See our newsletter archive for past announcements.

Additional Resources v: latest (v25.02)
Languages
en
Versions
25.02
24.10
24.06
24.02
23.11
23.06
23.02
22.10
22.06
22.02
21.07
21.03
20.10
20.08
20.02
19.12
19.08
19.05
19.02

Software Documentation
pfSense
TNSR
Product Manuals