File: README.md

package info (click to toggle)
ladvd 1.1.2-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 1,240 kB
  • sloc: ansic: 11,169; sh: 189; makefile: 184
file content (70 lines) | stat: -rw-r--r-- 2,251 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

[![Build Status](https://travis-ci.org/sspans/ladvd.png)](https://travis-ci.org/sspans/ladvd)

WHAT IS LADVD?
--------------

ladvd is a lldp / cdp / edp / fdp / ndp sender for Unix.

ladvd uses link-layer advertisements to inform switches about connected
hosts, which simplifies Ethernet switch management. It does this by forking
into a privileged parent which handles all raw sockets (and certain ioctls),
and an unprivileged child which creates and parses all packets.
Every 30 seconds the child generates advertisement frames reflecting the
current system state. Interfaces (bridge, bonding, wireless),
capabilities (bridging, forwarding, wireless) and addresses (IPv4, IPv6) 
are detected dynamically. Secondly ladvd can listen for incoming frames
and utilize these for various features (protocol auto-enable, logging,
interface descriptions).


USAGE
-----

Basically you start ladvd like any unix daemon. 
To get a complete list of supported options type

  ladvd -h

and see the manual for more information.


SETUP
-----

Ladvd needs root privileges to initialize the required raw-sockets.
It can run in `daemon' mode, logging to syslog, or in the foreground,
logging to stderr.

To prepare for building ladvd, first run "autoreconf -fi", 
this will create the configure script and makefiles needed to compile ladvd. 
This will only work if autoconf, automake, pkgconfig and libtool are installed.
Feel free to skip this step when building from a release tarball.

To build ladvd, first run the "configure" script. This will create a
Makefile and config.h appropriate for your system. Then type
"make" and optionally "make install". 

Please note that a ladvd user should be created for normal operation.
And that the provided systemd unit-file (for linux systems) uses FHS standard
paths (/usr/sbin) and not the autoconf default (/usr/local/sbin).


BUG REPORTS
-----------

Please create an issue on github or email your bug report to sten@blinkenlights.nl.


COPYRIGHT
---------

ladvd is written by Sten Spans, and may be used, modified and
redistributed only under the terms of the ISC License,
found in the file LICENSE in this distribution.


AVAILABILITY
------------

The main web site for ladvd is http://github.com/sspans/ladvd/