1 .TH UDHCPC 8 2001-09-26 GNU/Linux "GNU/Linux Administrator's Manual"
3 udhcpc \- very small DHCP client
8 The udhcp client negotiates a lease with the DHCP server and
9 executes a script when it is obtained or lost.
12 .BI \-c\ CLIENTID ,\ \-\-clientid= CLIENTID
13 Send the client identifier
16 .BR -f ,\ \-\-foreground
17 Do not fork after obtaining a lease.
19 .BI \-H\ HOSTNAME ,\ \-\-hostname= HOSTNAME
20 Send the client hostname
27 .BI \-i\ INTERFACE ,\ \-\-interface= INTERFACE
32 Exit with failure if a lease cannot be obtained.
34 .BI \-p\ FILE ,\ \-\-pidfile= FILE
35 Write the process ID of the daemon to
39 Exit after obtaining a lease.
41 .BI \-r\ ADDRESS ,\ \-\-request= ADDRESS
45 .BI \-s\ FILE ,\ \-\-script= FILE
54 executes a script. There are four possible arguments to this
61 starts, and when a lease is lost. The script should put the
62 interface in an up, but deconfigured, state.
68 moves from an unbound to a bound state. The script should
69 configure the interface and set any other relevant parameters
70 (e.g., default gateway, dns server, etc.).
76 when a lease is renewed. The interface is already
77 configured, so the IP address will not change. Other parameters
78 (e.g., default gateway, subnet mask, dns server) may.
84 receieves a NAK packet from the server. The
87 will contain the reason for the
88 NAK message if the server included one. Processing this message
89 is optional, as the script will also be called with deconfig if
92 Parameters are passed to the script via the following environment
96 The inherited HOME, or "/" if it is unset.
99 The inherited PATH, or "/bin:/usr/bin:/sbin:/usr/sbin" if it is
106 The client IP address.
109 The BOOTP next server option.
112 The BOOTP server name option.
115 The BOOTP boot file option.
121 The timezone offset from UTC in seconds.
127 The list of time servers.
130 The list of IEN 116 name servers.
133 The list of DNS servers.
136 The list of MIT-LCS UDP log servers.
139 The list of RFC 865 cookie servers.
142 The list of LPR servers.
148 The length in 512-octet blocks of the bootfile.
151 The domain name of the network.
154 The client's swap server.
157 The path of the client's root dist.
166 The broadcast address.
169 The list of NTP servers.
172 The list of WINS servers.
175 The lease time in seconds.
178 The DHCP message type (safely ignored).
181 The server IP address.
184 Reason for a DHCPNAK.
187 The TFTP server name.
193 .I /etc/udhcpc/default.script
194 Script run when leases are obtained or lost.
197 responds to the following signals:
202 to renew the current lease or, if it does not have one, obtain a
208 to release the current lease.