blob: b86a9f51f0fbde982fee48c0c0176364540c1872 [file] [log] [blame]
Mike Frysinger7031f622006-05-08 03:20:50 +00001.TH UDHCPD.CONF 5 2001-09-26 GNU/Linux "GNU/Linux Administrator's Manual"
2.SH NAME
3udhcpd.conf \- udhcp server configuration file
4.SH DESCRIPTION
5The file
6.I /etc/udhcpd.conf
7contains configuration information specific to the udhcp server.
8It should contain one configuration keyword per line, followed by
9appropriate configuration information.
10.SH OPTIONS
11.TP
12.BI start\ ADDRESS
13The starting address of the IP lease block is
14.IR ADDRESS .
15The default is
16.BR 192.168.0.20 .
17.TP
18.BI end\ ADDRESS
19The ending address of the IP lease block is
20.IR ADDRESS .
21The default is
22.BR 192.168.0.254 .
23.TP
24.BI interface\ INTERFACE
25The udhcp server should listen on
26.IR INTERFACE .
27The default is
28.BR eth0 .
29.TP
30.BI max_leases\ LEASES
31Offer at most
32.I LEASES
33leases (including those reserved by OFFERs, DECLINEs, and ARP
34conflicts). The default is
35.BR 254 .
36.TP
37.BI remaining\ REMAINING
38If
39.I REMAINING
40is
41.BR yes ,
42store the time remaining for each lease. If it is
43.BR no ,
44store the expiration time for each lease. The default is
45.BR yes .
46.TP
47.BI auto_time\ SECONDS
48Write the lease information to a file every
49.I SECONDS
50seconds. The default is
51.BR 7200 .
52.TP
53.BI decline_time\ SECONDS
54Reserve an IP for
55.I SECONDS
56seconds if a DHCP decline message is received. The default is
57.BR 3600 .
58.TP
59.BI conflict_time\ SECONDS
60Reserve an IP for
61.I SECONDS
62seconds if an ARP conflict occurs. The default is
63.BR 3600 .
64.TP
65.BI offer_time\ SECONDS
66Reserve an IP for
67.I SECONDS
68seconds if it is offered. The default is
69.BR 60 .
70.TP
71.BI min_lease\ SECONDS
72Reserve an IP for the full lease time if the lease to be given is less than
73.I SECONDS
74seconds. The default is
75.BR 60 .
76.TP
77.BI lease_file\ FILE
78Write the lease information to
79.IR FILE .
80The default is
81.BR /var/lib/misc/udhcpd.leases .
82.TP
83.BI pidfile\ FILE
84Write the process ID to
85.IR FILE .
86The default is
87.BR /var/run/udhcpd.pid .
88.TP
89.BI notify_file\ FILE
90Execute
91.I FILE
92after the lease information is written. By default, no file is executed.
93.TP
94.BI siaddr\ ADDRESS
95BOOTP specific option. The default is
96.BR 0.0.0.0 .
97.TP
98.BI sname\ NAME
99BOOTP specific option. There is no default.
100.TP
101.BI boot_file\ FILE
102BOOTP specific option. There is no default.
103.TP
104.BI option\ OPTION
105DHCP specific option.
106.RS
107.TP
108.BI subnet\ ADDRESS
109.TP
110.BI timezone\ OFFSET
111.TP
112.BI router\ ADDRESS...
113.TP
114.BI timesvr\ ADDRESS...
115.TP
116.BI namesvr\ ADDRESS...
117.TP
118.BI dns\ ADDRESS...
119.TP
120.BI logsvr\ ADDRESS...
121.TP
122.BI cookiesvr\ ADDRESS...
123.TP
124.BI lprsvr\ ADDRESS...
125.TP
126.BI hostname\ HOSTNAME
127.TP
128.BI bootsize\ SIZE
129.TP
130.BI domain\ DOMAIN
131.TP
132.BI swapsvr\ ADDRESS
133.TP
134.BI rootpath\ PATH
135.TP
136.BI ipttl\ TTL
137.TP
138.BI mtu\ MTU
139.TP
140.BI broadcast\ ADDRESS
141.TP
142.BI ntpsrv\ ADDRESS...
143.TP
144.BI wins\ ADDRESS...
145.TP
146.BI requestip\ ADDRESS
147.TP
148.BI lease\ SECONDS
149.TP
150.BI dhcptype\ TYPE
151.TP
152.BI serverid\ ADDRESS
153.TP
154.BI tftp\ FILE
155.TP
156.BI bootfile\ FILE
157The default for
158.B lease
159is
160.BR 864000 .
161There are no defaults for the other options.
162.RE
163.SH SEE ALSO
164.BR udhcpd (8).