lldpad man page

lldpad — Link Layer Discovery Protocol (LLDP) agent daemon

Synopsis

lldpad [-h] [-v] [-V level] [-d] [-k] [-p] [-s] [-t] [-f filename]

Description

Executes the LLDP protocol for supported network interfaces.  The list of TLVs currently supported are:

Capabilities of lldpad include:

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 TLVs will be transmitted when the interface comes up. lldpad can be globally configured to support one of the legacy DCBX versions (CIN or CEE).  If the remote LLDP agent does not transmit any IEEE DCBX TLVs and does transmit a legacy DCBX TLV which matches the configured legacy DCBX version, then the DCBX mode will drop back to 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 level

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

-p

do not create PID file /var/run/lldpad.pid on startup

-t

omit timestamps from logging messages

Note

On termination, lldpad does not undo any of the configurations that it has set. This approach minimizes the risk of restarting the daemon to perform a software update, or of having storage issues during shutdown. Ongoing operation of network interfaces that had been controlled by lldpad may result in unexpected behavior.

See Also

dcbtool(8), lldptool(8), lldptool-dcbx(8), lldptool-ets(8), lldptool-pfc(8), lldptool-app(8), lldptool-med(8), lldptool-vdp(8), lldptool-evb(8)

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>

Referenced By

cgdcbxd(8), dcbtool(8), fcoemon(8), liblldp_clif-vdp22(3), lldpad_selinux(8), lldptool(8), lldptool-app(8), lldptool-dcbx(8), lldptool-ets(8), lldptool-evb(8), lldptool-evb22(8), lldptool-med(8), lldptool-pfc(8), lldptool-vdp(8).

March 23, 2012