====
LLDP
====

.. sidebar:: Contents

  .. contents::
      :depth: 2
      :local:


This chapter covers some aspects related to the Link Layer Discovery Protocol.

**LLDP** (Link Layer Discovery Protocol) is a protocol that allows for device characteristics to be advertised in a network. This means that other devices connected
to that same network can learn about the broadcasting device (addresses, ports, vlan, etc.) by listening to packets from this protocol.

A device where **LLDP** is enabled, periodically sends information on the system over its interfaces. Additionally, it allows IP telephones to configure parameters
for other devices connected to the network.

Configuration
=============

LLDP can be configured in an interface using :osdx:cfg:`interfaces ethernet * lldp`.

In OSDx, the LLDP configuration allows various parameters to be set to fine-tune the protocol's behavior.

An explanation of each configurable parameter is provided below:

* ``voice``: Configures voice information sending to an IP telephone.

  * ``vlan``: Tells the IP telephone to tag voice traffic in the configured VLAN.

    * ``cos``: Indicates the type of layer 2 priority (Class of Service, CoS).

      * ``0``: ``best-effort``

      * ``1``: ``background``

      * ``2``: ``excellent-effort``

      * ``3``: ``critical-applications``

      * ``4``: ``video``

      * ``5``: ``voice``

      * ``6``: ``internetwork-control``

      * ``7``: ``network-control``

  * ``dscp``: Indicates the DSCP (Differentiated Service Code Point) value to be configured.

Monitoring
==========

To monitor the status and configuration of LLDP, you can use the following commands:

* :osdx:op:`interfaces ethernet * lldp show`.


.. _lldp_examples:

Examples
========

:doc:`Here </examples/interfaces/ethernet/lldp/index>` you can find examples related to LLDP.

Command Summary
===============

.. osdx:cmdtree:: cfg

    interfaces ethernet * lldp


.. osdx:cmdtree:: op
  
    interfaces ethernet * lldp