Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 1 | # Sample udhcpd configuration file (/etc/udhcpd.conf) |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 2 | # Values shown are defaults |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 3 | |
| 4 | # The start and end of the IP lease block |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 5 | start 192.168.0.20 |
| 6 | end 192.168.0.254 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 7 | |
| 8 | # The interface that udhcpd will use |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 9 | interface eth0 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 10 | |
Denys Vlasenko | 777706c | 2010-03-19 23:42:23 +0100 | [diff] [blame] | 11 | # The maximum number of leases (includes addresses reserved |
| 12 | # by OFFER's, DECLINE's, and ARP conflicts). Will be corrected |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 13 | # if it's bigger than IP lease block, but it ok to make it |
| 14 | # smaller than lease block. |
| 15 | #max_leases 254 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 16 | |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 17 | # The amount of time that an IP will be reserved (leased to nobody) |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 18 | # if a DHCP decline message is received (seconds) |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 19 | #decline_time 3600 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 20 | |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 21 | # The amount of time that an IP will be reserved |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 22 | # if an ARP conflict occurs (seconds) |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 23 | #conflict_time 3600 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 24 | |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 25 | # How long an offered address is reserved (seconds) |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 26 | #offer_time 60 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 27 | |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 28 | # If client asks for lease below this value, it will be rounded up |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 29 | # to this value (seconds) |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 30 | #min_lease 60 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 31 | |
Denys Vlasenko | 14b162f | 2011-05-04 21:17:23 +0200 | [diff] [blame] | 32 | # The location of the pid file |
| 33 | #pidfile /var/run/udhcpd.pid |
| 34 | |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 35 | # The location of the leases file |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 36 | #lease_file /var/lib/misc/udhcpd.leases |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 37 | |
Denys Vlasenko | 14b162f | 2011-05-04 21:17:23 +0200 | [diff] [blame] | 38 | # The time period at which udhcpd will write out leases file. |
| 39 | # If this is 0, udhcpd will never automatically write leases file. |
| 40 | # Specified in seconds. |
| 41 | #auto_time 7200 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 42 | |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 43 | # Every time udhcpd writes a leases file, the below script will be called |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 44 | #notify_file # default: no script |
| 45 | #notify_file dumpleases # useful for debugging |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 46 | |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 47 | # The following are bootp specific options |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 48 | # next server to use in bootstrap |
| 49 | #siaddr 192.168.0.22 # default: 0.0.0.0 (none) |
| 50 | # tftp server name |
| 51 | #sname zorak # default: none |
| 52 | # tftp file to download (e.g. kernel image) |
| 53 | #boot_file /var/nfs_root # default: none |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 54 | |
Denys Vlasenko | 87fa216 | 2010-03-20 18:06:23 +0100 | [diff] [blame] | 55 | # Static leases map |
| 56 | #static_lease 00:60:08:11:CE:4E 192.168.0.54 |
| 57 | #static_lease 00:60:08:11:CE:3E 192.168.0.44 |
| 58 | |
Denys Vlasenko | 777706c | 2010-03-19 23:42:23 +0100 | [diff] [blame] | 59 | # The remainder of options are DHCP options and can be specified with the |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 60 | # keyword 'opt' or 'option'. If an option can take multiple items, such |
| 61 | # as the dns option, they can be listed on the same line, or multiple |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 62 | # lines. |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 63 | # Examples: |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 64 | opt dns 192.168.10.2 192.168.10.10 |
| 65 | option subnet 255.255.255.0 |
| 66 | opt router 192.168.10.2 |
| 67 | opt wins 192.168.10.10 |
Denys Vlasenko | 777706c | 2010-03-19 23:42:23 +0100 | [diff] [blame] | 68 | option dns 129.219.13.81 # appended to above DNS servers for a total of 3 |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 69 | option domain local |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 70 | option lease 864000 # default: 10 days |
Michael McTernan | 7b57ff4 | 2011-12-16 17:05:52 +0100 | [diff] [blame] | 71 | option msstaticroutes 10.0.0.0/8 10.127.0.1 # single static route |
| 72 | option staticroutes 10.0.0.0/8 10.127.0.1, 10.11.12.0/24 10.11.12.1 |
Denys Vlasenko | 2903469 | 2010-04-04 15:38:22 +0200 | [diff] [blame] | 73 | # Arbitrary option in hex form: |
| 74 | option 0x08 01020304 # option 8: "cookie server IP addr: 1.2.3.4" |
Russ Dill | 61fb489 | 2002-10-14 21:41:28 +0000 | [diff] [blame] | 75 | |
Denys Vlasenko | 2b0e957 | 2009-06-17 13:22:26 +0200 | [diff] [blame] | 76 | # Currently supported options (for more info, see options.c): |
Denys Vlasenko | 0f62c4d | 2010-03-20 07:12:21 +0100 | [diff] [blame] | 77 | #opt lease NUM |
| 78 | #opt subnet IP |
| 79 | #opt broadcast IP |
| 80 | #opt router IP_LIST |
| 81 | #opt ipttl NUM |
| 82 | #opt mtu NUM |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 83 | #opt hostname STRING # client's hostname |
| 84 | #opt domain STRING # client's domain suffix |
| 85 | #opt search STRING_LIST # search domains |
Denys Vlasenko | 0f62c4d | 2010-03-20 07:12:21 +0100 | [diff] [blame] | 86 | #opt nisdomain STRING |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 87 | #opt timezone NUM # (localtime - UTC_time) in seconds. signed |
| 88 | #opt tftp STRING # tftp server name |
| 89 | #opt bootfile STRING # tftp file to download (e.g. kernel image) |
| 90 | #opt bootsize NUM # size of that file |
| 91 | #opt rootpath STRING # (NFS) path to mount as root fs |
Denys Vlasenko | 0f62c4d | 2010-03-20 07:12:21 +0100 | [diff] [blame] | 92 | #opt wpad STRING |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 93 | #opt serverid IP # default: server's IP |
| 94 | #opt message STRING # error message (udhcpd sends it on success too) |
Nigel Hathaway | fb6b173 | 2011-04-26 02:50:00 +0200 | [diff] [blame] | 95 | #opt vlanid NUM # 802.1P VLAN ID |
| 96 | #opt vlanpriority NUM # 802.1Q VLAN priority |
Denys Vlasenko | 0f62c4d | 2010-03-20 07:12:21 +0100 | [diff] [blame] | 97 | # Options specifying server(s) |
| 98 | #opt dns IP_LIST |
| 99 | #opt wins IP_LIST |
| 100 | #opt nissrv IP_LIST |
Denys Vlasenko | e5ce91b | 2010-03-21 00:43:11 +0100 | [diff] [blame] | 101 | #opt ntpsrv IP_LIST |
Denys Vlasenko | 0f62c4d | 2010-03-20 07:12:21 +0100 | [diff] [blame] | 102 | #opt lprsrv IP_LIST |
| 103 | #opt swapsrv IP |
Nigel Hathaway | fb6b173 | 2011-04-26 02:50:00 +0200 | [diff] [blame] | 104 | # Options specifying routes |
| 105 | #opt routes IP_PAIR_LIST |
Michael McTernan | 7b57ff4 | 2011-12-16 17:05:52 +0100 | [diff] [blame] | 106 | #opt staticroutes STATIC_ROUTES # RFC 3442 classless static route option |
| 107 | #opt msstaticroutes STATIC_ROUTES # same, using MS option number |
Denys Vlasenko | e5ce91b | 2010-03-21 00:43:11 +0100 | [diff] [blame] | 108 | # Obsolete options, no longer supported |
Denys Vlasenko | 2e7aa92 | 2010-03-21 02:22:07 +0100 | [diff] [blame] | 109 | #opt logsrv IP_LIST # 704/UDP log server (not syslog!) |
| 110 | #opt namesrv IP_LIST # IEN 116 name server, obsolete (August 1979!!!) |
| 111 | #opt cookiesrv IP_LIST # RFC 865 "quote of the day" server, rarely (never?) used |
| 112 | #opt timesrv IP_LIST # RFC 868 time server, rarely (never?) used |
Nigel Hathaway | fb6b173 | 2011-04-26 02:50:00 +0200 | [diff] [blame] | 113 | # TODO: in development |
| 114 | #opt userclass STRING # RFC 3004. set of LASCII strings. "I am a printer" etc |
| 115 | #opt sipserv STRING LIST # RFC 3361. flag byte, then: 0: domain names, 1: IP addrs |