Merge pull request #14 from dedeckeh/bugfixes

[project/odhcpd.git] / README

diff --git a/README b/README
index c1c0d1e..6011b0f 100644 (file)
--- a/README
+++ b/README
@@ -21,8 +21,8 @@ prefix delegation and can be used to relay RA, DHCPv6 and NDP between routed
    relay:      RD relay between master and slave interfaces
    a) support for rewriting announced DNS-server addresses in relay mode
    
    relay:      RD relay between master and slave interfaces
    a) support for rewriting announced DNS-server addresses in relay mode
    

-3. DHCPv6-support with 2 modes of operation
-   server:     minimalistic server mode
+2. DHCPv6-support with 2 modes of operation
+   server: stateless, stateful and PD-server mode

    a) stateless and stateful address assignment
    b) prefix delegation support
    c) dynamic reconfiguration in case prefixes change
    a) stateless and stateful address assignment
    b) prefix delegation support
    c) dynamic reconfiguration in case prefixes change


@@ -31,6 +31,9 @@ prefix delegation and can be used to relay RA, DHCPv6 and NDP between routed
    relay:      mostly standards-compliant DHCPv6-relay
    a) support for rewriting announced DNS-server addresses
    
    relay:      mostly standards-compliant DHCPv6-relay
    a) support for rewriting announced DNS-server addresses
    

+3. DHCPv4-support
+   server: stateless and stateful mode
+

 4. Proxy for Neighbor Discovery messages (solicitations and advertisments)
    a) support for auto-learning routes to the local routing table
    b) support for marking interfaces "external" not proxying NDP for them
 4. Proxy for Neighbor Discovery messages (solicitations and advertisments)
    a) support for auto-learning routes to the local routing table
    b) support for marking interfaces "external" not proxying NDP for them


@@ -46,40 +49,67 @@ odhcpd uses cmake:
 * To build DEB or RPM packages use: "make package" afterwards.
 
 
 * To build DEB or RPM packages use: "make package" afterwards.
 
 

-** Server Mode **
+** Configuration **

 
 

-0. Server mode is used as a minimalistic alternative for full-blown servers
-   like radvd or ISC DHCP if simplicity or a small footprint matter.
-   Note: The master interface is unused in this mode. It should be set to '.'.
+odhcpd uses a UCI configuration file in /etc/config/dhcp for configuration
+and may also receive information from ubus

 
 

-1. If there are non-local addresses assigned to the slave interface when a
-   router solicitation is received, said prefixes are announced automatically
-   for stateless autoconfiguration and also offered via stateful DHCPv6.
-   If all prefixes are bigger than /64 all but the first /64 of these prefixes
-   is offered via DHCPv6-PD to downstream routers.

 
 

-2. If DNS servers should be announced (DHCPv6 server-mode) then a local DNS-
-   proxy (e.g. dnsmasq) needs to be run on the router itself because 6relayd
-   will always announce a local address as DNS-server (if not otherwise
-   configured).
+Section of type odhcpd

 
 

-3. odhcpd is run with the appropriate configuration.
+Option         Type    Default                 Description
+legacy         bool    0                       Enable DHCPv4 if start but
+                                               no dhcpv4 option set
+leasefile      string                          DHCP/v6 lease/hostfile
+leasetrigger   string                          Lease trigger script

 
 
 
 

-** Relay Mode **
+Sections of type dhcp (configure DHCP / DHCPv6 / RA / NDP service)

 
 

-0. Relay mode is used when a /64-bit IPv6-Prefix should be distributed over
-   several links / isolated layer 2 domains (e.g. if no prefix delegation
-   is available). In this mode NDP (namely Router Discovery and Neighbor
-   Discovery) messages and DHCPv6-messages are proxied. For DHCPv6 also
-   server mode can be used instead of relaying if desired.
+Option         Type    Default                 Description
+interface      string  <name of UCI section>   logical OpenWrt interface
+ifname         string  <resolved from logical> physical network interface
+networkid      string  same as ifname          compat. alias for ifname
+ignore         bool    0                       ignore this interface
+master         bool    0                       is a master interface
+                                               for relaying
+
+ra             string  disabled                Router Advert service
+               [disabled|server|relay|hybrid]
+dhcpv6         string  disabled                DHCPv6 service
+               [disabled|server|relay|hybrid]
+dhcpv4         string  disabled                DHCPv4 service
+               [disabled|server]
+ndp            string  disabled                Neighbor Discovery Proxy
+               [disabled|relay|hybrid]
+
+dynamicdhcp    bool    1                       dynamically create leases
+                                               for DHCPv4 and DHCPv6
+dns            list    <local address>         DNS servers to announce
+                                               accepts IPv4 and IPv6
+domain         list    <local search domain>   Search domains to announce
+
+leasetime      string  12h                     DHCPv4 address leasetime
+start          integer 100                     DHCPv4 pool start
+limit          integer 150                     DHCPv4 pool size
+
+ra_default     integer 0                       Override default route
+               0: default, 1: ignore no public address, 2: ignore all
+ra_management  integer 1                       RA management mode
+               0: no M-Flag but A-Flag, 1: both M and A, 2: M but not A
+ra_offlink     bool    0                       Announce prefixes off-link
+ra_preference  string  medium                  Route(r) preference
+               [medium|high|low]
+ndproxy_routing        bool    1                       Learn routes from NDP
+ndproxy_slave  bool    0                       NDProxy external slave
+ndproxy_static list                            Static NDProxy prefixes
+
+
+Sections of type host (static leases)
+Option         Type    Default                 Description
+ip             string                          IP-Address to lease
+mac            string                          MAC-address
+duid           string                          DUID in base16
+hostid         string                          IPv6 host identifier
+name           string                          Hostname

 
 

-1. When starting 6relayd it is required that the master interface - where
-   IPv6-service is already provided - is configured and usable.
-   
-2. If the upstream router doesn't provide or announce a DNS-service that is
-   reachable in an at least site-local scope, a local DNS proxy (e.g. dnsmasq)
-   needs to be run and configued on the same router where 6relayd is running.
-   (This step can most likely be skipped in most environments.)
-   
-3. odhcpd is run with the appropriate configuration.