summaryrefslogtreecommitdiff
path: root/networking/udhcp/Config.src (plain)
blob: 90fb313b505a3d5982706c68ce547a78c9f45f39
1#
2# For a description of the syntax of this configuration file,
3# see scripts/kbuild/config-language.txt.
4#
5
6INSERT
7
8config UDHCPD
9 bool "udhcp server (udhcpd)"
10 default y
11 select PLATFORM_LINUX
12 help
13 udhcpd is a DHCP server geared primarily toward embedded systems,
14 while striving to be fully functional and RFC compliant.
15
16config DHCPRELAY
17 bool "dhcprelay"
18 default y
19 help
20 dhcprelay listens for dhcp requests on one or more interfaces
21 and forwards these requests to a different interface or dhcp
22 server.
23
24config DUMPLEASES
25 bool "Lease display utility (dumpleases)"
26 default y
27 help
28 dumpleases displays the leases written out by the udhcpd server.
29 Lease times are stored in the file by time remaining in lease, or
30 by the absolute time that it expires in seconds from epoch.
31
32config FEATURE_UDHCPD_WRITE_LEASES_EARLY
33 bool "Rewrite the lease file at every new acknowledge"
34 default y
35 depends on UDHCPD
36 help
37 If selected, udhcpd will write a new file with leases every
38 time a new lease has been accepted, thus eliminating the need
39 to send SIGUSR1 for the initial writing or updating. Any timed
40 rewriting remains undisturbed.
41
42config FEATURE_UDHCPD_BASE_IP_ON_MAC
43 bool "Select IP address based on client MAC"
44 default n
45 depends on UDHCPD
46 help
47 If selected, udhcpd will base its selection of IP address to offer
48 on the client's hardware address. Otherwise udhcpd uses the next
49 consecutive free address.
50
51 This reduces the frequency of IP address changes for clients
52 which let their lease expire, and makes consecutive DHCPOFFERS
53 for the same client to (almost always) contain the same
54 IP address.
55
56config DHCPD_LEASES_FILE
57 string "Absolute path to lease file"
58 default "/var/lib/misc/udhcpd.leases"
59 depends on UDHCPD
60 help
61 udhcpd stores addresses in a lease file. This is the absolute path
62 of the file. Normally it is safe to leave it untouched.
63
64config UDHCPC
65 bool "udhcp client (udhcpc)"
66 default y
67 select PLATFORM_LINUX
68 help
69 udhcpc is a DHCP client geared primarily toward embedded systems,
70 while striving to be fully functional and RFC compliant.
71
72 The udhcp client negotiates a lease with the DHCP server and
73 runs a script when a lease is obtained or lost.
74
75config FEATURE_UDHCPC_ARPING
76 bool "Verify that the offered address is free, using ARP ping"
77 default y
78 depends on UDHCPC
79 help
80 If selected, udhcpc will send ARP probes and make sure
81 the offered address is really not in use by anyone. The client
82 will DHCPDECLINE the offer if the address is in use,
83 and restart the discover process.
84
85config FEATURE_UDHCPC_SANITIZEOPT
86 bool "Do not pass malformed host and domain names"
87 default y
88 depends on UDHCPC
89 help
90 If selected, udhcpc will check some options (such as option 12 -
91 hostname) and if they don't look like valid hostnames
92 (for example, if they start with dash or contain spaces),
93 they will be replaced with string "bad" when exporting
94 to the environment.
95
96config FEATURE_UDHCP_PORT
97 bool "Enable '-P port' option for udhcpd and udhcpc"
98 default n
99 depends on UDHCPD || UDHCPC
100 help
101 At the cost of ~300 bytes, enables -P port option.
102 This feature is typically not needed.
103
104config UDHCP_DEBUG
105 int "Maximum verbosity level for udhcp applets (0..9)"
106 default 9
107 range 0 9
108 depends on UDHCPD || UDHCPC || DHCPRELAY
109 help
110 Verbosity can be increased with multiple -v options.
111 This option controls how high it can be cranked up.
112
113 Bigger values result in bigger code. Levels above 1
114 are very verbose and useful for debugging only.
115
116config FEATURE_UDHCP_RFC3397
117 bool "Support for RFC3397 domain search (experimental)"
118 default y
119 depends on UDHCPD || UDHCPC
120 help
121 If selected, both client and server will support passing of domain
122 search lists via option 119, specified in RFC 3397,
123 and SIP servers option 120, specified in RFC 3361.
124
125config FEATURE_UDHCP_8021Q
126 bool "Support for 802.1Q VLAN parameters"
127 default y
128 depends on UDHCPD || UDHCPC
129 help
130 If selected, both client and server will support passing of VLAN
131 ID and priority via options 132 and 133 as per 802.1Q.
132
133config UDHCPC_DEFAULT_SCRIPT
134 string "Absolute path to config script"
135 default "/usr/share/udhcpc/default.script"
136 depends on UDHCPC
137 help
138 This script is called after udhcpc receives an answer. See
139 examples/udhcp for a working example. Normally it is safe
140 to leave this untouched.
141
142config UDHCPC_SLACK_FOR_BUGGY_SERVERS
143 int "DHCP options slack buffer size"
144 default 80
145 range 0 924
146 depends on UDHCPD || UDHCPC
147 help
148 Some buggy DHCP servers send DHCP offer packets with option
149 field larger than we expect (which might also be considered a
150 buffer overflow attempt). These packets are normally discarded.
151 If circumstances beyond your control force you to support such
152 servers, this may help. The upper limit (924) makes dhcpc accept
153 even 1500 byte packets (maximum-sized ethernet packets).
154
155 This option does not make dhcp[cd] emit non-standard
156 sized packets.
157
158 Known buggy DHCP servers:
159 3Com OfficeConnect Remote 812 ADSL Router:
160 seems to confuse maximum allowed UDP packet size with
161 maximum size of entire IP packet, and sends packets which are
162 28 bytes too large.
163 Seednet (ISP) VDSL: sends packets 2 bytes too large.
164