[efi] Include installed protocol list in unknown handle names
[ipxe.git] / src / config / dhcp.h
1 #ifndef CONFIG_DHCP_H
2 #define CONFIG_DHCP_H
3
4 /** @file
5 *
6 * DHCP configuration
7 *
8 */
9
10 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
11
12 #include <config/defaults.h>
13
14 /*
15 * DHCP and PXE Boot Server timeout parameters
16 *
17 * Initial and final timeout for DHCP discovery
18 *
19 * The PXE spec indicates discover request are sent 4 times, with
20 * timeouts of 4, 8, 16, 32 seconds. iPXE by default uses 1, 2, 4, 8.
21 */
22 #define DHCP_DISC_START_TIMEOUT_SEC 1
23 #define DHCP_DISC_END_TIMEOUT_SEC 10
24 //#define DHCP_DISC_START_TIMEOUT_SEC 4 /* as per PXE spec */
25 //#define DHCP_DISC_END_TIMEOUT_SEC 32 /* as per PXE spec */
26
27 /*
28 * ProxyDHCP offers are given precedence by continue to wait for them
29 * after a valid DHCPOFFER is received. We'll wait through this
30 * timeout for it. The PXE spec indicates waiting through the 4 & 8
31 * second timeouts, iPXE by default stops after 2.
32 */
33 #define DHCP_DISC_PROXY_TIMEOUT_SEC 2
34 //#define DHCP_DISC_PROXY_TIMEOUT_SEC 11 /* as per PXE spec */
35
36 /*
37 * Per the PXE spec, requests are also tried 4 times, but at timeout
38 * intervals of 1, 2, 3, 4 seconds. To adapt this to an exponential
39 * backoff timer, we can either do 1, 2, 4, 8, ie. 4 retires with a
40 * longer interval or start at 0 (0.25s) for 0.25, 0.5, 1, 2, 4,
41 * ie. one extra try and shorter initial timeouts. iPXE by default
42 * does a combination of both, starting at 0 and going through the 8
43 * second timeout.
44 */
45 #define DHCP_REQ_START_TIMEOUT_SEC 0
46 #define DHCP_REQ_END_TIMEOUT_SEC 10
47 //#define DHCP_REQ_END_TIMEOUT_SEC 4 /* as per PXE spec */
48
49 /*
50 * A ProxyDHCP offer without PXE options also goes through a request
51 * phase using these same parameters, but note the early break below.
52 */
53 #define DHCP_PROXY_START_TIMEOUT_SEC 0
54 #define DHCP_PROXY_END_TIMEOUT_SEC 10
55 //#define DHCP_PROXY_END_TIMEOUT_SEC 8 /* as per PXE spec */
56
57 /*
58 * A ProxyDHCP request timeout should not induce a failure condition,
59 * so we always want to break before the above set of timers expire.
60 * The iPXE default value of 2 breaks at the first timeout after 2
61 * seconds, which will be after the 2 second timeout.
62 */
63 #define DHCP_REQ_PROXY_TIMEOUT_SEC 2
64 //#define DHCP_REQ_PROXY_TIMEOUT_SEC 7 /* as per PXE spec */
65
66 /*
67 * Per the PXE spec, a PXE boot server request is also be retried 4
68 * times at timeouts of 1, 2, 3, 4. iPXE uses the same timeouts as
69 * discovery, 1, 2, 4, 8, but will move on to the next server if
70 * available after an elapsed time greater than 3 seconds, therefore
71 * effectively only sending 3 tries at timeouts of 1, 2, 4.
72 */
73 #define PXEBS_START_TIMEOUT_SEC 1
74 #define PXEBS_END_TIMEOUT_SEC 10
75 //#define PXEBS_START_TIMEOUT_SEC 0 /* as per PXE spec */
76 //#define PXEBS_END_TIMEOUT_SEC 8 /* as per PXE spec */
77
78 /*
79 * Increment to the next PXE Boot server, if available, after this
80 * this much time has elapsed.
81 */
82 #define PXEBS_MAX_TIMEOUT_SEC 3
83 //#define PXEBS_MAX_TIMEOUT_SEC 7 /* as per PXE spec */
84
85 #include <config/local/dhcp.h>
86
87 #endif /* CONFIG_DHCP_H */