ndppd/README.md

43 lines
1.8 KiB
Markdown
Raw Normal View History

2019-12-11 11:34:34 +01:00
# NDPPD
2019-12-11 15:26:38 +01:00
This is the development branch for version 1.0 of *ndppd*.
2019-12-11 11:34:34 +01:00
Please read the manpages [ndppd.conf.5](ndppd.conf.5.adoc) and [ndppd.8](ndppd.8.adoc).
2019-12-15 01:05:02 +01:00
## Status
***ndppd*** was rewritten from scratch using C (C99).
It's currently **highly experimental**, but I expect a beta to be ready by the end of the year.
## Description
***ndppd***, or ***NDP Proxy Daemon***, is a daemon that proxies *neighbor discovery* messages. It listens for *neighbor solicitations* on a
specified interface and responds with *neighbor advertisements* - as described in **RFC 4861** (section 7.2).
There are several methods available when determining of a *neighbor advertisement* should be sent back:
The first method, and the most common, is the ***autoresolve*** method. It uses the routing table to determine how the target is reachable.
If a valid route exists, a *neighbor solicitation* is sent out through that interface. Only once ***ndppd*** receives a *neighbor advertisement*
from the target will it start responding to *neighbor solicitations*.
The second method is the ***explicit*** method. A *neighbor solicitation* is sent through a manually provided interface. This
method also allows for the use of ***autowire*** which sets up a route to the specified target through said interface *if the target was found, and for the
duration of the session*.
The third method is the ***static*** method. When used, ***ndppd*** will immediately respond to *neighbor solicitation* messages immediately
without first querying an internal interface.
2019-12-11 15:34:32 +01:00
## Compiling
You must have *asciidoctor* installed in order to transpile the documentation.
In most cases, the following should be sufficient:
make all && make install
## Contact
Daniel Adolfsson <daniel-at-ashen.se>
https://github.com/DanielAdolfsson/ndppd