From e95877ecfa1170d77b1ec1f66752725cdda01b64 Mon Sep 17 00:00:00 2001 From: The Android Open Source Project Date: Tue, 21 Oct 2008 07:00:00 -0700 Subject: Initial Contribution --- README | 69 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..27aadf0 --- /dev/null +++ b/README @@ -0,0 +1,69 @@ +dhcpcd-4 - DHCP client daemon +Copyright 2006-2008 Roy Marples + + +Installation +------------ +Edit config.h to match your building requirements. +Then just make; make install +man dhcpcd for command line options + + +Notes +----- +If you're cross compiling you may need to set the below knobs to avoid +automatic tests. +OS=BSD | Linux + +If size is your thing, you can remove all non-essential userland options +by adding -DMINIMAL to your CPPFLAGS. This currently shaves off around 6k. +You can save a futher 600 bytes or so by using the small make target. + +If you're building for a NOMMU system where fork() does not work, you should +add -DTHERE_IS_NO_FORK to your CPPFLAGS. + +You can change the default dir with these knobs. +For example, to satisfy FHS compliance you would do this:- +LIBEXECDIR=/lib/dhcpcd +DBDIR=/var/lib/dhcpcd + +We now default to using -std=c99. For 64-bit linux, this always works, but +for 32-bit linux it requires either gnu99 or a patch to asm/types.h. +Most distros patch linux headers so this should work fine. +linux-2.6.24 finally ships with a working 32-bit header. +If your linux headers are older, or your distro hasn't patched them you can +set CSTD=gnu99 to work around this. + + +Hooks +----- +Not all the hooks in dhcpcd-hooks are installed by default. +By default we install 01-test, 10-mtu, 20-resolv.conf and 30-hostname. +To add more simply add them in the HOOKSCRIPTS variable. +make HOOKSCRIPTS=50-ntp install + + +Compatibility +------------- +If you require compatibility with dhcpcd-3 and older style variables, +you can install 50-dhcpcd-compat into the directory $LIBEXECDIR/dhcpcd-hooks +We don't install this by default. +You should also add -DCMDLINE_COMPAT to your CPPFLAGS if you need to be fully +commandline compatible with prior versions. + +dhcpcd-3 enabled DUID support by default - this has changed in dhcpcd-4. +You can enable it via the --duid, -D command line option or by using the +duid directive in dhcpcd.conf. +If CMDLINE_COMPAT is defined the we renable DUID support by default IF +the dhcpcd.duid file exits. This keeps the clients working as they were, +which is good. + +dhcpcd-4 is NOT fully commandline compatible with dhcpcd-2 and older and +changes the meaning of some options. + + +ChangeLog +--------- +We no longer supply a ChangeLog. +However, you're more than welcome to read the git commit comments at +http://git.marples.name/?p=dhcpcd/.git;a=summary -- cgit v1.1