1lldpad(8)                   System Manager's Manual                  lldpad(8)
2
3
4

NAME

6       lldpad - Link Layer Discovery Protocol (LLDP) agent daemon
7

SYNOPSIS

9       lldpad [-h] [-v] [-V] [-d] [-k] [-s] [-f filename]
10

DESCRIPTION

12       Executes  the LLDP protocol for supported network interfaces.  The list
13       of TLVs currently supported are:
14
15       -      IEEE 802.1AB Mandatory TLVs
16
17       -      IEEE 802.1AB Basic Management TLVs
18
19       -      IEEE 802.3 Organizationally Specific TLVs
20
21       -      LLDP-MED Organizationally Specific TLVs
22
23       -      Data Center Bridging capabilities exchange protocol (DCBX) TLVs
24
25       -      Edge Virtual Bridging (EVB) TLVs
26
27       Capabilities of lldpad include:
28
29       -      Transmission of LLDP PDUs containing enabled TLVs  from  enabled
30              ports.
31
32       -      Reception of LLDP PDUs from enabled ports.
33
34       -      Operation  of the DCBX protocol for interfaces which support the
35              DCB rtnetlink interface.  This includes operation  of  the  DCBX
36              state machines above LLDP and corresponding configuration of the
37              DCB parameters of the network interface.  Supported DCB features
38              are:  Extended Transmission Selection, Priority Flow Control and
39              the FCoE application.
40
41       -      Configuring the DCB settings of the network driver based on  the
42              operation of DCBX.
43
44       -      Provides  a  multi-channel  interface for client applications to
45              query and configure features.  Events are also generated on  the
46              client interface to inform clients of changes.  The lldpad pack‐
47              age includes two clients:  lldptool for general LLDP agent  man‐
48              agement and dcbtool for DCB management.
49
50       lldpad  supports  the  versions of the DCB capabilities exchange (DCBX)
51       protocol described here:
52
53       version 1
54              <http://download.intel.com/technology/eedc/dcb_cep_spec.pdf>
55
56       and here:
57
58       version 2 - also known as CEE DCBX
59              <http://www.ieee802.org/1/files/public/docs2008/az-wadekar-dcbx-
60              capability-exchange-discovery-protocol-1108-v1.01.pdf>
61
62       See  dcbtool  for information on how to configure which version of DCBX
63       lldpad executes.
64
65       lldpad also supports edge virtual bridging as currently under  specifi‐
66       cation      in      the      IEEE      802.1Qb      working      group.
67       <http://www.ieee802.org/1/pages/802.1bg.html>
68
69

OPTIONS

71       lldpad has the following command line options:
72
73       -h     show usage information
74
75       -f filename
76              use the specified file as the configuration file instead of  the
77              default  file:  /var/lib/lldpad/lldpad.conf  lldpad  expects the
78              directory of the configuration file to exist, but if the config‐
79              uration  file  does not exist, then a default configuration file
80              will be created.  lldpad creates and maintains the  contents  of
81              the  configuration  file.   Configuration should be performed by
82              using lldptool or dcbtool.
83
84       -d     run lldpad as a daemon
85
86       -v     show lldpad version
87
88       -V     set lldpad debugging level. Uses syslog debug  levels  see  sys‐
89              log.2 for details.
90
91       -k     used  to terminate the first instance of lldpad that was started
92              (e.g. from initrd).  Once lldpad -k has been invoked and  lldpad
93              has been restarted, subsequent invocations of lldpad -k will not
94              terminate lldpad.
95
96
97       -s     remove lldpad state records from shared memory
98
100       lldpad - LLDP agent daemon with DCBX support
101       Copyright(c) 2007-2010 Intel Corporation.    Portions  of  lldpad   are
102       based on:
103
104       hostapd-0.5.7
105
106       Copyright
107              (c) 2004-2008, Jouni Malinen <j@w1.fi>
108

LICENSE

110       This program is free software; you can redistribute it and/or modify it
111       under the terms and conditions of the GNU General Public License,  ver‐
112       sion 2, as published by the Free Software Foundation.
113
114       This  program is distributed in the hope it will be useful, but WITHOUT
115       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
116       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
117       for more details.
118
119       You should have received a copy of the GNU General Public License along
120       with this program; if not, write to the Free Software Foundation, Inc.,
121       51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
122
123       The full GNU General Public License is included in this distribution in
124       the file called "COPYING".
125

SUPPORT

127       Contact  Information: e1000-eedc Mailing List <e1000-eedc@lists.source‐
128       forge.net> Intel Corporation, 5200 N.E. Elam Young Parkway,  Hillsboro,
129       OR 97124-6497
130
131
132
133                               February 23, 2010                     lldpad(8)
Impressum