-lldpd: implementation of IEEE 802.1ab (LLDP)
-============================================
+# lldpd: implementation of IEEE 802.1ab (LLDP)

https://lldpd.github.io/
-Features
---------
+## Features
LLDP (Link Layer Discovery Protocol) is an industry standard protocol
designed to supplant proprietary Link-Layer protocols such as
[WinLLDPService](https://github.com/raspi/WinLLDPService/) as a
transmit-only agent.
-Installation
-------------
+## Installation
For general instructions [prefer the
website](https://lldpd.github.io/installation.html),
line. If you don't want to run it as root, just install it setuid or
setgid `_lldpd`.
-Installation (macOS)
------------------------
+## Installation (macOS)
The same procedure as above applies for macOS. However, there are
simpler alternatives:
user/group `_lldpd`. Have a look at how this is done in
`osx/scripts/postinstall`.
-Compilation & Installation (Android)
-----------------------
+## Installation (Android)
1. Don't clone the repo or download the master branch from GitHub. Instead, download the official release from the website [https://lldpd.github.io/](https://lldpd.github.io/installation.html#install-from-source). Unpack into a working directory.
$ rm -rf /sdcard/Download/lldpd
```
-Usage
------
+## Usage
lldpd also implements CDP (Cisco Discovery Protocol), FDP (Foundry
Discovery Protocol), SONMP (Nortel Discovery Protocol) and EDP
* http://standards.ieee.org/getieee802/download/802.1AB-2005.pdf
* http://wiki.wireshark.org/LinkLayerDiscoveryProtocol
-Compatibility with older kernels
---------------------------------
+## Compatibility with older kernels
If you have a kernel older than Linux 2.6.39, you need to compile
lldpd with `--enable-oldies` to enable some compatibility functions:
On modern networks, the performance impact should be nonexistent.
-Development
------------
+## Development
During development, you may want to execute lldpd at its current
location instead of doing `make install`. The correct way to do this is
--directory src --capture --output-file gcov.info
genhtml gcov.info --output-directory coverage
-Embedding
----------
+## Embedding
To embed lldpd into an existing system, there are two point of entries:
should always be shipped with `lldpd`. On the other hand, programs
using `liblldpctl.so` can rely on the classic ABI rules.
-Troubleshooting
----------------
+## Troubleshooting
You can use `tcpdump` to look after the packets received and send by
`lldpd`. To look after LLDPU, use:
tcpdump -s0 -vv -pni eth0 ether dst 01:80:c2:00:00:0e
-License
--------
+## License
lldpd is distributed under the ISC license: