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