3 + Interface names are also matched for management addresses.
4 + On Linux, only register protocol handler for LLDP when only LLDP
6 + Stricter on LLDP incoming frames validation.
7 + Add support for VLAN-aware bridges for Linux (no range support).
8 + Add support for 802.3BT (no SNMP support).
10 + Don't clear chassis TLV on shutdown LLDPDU.
11 + Don't require/display powerpairs for Dot3 power when device type
16 + Add "configure system max-neighbors XX" command to modify maximum
17 of neighbors accepted per port.
18 + Implement lldpRemOrgDefInfoTable table for custom TLVs.
20 + Better compliance for statsTLVsUnrecognizedTotal and
21 statsAgeoutsTotal counters.
22 + On Linux, handle rare blocking case in Netlink code.
26 + Fix creation of chroot directory.
30 + On Linux, the monitor process will now drop its privileges
31 instead of running as root. It will keep CAP_NET_RAW,
32 CAP_NET_ADMIN and CAP_DAC_OVERRIDE capabilities.
33 + Support for CDP PD PoE (with negotiation). Thanks to Gustav
35 + Move support for bonded devices on Linux < 2.6.27 into the
36 `--enable-oldies` option. This avoids duplicate packets
37 starting from Linux 4.19.
41 + Use "mkdir -p" instead of "mkdir" in systemd unit.
45 + Chassis ID can be set to an arbitrary value with "configure system
47 + Port description can be overriden directly with "configure lldp
49 + Command "configure system interface permanent" enables one to
50 specify a pattern for interfaces to be kept in memory even when
51 they are removed from the system.
53 + Ensure chassis-related changes are propagated immediately.
54 + Ensure management address change is correctly detected.
58 + lldpcli can now display local interfaces with LLDP data sent on
59 each of them ("show interfaces").
60 + As Dot3 PD device, echo back allocated value from PSE device.
62 + Don't remove interfaces when they are released from a bridge.
63 + Don't use "expect stop" with Upstart. It's buggy.
67 + "Station" capability is only set if no other bit is set.
68 + Use ethtool to get permanent address for bonds and teams. This
69 might provide different results than the previous method. Some
70 devices may still use the previous method.
71 + Don't run ethtool as root. Kernels older than 2.6.19 won't get
72 link information anymore.
73 + Add "configure system hostname ." option to not use a FQDN
75 + Add "-f json0" to provide a more regular/machine-parsable output
76 to JSON output, even when not compiled with --enable-json0.
78 + Handle team interfaces like a bond. Real MAC address cannot be
83 + Attach remote TTL to port instead of chassis.
84 + JSON support is now built-in and unconditionally enabled. Use
85 --enable-json0 to keep the pre-0.9.2 json-c format.
86 + When logging to syslog and daemonizing, don't log to stderr.
87 + vxlan interfaces are now ignored as they are multi-point interfaces.
88 + Maximum number of neighbors for an interface is increased from 4 to 32.
92 + Add a compile-time option to restore pre-0.9.2 JSON format (when
93 using json-c). Use `--enable-json0` to enable this option.
94 + Support for newer ethtool interface on Linux
95 (ETHTOOL_GLINKSETTINGS) and additional speed settings.
96 + Current MAU type is displayed even when autoneg is off.
97 + Increase netlink receive buffer by default. Can be changed at
98 compile-time through ./configure.
100 + Correctly parse LLDP-MED civic address when the length of the
101 TLV exceeds the length of the address.
102 + Fix 100% CPU on some rare error condition.
103 + Fix lost timer when an interface is enslaved on Linux.
107 + More Ethernet media supported. However, RFC4836 is quite
108 out-of-date with respected to 10G+ speeds, bringing some
110 + Directly get media information for an interface without using
111 the privileged process.
112 + LLDP-MED capability TLV is not sent when LLDP-MED is not enabled,
113 even if other LLDP-MED TLV are present.
115 + Compilation fix with older versions of GCC.
116 + Don't use ethtool at all to get real MAC address for enslaved
117 devices (always use /proc).
121 + Make lldpd accepts a `-p` option to specify the PID file.
122 + Ability to change multicast MAC address to two additional values
123 to reach customer bridges.
124 + lldpcli will now display chassis TTL when detailed view is enabled.
126 + Fix setting of local value for port ID.
127 + Fix compilation with BSD make.
128 + Ensure lldpcli returns an error code on invalid commands.
132 + Do not rely on support of constructors for liblldpctl.
133 + Always log to stderr (even in addition to syslog).
134 + `lldpcli watch` accepts a limit on the number of received events.
136 + `lldpcli -f {xml,json} watch` should work now.
137 + Consider `veth` interfaces as physical interfaces.
141 + Ability to add/remove/replace custom TLV from lldpcli.
142 + LLDP-MED capabilities are displayed differently in lldpcli.
143 + Limit the maximum depth (5) when trying to apply a VLAN.
144 + Change JSON output format when using json-c to match Jansson
146 + Integration tests for the major parts of lldpd, including use of
147 address and leak sanitizer.
149 + LLDP-MED POE TLV are now displayed in lldpcli.
150 + Ignore lower link when it is in another namespace.
151 + Fix various problems with interfaces being enslaved.
152 + Fix a memory leak when modifying port-related settings.
156 + Rework packaging for OS X to make it work with El Capitan. To
157 simplify a bit, it is not possible anymore to build fat
158 binaries. Latest version of OS X supporting 32bit was 10.6.
160 + By default, when using port alias as description, use port name
162 + Miscellaneous fixes with netlink cache.
163 + Ensure large netlink messages can be received.
167 + Don't rely on libnl3 for netlink. Reuse the previous code and
168 implement a lighweight cache.
170 lldpd (0.8.0, never released)
172 + PIE is now disabled by default. It's too difficult to reliably
173 detect if it works. Use --enable-pie to enable it.
174 + Retrieve the permanent MAC address of an interface through
175 ethtool for Linux if /proc/net/bonding is not available.
176 + Running lldpd with "-d" will keep the process in foreground but
177 logs will still go to syslog. To log to the console, add at
179 + Fix minimal kernel version to 2.6.39. Add a runtime warning when
180 this is not the case.
181 + Remove old bridge code (the one using ioctl).
182 + Don't discard down interfaces. Notably, this enables us to keep
183 their specific configuration if any.
184 + For Linux, switch to libnl3. Be aware of the licensing issues in
185 case of static linking.
186 + Introduce the notion of default local port. New interfaces will
187 use it as a base. This allows setting various MED stuff.
188 + Provide an apparmor profile (untested).
190 + Fix a buffer overflow when receiving a too large management
191 address TLV. Unless hardening has been disabled, this overflow
192 cannot be used for arbitrary code execution.
193 + Update LLDP-MED policy L2 priority values to match
194 802.1Q-2005. This may be a breaking change.
198 + Fix the way libevent configure is called.
199 + Fix an infinite loop when using veth on Linux 4.1+ kernels.
200 + Make CDP advertise the appropriate kernel name as platform,
205 + For Linux, 2.6.32 is now the minimal required kernel. When using
206 an older kernel, use `--enable-oldies`.
207 + For Linux, use netlink to retrieve information about bridges,
208 VLAN and bonds. The code was contributed by Cumulus Networks.
209 + Use symbol versioning for liblldpctl.so.
210 + Ability to get local chassis information with "show
212 + The library also has the same ability with the
213 `lldpctl_get_local_chassis()` function. It is also possible to
214 get a chassis atom from a port with `lldpctl_k_port_chassis`
215 key. This is now the preferred way to retrieve chassis related
219 + Accept "language" when configuring MED location as a civic address.
223 + Optional features can be configured with "auto" to autodetect if
224 they are usable. This is the default value for JSON and XML support.
225 + Ability to send and decode custom/unknown TLV. Thanks to Alexandru
227 + Modify checksum function. While this should be strictly
228 equivalent, if you notice CDP packets not accepted anymore, this
229 change is the first culprit.
233 + Shutdown LLPDU are sent on MSAP change and when lldpd exits.
234 + When an exact IP is provided as a management pattern, use it
236 + Ability to set port ID and description to an arbitrary value,
237 thanks to Alexandru Ardelean.
239 + Incorrect boundary check when decoding management address and
240 protocol identity may lead to lldpd crash when processing
242 + Many edge cases where lldpd was leaving hanging processes after
247 + Unbreak customization of Unix socket path from command line.
251 + Interface pattern, management pattern, system description,
252 system platform and system hostname can be unconfigured to their
255 + Don't complain when parsing a commented line.
256 + Correctly persist configuration changes for "system interface
257 promiscuous", "system interface description" "med fast-start
258 enable", "pause" and "resume".
259 + Fix listening on bond devices for old kernels (< 2.6.27).
263 + Ship bash and zsh completion.
264 + Abort when some command-line options are repeated.
266 + Handle correctly read failures in liblldpctl.
270 + Ability to set promiscuous mode to work around bugs of some
271 switches encapsulating LLDP frames inside 802.1Q frames.
272 + JSON support for lldpcli can use json-c instead of jansson,
273 thanks to Michel Stam.
275 + Fix checksum computation for Cisco CDP.
276 + Fix ability to disable LLDP.
277 + Fix seccomp sandbox, thanks to Patrick McLean.
281 + Default location for chroot, socket and PID are now configurable
282 in `./configure`. The default location is based on the value of
283 `runstatedir` which in turn may be based on the value of
284 `localstatedir` which defaults to `/usr/local/var`. Therefore,
285 to get the previous locations, lldpd should be configured with
286 `./configure --localstatedir=/var`.
287 + Add support for shutdown LLDPU.
288 + Ability to configure IP management pattern from lldpcli.
289 + Ability to choose what port ID should be (MAC or interface name).
291 + Fix `configure system bond-slave-src-mac-type local`. Also use
297 + Add the possibility to disable privilege separation (lower
298 memory consumption, lower security, don't do it).
299 + Interfaces can now be whitelisted. For example, *,!eth*,!!eth1
300 is a valid pattern for all interfaces except eth ones, except
301 eth1. Moreover, on exact match, an matching interface
302 circumvents most sanity checks (like VLAN handling).
303 + Ability to override the hostname.
305 + Don't hard-code default values for system name, system
306 description and port description. When the field is not present,
307 just don't display it.
308 + Fix lldpcli behaviour when suid.
309 + On OSX, don't use p2p0 interfaces: it would break WLAN.
310 + Fix SNMP support on RHEL.
314 + Use a locally administered MAC address or an arbitrary one
315 instead of null MAC address for bond devices on Linux. This is
316 configurable through `lldpcli`.
317 + Add support for "team" driver (alternative to bond devices).
318 + Preliminary support for DTrace/systemtap.
319 + Preliminary support for seccomp (for monitor process).
320 + Setup chroot inside lldpd instead of relying on init script.
322 + Various bugs related to fixed point number handling (for
323 coordinates in LLDP-MED)
324 + Fix a regression in how MAC address of an enslaved device is
329 + Provide a way to build packages for OSX.
330 + Add an option to update interface description with neighbor name.
332 + Compilation fix for OSX 10.6.
336 + Segfault while tokenizing in lldpcli.
340 + Segfault in lldpcli.
341 + Memory leak in liblldpctl when using a custom log handler.
342 + Fix some unaligned memory accesses.
343 + Fix frame reception on OpenBSD.
345 + Allow to configure hold value from lldpcli (and hence the TTL).
346 + Allow to configure pattern for valid interfaces from lldpcli.
347 + Allow to override system description from lldpcli.
348 + Display the neighbor connected as the process title (or the
349 number of connected neighbors).
353 + DragonFly BSD support.
354 + Solaris support (incomplete).
355 + LLDP-MED fast start support (thanks to Roopa Prabhu).
356 + Provide global statistics through "show statistics summary"
357 command (thanks to Roopa Prabhu).
359 + Fix IPv4/IPv6 address discovery in Linux.
363 + lldpd can be configured through /etc/lldpd.conf and
364 /etc/lldpd.d. All commands accepted by lldpcli are accepted.
365 + Lock BPF interfaces before handing them to chrooted process on
367 + Limit the number of neighbors for each port to 4 (per protocol).
368 + Force CDPv2 protocol with argument `-ccc`.
369 + Provide port statistics through "show statistics" command
370 (thanks to Roopa Prabhu).
372 + Driver whitelisting is done before checking if an interface has
373 a lower interface in Linux.
374 + Expire remote ports and chassis in a timely manner.
378 + Mac OS X support, sponsored by Xcloud, Mac cloud server hosting
379 provider. http://xcloud.me/
380 + Upstart and systemd support.
381 + Remove Unix socket when there is no process listening.
388 + Detect interface changes.
389 + CLI for lldpctl: lldpcli.
390 + Allow to disable LLDP protocol (with `-ll`). In this case, the
391 first enabled protocol will be used when no neighbor is detected.
392 + Allow to filter debug logs using tokens. Add more debug logs.
393 + lldpctl can now output JSON.
394 + Use netlink to gather interface information on Linux.
395 + Don't use ioctl for bridges anymore on Linux. The configure
396 option `--enable-oldies` allow to reenable their uses for
397 systems not supporting sysfs.
401 + Provide liblldpctl.so, a library to interface with lldpd. The
402 documentation is provided through Doxygen. See src/lib/lldpctl.h
403 which contains all the exported functions.
404 + Make lldpctl uses liblldpctl.so.
405 + Add a "watch" option to lldpctl to monitor neighbor changes.
406 + Add the possibility to display the current configuration of
407 lldpd with lldpctl. Also add the possibility to reset the
408 current transmit delay.
412 + Allow lldpctl to display hidden ports.
413 + Add a switch to specify interfaces to use to get chassis ID.
414 + Support for multiple management addresses and IPv6 management
415 addresses. Contributed by João Valverde.
416 + Switch to libevent. See README.md for details.
417 + Partial rewrite of the SNMP part. Less code.
418 + Unit tests for SNMP.
419 + Major rewrite of the protocol between lldpd and lldpctl. Less
422 + Several small SNMP fixes (discovered by unit tests).
426 + Configure issue with NetSNMP and some linkers
427 + Fix infinite loop for the receive part: on certain conditions,
428 lldpd will stop sending packets and stop updating local data.
432 + Send and receive native VLAN TLV with CDP
433 + Add a whitelist for some drivers (currently: dsa and veth)
435 + Compilation issues with NetSNMP 5.7 (and with earlier versions too)
436 + Small optimization of BPF filter
440 + Support for PPVID and PI Dot1 TLV, thanks to Shuah Khan.
441 + Extend whitelist with possibility to blacklist.
443 + Key/value output was incorrect when a dot was present in
444 interface names. This is fixed but it is preferable to use XML
445 output since the parsing is more difficult in this case.
446 + Only grab DMI information once. Only uses DMI for x86 platform.
447 + Padding issues with socket protocol. This introduces a change in
449 + Fix a segfault when neither /etc/os-release nor lsb_release
454 + Get OS information from /etc/os-release if available. Patch from
456 + Add a flag to specify which interfaces lldpd should listen to.
460 + Handle Dot3 POE-MDI TLV (802.3af and 802.3at).
461 + Allow to set Dot3 POE-MDI from lldpctl.
463 + Allow root to change configuration of lldpd when lldpctl has suid set.
467 + More flexible smart mode and new default. Manual page has been updated.
468 + Add a "receive-only" mode with "-r" switch.
472 + Allow to force a protocol even when no peer for this protocol is
474 + Add a smart mode that allows to discard bogus port information,
475 for example CDP packets that are flooded through a switch that
476 does not support CDP.
477 + Allow to set LLDP-MED network policy from lldpctl, thanks to a patch from
479 + Allow to set LLDP-MED POE-MDI from lldpctl.
480 + Add a summary of available options in "lldpd -h" and "lldpctl -h",
481 thanks to a patch from Jorge Boncompte.
482 + Add a new output (keyvalue) for lldpctl.
483 + Listen on VLAN using an appropriate BPF filter, VLAN
484 decapsulation. Older "listen on vlan" feature is discarded. See
485 README for more information on the new feature.
486 + Use output of lsb_release if available for system description.
488 + Ignore interface with no queue. It should filter out interfaces
489 like "vnet0" that would fail if we try to send something on them.
490 + Don't check CDP checksums (not really a fix but it appears that
491 Cisco checksum have some difficult corner cases).
495 + lldpd can now handle several systems on the same port. This
496 modification also allows to speak to a switch using CDP and LLDP
498 + The way that lldpd gathers information for each port has been
499 abstracted. This should allow to support more systems (BSD for
500 examples) or switch cores in the future. Sending/receive support
502 + Add "-k" switch to avoid to emit too much information on running
504 + Support of ifAlias with kernel >= 2.6.28
505 + Lot of portability stuff. lldpd can now be compiled on RHEL
506 2.1. Still Linux-only though.
507 + Add an option to specify AgentX socket (-X).
508 + Add some unit tests
509 + lldpctl has been reworked; it is now able to output data in XML
510 format for easier parsing. Patches were provided by Andreas
513 + Fix EDP VLAN handling
514 + Silent warnings about bridge stuff.
515 + Copy /etc/localtime into chroot before starting lldpd daemon to
516 ensure correct timestamps for logs.
519 * Fix EDP handling when there is no VLAN
520 * Fix CDP version to not always be 1
522 + incorrect number of arguments for a LLOG_INFO call
523 + fix SNMP last change in case this change occurs before start time
526 * Rewrite of packet builder and parser to be able to cope with
527 architecture that cannot do unaligned read. For decoder, we don't
528 cast structures any more since they can be unaligned. For encoder,
529 we use memcpy through the use of macro that build packets step by
533 * Fix LLDP-MED support
536 * Misc fixes, including memory leaks
539 * Initial support of LLDP-MED
540 * Fix for bridge detection (don't send bridge ioctl on random interfaces)
541 * For bonded devices, get the real hardware address. For inactive
542 slaves, transmit using a random MAC address.
545 * Fix a syntax error in manual page
549 * Add privilege separation
551 * Support CDP encapsulated into native VLAN