config: log config parse failures to syslog
[project/odhcpd.git] / README
diff --git a/README b/README
index b86df25fd32f88be8360fca006a9d36ddd9476ad..bd63b0e23a97f410de1b99b2aba0a647431d1c6f 100644 (file)
--- a/README
+++ b/README
@@ -34,7 +34,7 @@ prefix delegation and can be used to relay RA, DHCPv6 and NDP between routed
 3. DHCPv4-support
    server: stateless and stateful mode
 
-4. Proxy for Neighbor Discovery messages (solicitations and advertisments)
+4. Proxy for Neighbor Discovery messages (solicitations and advertisements)
    a) support for auto-learning routes to the local routing table
    b) support for marking interfaces "external" not proxying NDP for them
       and only serving NDP for DAD and for traffic to the router itself
@@ -60,51 +60,91 @@ Section of type odhcpd
 Option         Type    Default                 Description
 legacy         bool    0                       Enable DHCPv4 if start but
                                                no dhcpv4 option set
+maindhcp       bool    0                       Use odhcpd as the main DHCPv4
+                                               service
 leasefile      string                          DHCP/v6 lease/hostfile
 leasetrigger   string                          Lease trigger script
+loglevel       integer 6                       Syslog level priority (0-7)
 
 
 Sections of type dhcp (configure DHCP / DHCPv6 / RA / NDP service)
 
-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
-router          list    <local address>         Routers to announce
-                                                accepts IPv4 only
-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
+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
+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
+dhcpv4_forcereconf     bool    0                       Force reconfiguration by sending
+                                                       force renew message even if the client
+                                                       did not include the force renew nonce
+                                                       capability option (RFC6704)
+dhcpv6_assignall       bool    1                       Assign all viable DHCPv6 addresses
+                                                       in statefull mode; if disabled
+                                                       only the DHCPv6 address having the
+                                                       longest preferred lifetime is assigned
+dhcpv6_na              bool    1                       DHCPv6 stateful addressing hands out IA_NA -
+                                                               Internet Address - Network Address
+dhcpv6_pd              bool    1                       DHCPv6 stateful addressing hands out IA_PD -
+                                                               Internet Address - Prefix Delegation
+router                 list    <local address>         Routers to announce
+                                                       accepts IPv4 only
+dns                    list    <local address>         DNS servers to announce
+                                                       accepts IPv4 and IPv6
+dns_service            bool    1                       Announce the address of interface as DNS service
+                                                       if the list of dns is empty
+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
+preferred_lifetime     string  12h                     Value for the preferred lifetime
+                                                       for a prefix
+ra_default             integer 0                       Override default route
+                       0: default, 1: ignore no public address, 2: ignore all
+ra_flags               list    other-config            List of RA flags to be
+                                                       advertised in RA messages
+                       [managed-config other-config home-agent none]
+ra_slaac               bool    1                       Announce slaac for a prefix
+ra_offlink             bool    0                       Announce prefixes off-link
+ra_preference          string  medium                  Route(r) preference
+                       [medium|high|low]
+ra_maxinterval         integer 600                     Maximum time allowed between
+                                                       sending unsolicited RA
+ra_mininterval         integer 200                     Minimum time allowed between
+                                                       sending unsolicited RA
+ra_lifetime            integer 1800                    Value to be placed in Router
+                                                       Lifetime field of RA
+ra_useleasetime                bool    0                       Use configured leasetime as
+                                                       limit for the preferred and
+                                                       valid lifetime of a prefix
+ra_reachabletime       integer 0                       Reachable Time in milliseconds to be
+                                                       advertised in RA messages
+ra_retranstime         integer 0                       Retransmit Time in milliseconds to be
+                                                       advertised in RA messages
+ra_hoplimit            integer 0                       Current hoplimit to be advertised
+                                                       in RA messages
+ra_mtu                 integer -                       MTU to be advertised in
+                                                       RA messages
+ra_dns                 bool    1                       Announce DNS configuration in
+                                                       RA messages (RFC8106)
+ndproxy_routing                bool    1                       Learn routes from NDP
+ndproxy_slave          bool    0                       NDProxy external slave
+prefix_filter          string  ::/0                    Only advertise on-link prefixes within
+                       [IPv6 prefix]                   the provided IPv6 prefix; others are
+                                                       filtered out.
 
 
 Sections of type host (static leases)
@@ -114,4 +154,5 @@ mac         string                          MAC-address
 duid           string                          DUID in base16
 hostid         string                          IPv6 host identifier
 name           string                          Hostname
+leasetime      string                          DHCPv4/v6 leasetime