• source navigation  • identifier search  • freetext search  • 

Sources/odhcpd/

Back Parent directory
Folder src/
File CMakeLists.txt 1720 bytes
File COPYING 18011 bytes
File README 6472 bytes

  1 odhcpd - Embedded DHCP/DHCPv6/RA Server & Relay
  2 
  3 ** Abstract **
  4 
  5 odhcpd is a daemon for serving and relaying IP management protocols to
  6 configure clients and downstream routers. It tries to follow the RFC 6204
  7 requirements for IPv6 home routers.
  8 
  9 odhcpd provides server services for DHCP, RA, stateless and stateful DHCPv6,
 10 prefix delegation and can be used to relay RA, DHCPv6 and NDP between routed
 11 (non-bridged) interfaces in case no delegated prefixes are available.
 12 
 13 
 14 ** Features **
 15 
 16 1. Router Discovery support (solicitations and advertisements) with 2 modes
 17    server:      RD server for slave interfaces
 18    a) automatic detection of prefixes, delegated prefix and default routes, MTU
 19    b) automatic reannouncement when changes to prefixes or routes occur
 20 
 21    relay:       RD relay between master and slave interfaces
 22    a) support for rewriting announced DNS-server addresses in relay mode
 23    
 24 2. DHCPv6-support with 2 modes of operation
 25    server: stateless, stateful and PD-server mode
 26    a) stateless and stateful address assignment
 27    b) prefix delegation support
 28    c) dynamic reconfiguration in case prefixes change
 29    d) hostname detection and hosts-file creation
 30 
 31    relay:       mostly standards-compliant DHCPv6-relay
 32    a) support for rewriting announced DNS-server addresses
 33    
 34 3. DHCPv4-support
 35    server: stateless and stateful mode
 36 
 37 4. Proxy for Neighbor Discovery messages (solicitations and advertisements)
 38    a) support for auto-learning routes to the local routing table
 39    b) support for marking interfaces "external" not proxying NDP for them
 40       and only serving NDP for DAD and for traffic to the router itself
 41       [Warning: you should provide additional firewall rules for security]
 42 
 43 
 44 ** Compiling **
 45 
 46 odhcpd uses cmake:
 47 * To prepare a Makefile use:  "cmake ." 
 48 * To build / install use: "make" / "make install" afterwards.
 49 * To build DEB or RPM packages use: "make package" afterwards.
 50 
 51 
 52 ** Configuration **
 53 
 54 odhcpd uses a UCI configuration file in /etc/config/dhcp for configuration
 55 and may also receive information from ubus
 56 
 57 
 58 Section of type odhcpd
 59 
 60 Option          Type    Default                 Description
 61 legacy          bool    0                       Enable DHCPv4 if start but
 62                                                 no dhcpv4 option set
 63 maindhcp        bool    0                       Use odhcpd as the main DHCPv4
 64                                                 service
 65 leasefile       string                          DHCP/v6 lease/hostfile
 66 leasetrigger    string                          Lease trigger script
 67 hostsfile       string                          DHCP/v6 hostfile
 68 loglevel        integer 6                       Syslog level priority (0-7)
 69 
 70 
 71 Sections of type dhcp (configure DHCP / DHCPv6 / RA / NDP service)
 72 
 73 Option                  Type    Default                 Description
 74 interface               string  <name of UCI section>   logical OpenWrt interface
 75 ifname                  string  <resolved from logical> physical network interface
 76 networkid               string  same as ifname          compat. alias for ifname
 77 master                  bool    0                       is a master interface
 78                                                         for relaying
 79 
 80 ra                      string  disabled                Router Advert service
 81                         [disabled|server|relay|hybrid]
 82 dhcpv6                  string  disabled                DHCPv6 service
 83                         [disabled|server|relay|hybrid]
 84 dhcpv4                  string  disabled                DHCPv4 service
 85                         [disabled|server]
 86 ndp                     string  disabled                Neighbor Discovery Proxy
 87                         [disabled|relay|hybrid]
 88 
 89 dynamicdhcp             bool    1                       Dynamically create leases
 90                                                         for DHCPv4 and DHCPv6
 91 dhcpv4_forcereconf      bool    0                       Force reconfiguration by sending
 92                                                         force renew message even if the client
 93                                                         did not include the force renew nonce
 94                                                         capability option (RFC6704)
 95 dhcpv6_assignall        bool    1                       Assign all viable DHCPv6 addresses
 96                                                         in statefull mode; if disabled
 97                                                         only the DHCPv6 address having the
 98                                                         longest preferred lifetime is assigned
 99 dhcpv6_hostidlength     integer 12                      Host ID length of dynamically created leases,
100                                                         allowed values: 12 - 64 (bits).
101 dhcpv6_na               bool    1                       DHCPv6 stateful addressing hands out IA_NA -
102                                                                 Internet Address - Network Address
103 dhcpv6_pd               bool    1                       DHCPv6 stateful addressing hands out IA_PD -
104                                                                 Internet Address - Prefix Delegation
105 dhcpv6_pd_min_len       integer -                       Minimum prefix length to delegate with IA_PD
106                                                         (value is adjusted if needed to be greater
107                                                         than the interface prefix length).  Range [1,62]
108 router                  list    <local address>         Routers to announce
109                                                         accepts IPv4 only
110 dns                     list    <local address>         DNS servers to announce
111                                                         accepts IPv4 and IPv6
112 dns_service             bool    1                       Announce the address of interface as DNS service
113                                                         if the list of dns is empty
114 domain                  list    <local search domain>   Search domains to announce
115 
116 leasetime               string  12h                     DHCPv4 address leasetime
117 start                   integer 100                     DHCPv4 pool start
118 limit                   integer 150                     DHCPv4 pool size
119 preferred_lifetime      string  7d                      Value for the preferred lifetime
120                                                         for a prefix
121 ra_default              integer 0                       Override default route
122                         0: default, 1: ignore no public address, 2: ignore all
123 ra_flags                list    other-config            List of RA flags to be
124                                                         advertised in RA messages
125                         [managed-config other-config home-agent none]
126 ra_slaac                bool    1                       Announce slaac for a prefix
127 ra_offlink              bool    0                       Announce prefixes off-link
128 ra_preference           string  medium                  Route(r) preference
129                         [medium|high|low]
130 ra_maxinterval          integer 600                     Maximum time allowed between
131                                                         sending unsolicited RA
132 ra_mininterval          integer 200                     Minimum time allowed between
133                                                         sending unsolicited RA
134 ra_lifetime             integer 1800                    Value to be placed in Router
135                                                         Lifetime field of RA
136 ra_useleasetime         bool    0                       Use configured leasetime as
137                                                         limit for the preferred and
138                                                         valid lifetime of a prefix
139 ra_reachabletime        integer 0                       Reachable Time in milliseconds to be
140                                                         advertised in RA messages
141 ra_retranstime          integer 0                       Retransmit Time in milliseconds to be
142                                                         advertised in RA messages
143 ra_hoplimit             integer 0                       Current hoplimit to be advertised
144                                                         in RA messages
145 ra_mtu                  integer -                       MTU to be advertised in
146                                                         RA messages
147 ra_dns                  bool    1                       Announce DNS configuration in
148                                                         RA messages (RFC8106)
149 ra_pref64               string                          Announce PREF64 option
150                         [IPv6 prefix]                   for NAT64 prefix (RFC8781)
151 ndproxy_routing         bool    1                       Learn routes from NDP
152 ndproxy_slave           bool    0                       NDProxy external slave
153 prefix_filter           string  ::/0                    Only advertise on-link prefixes within
154                         [IPv6 prefix]                   the provided IPv6 prefix; others are
155                                                         filtered out.
156 ntp                     list    <local address>         NTP servers to announce
157                                                         accepts IPv4 and IPv6
158 
159 
160 Sections of type host (static leases)
161 Option          Type    Default                 Description
162 ip              string                          IP-Address to lease
163 mac             string                          MAC-address
164 duid            string                          DUID in base16
165 hostid          string                          IPv6 host identifier
166 name            string                          Hostname
167 leasetime       string                          DHCPv4/v6 leasetime
168 

This page was automatically generated by LXR 0.3.1.  •  OpenWrt