Provided by: lldpad_0.9.46-3.1_i386 bug

NAME

       lldpad - Link Layer Discovery Protocol (LLDP) agent daemon

SYNOPSIS

       lldpad [-h] [-v] [-V] [-d] [-k] [-p] [-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 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     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

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)

COPYRIGHT

       lldpad - LLDP agent daemon with DCBX support
       Copyright(c)  2007-2012  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>

                                March 23, 2012                       lldpad(8)