README

   1 odhcp6c - Embedded DHCPv6 Client
   2
   3
   4 ** Abstract **
   5
   6 odhcp6c is a minimalistic DHCPv6 client for use in embedded Linux systems.
   7
   8
   9 ** Features **
  10
  11 1. Handling of non-temporary addresses
  12         a) assignment of addresses to source interface
  13         b) handling of valid and preferred lifetimes
  14         c) duplicate address detection
  15
  16 2. Handling of IPv6-Prefixes (Prefix Delegation)
  17         a) requesting of prefixes
  18
  19 3. Stateless fallback-support
  20
  21 4. State script support
  22
  23
  24 ** Compiling **
  25
  26 odhcp6c uses cmake:
  27 * To prepare a Makefile use:  "cmake ."
  28 * To build / install use: "make" / "make install" afterwards.
  29 * To build DEB or RPM packages use: "make package" afterwards.
  30
  31
  32 ** State Script **
  33
  34 The state script is called whenever the DHCPv6 state changes.
  35 The script is called with the following parameters: <interface> <state>
  36
  37
  38 States:
  39 * bound                 A suitable server was found and addresses or prefixes acquired
  40 * informed              A stateless information request returned updated information
  41 * timeout               The DHCPv6 operation did not succeed within the defined time
  42 * updated               Updated information was received from the DHCPv6 server
  43 * rebound               The DHCPv6 client switched to another server
  44 * unbound               The DHCPv6 client lost all DHCPv6 servers and will restart
  45
  46
  47 Environment:
  48 * RDNSS                 A space-separated list of recursive DNS servers
  49 * DOMAINS               A space-separated list of DNS search domains
  50 * OPTION_<num>  Custom option received as base-16
  51 * PREFIXES              A space-separated list of prefixes currently assigned
  52                                 Format: <prefix>/<length>,preferred,valid
  53 * PREFIXES_LOST A space-separated list of prefixes lost since last update
  54
  55
  56
  57
  58 ** Wishlist **
  59
  60 Features that I would like to see implemented in the near or far future:
  61
  62 * Reconfigure Authentication