README.md
1
2[](https://travis-ci.org/sspans/ladvd)
3
4WHAT IS LADVD?
5--------------
6
7ladvd is a lldp / cdp / edp / fdp / ndp sender for Unix.
8
9ladvd uses link-layer advertisements to inform switches about connected
10hosts, which simplifies Ethernet switch management. It does this by forking
11into a privileged parent which handles all raw sockets (and certain ioctls),
12and an unprivileged child which creates and parses all packets.
13Every 30 seconds the child generates advertisement frames reflecting the
14current system state. Interfaces (bridge, bonding, wireless),
15capabilities (bridging, forwarding, wireless) and addresses (IPv4, IPv6)
16are detected dynamically. Secondly ladvd can listen for incoming frames
17and utilize these for various features (protocol auto-enable, logging,
18interface descriptions).
19
20
21USAGE
22-----
23
24Basically you start ladvd like any unix daemon.
25To get a complete list of supported options type
26
27 ladvd -h
28
29and see the manual for more information.
30
31
32SETUP
33-----
34
35Ladvd needs root privileges to initialize the required raw-sockets.
36It can run in `daemon' mode, logging to syslog, or in the foreground,
37logging to stderr.
38
39To prepare for building ladvd, first run "autoreconf -fi",
40this will create the configure script and makefiles needed to compile ladvd.
41This will only work if autoconf, automake, pkgconfig and libtool are installed.
42Feel free to skip this step when building from a release tarball.
43
44To build ladvd, first run the "configure" script. This will create a
45Makefile and config.h appropriate for your system. Then type
46"make" and optionally "make install".
47
48Please note that a ladvd user should be created for normal operation.
49And that the provided systemd unit-file (for linux systems) uses FHS standard
50paths (/usr/sbin) and not the autoconf default (/usr/local/sbin).
51
52
53BUG REPORTS
54-----------
55
56Please create an issue on github or email your bug report to sten@blinkenlights.nl.
57
58
59COPYRIGHT
60---------
61
62ladvd is written by Sten Spans, and may be used, modified and
63redistributed only under the terms of the ISC License,
64found in the file LICENSE in this distribution.
65
66
67AVAILABILITY
68------------
69
70The main web site for ladvd is http://github.com/sspans/ladvd/
71
){kind=link}