ndhc/ndhc
Nicholas J. Kain faa56bb616 Make change_listen_mode() create a new socket instantly rather than
waiting for select loop to cycle again.  Works better in practice
and simplifies the select loop, too.
2010-11-13 12:30:54 -05:00
..
AUTHORS.udhcp Initial commit. 2010-11-12 04:02:18 -05:00
clientpacket.c Clean up send_renew() a bit. 2010-11-13 12:00:06 -05:00
clientpacket.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
CMakeLists.txt Rename dhcpc.c to ndhc.c. 2010-11-12 18:46:02 -05:00
COPYING Initial commit. 2010-11-12 04:02:18 -05:00
dhcpc.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
dhcpd.h Clean dhcpd.h. 2010-11-13 06:48:50 -05:00
MODIFICATIONS Initial commit. 2010-11-12 04:02:18 -05:00
ndhc-defines.h Make write() and sendto() properly handle short writes and errors in ndhc. 2010-11-12 18:44:49 -05:00
ndhc.8 Initial commit. 2010-11-12 04:02:18 -05:00
ndhc.c Make change_listen_mode() create a new socket instantly rather than 2010-11-13 12:30:54 -05:00
options.c Remove leases.h. 2010-11-13 06:45:34 -05:00
options.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
packet.c Add safe_read() to ncmlib and use it in ndhc. 2010-11-13 08:37:33 -05:00
packet.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
README Fix typos in README. 2010-11-12 08:43:46 -05:00
script.c Factor out safe_write() into ncmlib and use it in ndhc as well. 2010-11-13 08:18:23 -05:00
script.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
socket.c Clean up unnecessary goto exit handler in raw_socket(). 2010-11-13 12:11:28 -05:00
socket.h Fix header include guards to not use leading underscores. 2010-11-13 06:51:57 -05:00
TODO Initial commit. 2010-11-12 04:02:18 -05:00

ndhc client
--------------------

The ndhc client negotiates a lease with the DHCP server and notifies
ifchd when a leases is obtained or lost.


command line options
-------------------

The command line options for the ndhc client are:

-c, --clientid=CLIENTID         Client identifier
-H, --hostname=HOSTNAME         Client hostname
-h,				Alias for -H
-f, --foreground                Do not fork after getting lease
-b, --background                Fork to background if lease cannot be
                                immediately negotiated.
-i, --interface=INTERFACE       Interface to use (default: eth0)
-n, --now                       Exit with failure if lease cannot be
                                immediately negotiated.
-q, --quit                      Quit after obtaining lease
-r, --request=IP                IP address to request (default: none)
-v, --version                   Display version


If the requested IP address cannot be obtained, the client accepts the
address that the server offers.


note on ndhc's random seed
---------------------------

ndhc will seed its random number generator (used for generating xids)
by reading /dev/urandom. If you have a lot of embedded systems on the same
network, with no entropy, you can either seed /dev/urandom by a method of
your own, or doing the following on startup:

ifconfig eth0 > /dev/urandom

in order to seed /dev/urandom with some data (mac address) unique to your
system. If reading /dev/urandom fails, ndhc will fall back to its old
behavior of seeding with time(0).


signals accepted by ndhc
-------------------------

ndhc also responds to SIGUSR1 and SIGUSR2. SIGUSR1 will force a renew state,
and SIGUSR2 will force a release of the current lease, and cause ndhc to
go into an inactive state (until it is killed, or receives a SIGUSR1). You do
not need to sleep between sending signals, as signals received are processed
sequentially in the order they are received.