NAME¶
lldpad - Link Layer Discovery Protocol (LLDP) agent daemon
SYNOPSIS¶
lldpad [-h] [-v] [-V] [-d] [-k] [-s]
[-f filename]
DESCRIPTION¶
Executes the LLDP protocol for supported network interfaces. The list of TLVs
currently supported are:
- -
- IEEE 802.1AB Mandatory TLVs
- -
- IEEE 802.1AB Basic Management TLVs
- -
- IEEE 802.3 Organizationally Specific TLVs
- -
- LLDP-MED Organizationally Specific TLVs
- -
- Data Center Bridging capabilities exchange protocol (DCBX)
TLVs
- -
- Edge Virtual Bridging (EVB) TLVs
Capabilities of
lldpad include:
- -
- Transmission of LLDP PDUs containing enabled TLVs from
enabled ports.
- -
- Reception of LLDP PDUs from enabled ports.
- -
- Operation of the DCBX protocol for interfaces which support
the DCB rtnetlink interface. This includes operation of the DCBX state
machines above LLDP and corresponding configuration of the DCB parameters
of the network interface. Supported DCB features are: Extended
Transmission Selection, Priority Flow Control and the FCoE
application.
- -
- Configuring the DCB settings of the network driver based on
the operation of DCBX.
- -
- Provides a multi-channel interface for client applications
to query and configure features. Events are also generated on the client
interface to inform clients of changes. The lldpad package includes two
clients: lldptool for general LLDP agent management and dcbtool for DCB
management.
lldpad supports the versions of the DCB capabilities exchange (DCBX)
protocol listed as follows:
- version 1 - also known as CIN DCBX
- <http://download.intel.com/technology/eedc/dcb_cep_spec.pdf>
- version 2 - also known as CEE DCBX
- <http://www.ieee802.org/1/files/public/docs2008/az-wadekar-dcbx-capability-exchange-discovery-protocol-1108-v1.01.pdf>
- IEEE DCBX
- See the IEEE 802.1Qaz-2011 specification for details.
IEEE DCBX is the default DCBX mode for a DCB capable interface so the default
and configured IEEE DCBX TLV's will be transmitted when the interface comes
up. If the remote LLDP agent does not transmit any IEEE DCBX TLV's and does
transmit a legacy DCBX (CEE or CIN) TLV, then the DCBX mode will drop back to
the locally configured legacy DCBX mode. It will not transition back to IEEE
DCBX mode until the next link reset. If
lldpad has dropped back to
legacy DCBX mode for a given interface and the daemon is stopped and
restarted, the legacy DCBX mode for that interface will be used instead of
starting out in IEEE DCBX mode. This behavior only applies to the case where
lldpad is restarted and is not persistent across a system reboot.
See
dcbtool for information on how to globally configure which legacy
version of DCBX
lldpad executes.
See
lldptool for information on how to reset the DCBX mode of an
interface back to default (starts out in IEEE DCBX mode).
lldpad also supports edge virtual bridging as currently under
specification in the IEEE 802.1Qb working group.
<
http://www.ieee802.org/1/pages/802.1bg.html>
OPTIONS¶
lldpad has the following command line options:
- -h
- show usage information
- -f filename
- use the specified file as the configuration file instead of
the default file: /var/lib/lldpad/lldpad.conf lldpad expects the
directory of the configuration file to exist, but if the configuration
file does not exist, then a default configuration file will be created.
lldpad creates and maintains the contents of the configuration file.
Configuration should be performed by using lldptool or dcbtool.
- -d
- run lldpad as a daemon
- -v
- show lldpad version
- -V
- set lldpad debugging level. Uses syslog debug levels see
syslog.2 for details.
- -k
- used to terminate the first instance of lldpad that was
started (e.g. from initrd). Once lldpad -k has been invoked and lldpad has
been restarted, subsequent invocations of lldpad -k will not terminate
lldpad.
- -s
- remove lldpad state records from shared memory
COPYRIGHT¶
lldpad - LLDP agent daemon with DCBX support
Copyright(c) 2007-2011 Intel Corporation. Portions of lldpad are based on:
- hostapd-0.5.7
- Copyright
- (c) 2004-2008, Jouni Malinen <j@w1.fi>
LICENSE¶
This program is free software; you can redistribute it and/or modify it under
the terms and conditions of the GNU General Public License, version 2, as
published by the Free Software Foundation.
This program is distributed in the hope it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
St - Fifth Floor, Boston, MA 02110-1301 USA.
The full GNU General Public License is included in this distribution in the file
called "COPYING".
SUPPORT¶
Contact Information: open-lldp Mailing List
<lldp-devel@open-lldp.org>