net-dhcp 1.0.0

data/.document

@@ -0,0 +1,11 @@
+# .document is used by rdoc and yard to know how to generate documentation 
+# for example, it can be used to control how rdoc gets built when you do `gem install foo`
+
+README.rdoc
+lib/**/*.rb
+bin/*
+
+# Files below this - are treated as 'extra files', and aren't parsed for ruby code
+- 
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,40 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+#
+# For TextMate
+#*.tmproj
+#tmtags
+#
+# For emacs:
+#*~
+#\#*
+#.\#*
+#
+# For vim:
+#*.swp

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in net-dhcp.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,12 @@
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.

data/README

@@ -0,0 +1,14 @@
+Net::DHCP library for ruby, originally written by etd.
+Fork to github by syonbori.
+Additional fork and gemification by mjtko.
+
+Here is original README:
+The svn repository for Net::DHCP contains the project files to use with NetBeans IDE.
+
+Use "rake" in the /lib folder to generate rdoc documentation.
+
+Expect lots of changes in the near future both to the folder structure and the project architecture :)
+
+Have fun,
+
+etd

data/README.etd.original

@@ -0,0 +1,9 @@
+The svn repository for Net::DHCP contains the project files to use with NetBeans IDE.
+
+Use "rake" in the /lib folder to generate rdoc documentation.
+
+Expect lots of changes in the near future both to the folder structure and the project architecture :)
+
+Have fun,
+
+etd

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+rescue LoadError
+  $stderr.puts "You must install bundler - run `gem install bundler`"
+end
+
+begin
+  Bundler.setup
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'bueller'
+Bueller::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:examples) do |examples|
+  examples.rspec_opts = '-Ispec'
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.rspec_opts = '-Ispec'
+  spec.rcov = true
+end
+
+task :default => :examples
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "net-dhcp #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/bin/net-dhcp

@@ -0,0 +1,37 @@
+# main.rb
+# 4 de octubre de 2007
+#
+
+require 'dhcp'
+require 'socket'
+require 'pcaplet'
+
+server_thread = Thread.new do
+  s = "Packets received by the filter:\n"
+  s << '-'*s.size + "\n"
+  
+  dhcpdump = Pcaplet.new('-s 4096')
+
+  DHCP_PACKET  = Pcap::Filter.new('port 67 or port 68', dhcpdump.capture)
+
+  dhcpdump.add_filter(DHCP_PACKET)
+  dhcpdump.each_packet {|pkt|
+    msg = DHCP::Message.from_udp_payload(pkt.udp_data)
+    
+    s << "#{pkt.src}:#{pkt.sport} > #{pkt.dst}:#{pkt.dport}\n"
+    s << msg.to_s
+    puts s if s
+  }
+end
+
+discover = DHCP::Discover.new
+payload = discover.pack
+
+
+sckt = UDPSocket.new
+sckt.setsockopt(Socket::SOL_SOCKET, Socket::SO_BROADCAST,true)
+sckt.bind('', 68)
+sckt.send(payload, 0, "<broadcast>", 67)
+
+trap('INT') {server_thread.kill}
+server_thread.join

data/lib/net-dhcp.rb

@@ -0,0 +1,2 @@
+require 'net-dhcp/version'
+require 'net/dhcp'

data/lib/net-dhcp/version.rb

@@ -0,0 +1,5 @@
+module Net
+  module Dhcp
+    VERSION = "1.0.0"
+  end
+end

data/lib/net/dhcp.rb

@@ -0,0 +1,48 @@
+=begin
+**
+** dhcp.rb
+** 31/OCT/2007
+** ETD-Software
+**  - Daniel Martin Gomez <etd[-at-]nomejortu.com>
+**
+** Desc:
+**   This package provides a set of classes to work with the DHCP protocol. They
+** provide low level access to all the fields and internals of the protocol.
+**
+** See the provided rdoc comments for further information.
+**
+** More information in:
+**   - rfc2131: Dynamic Host Configuration Protocol
+**   - rfc2132: DHCP Options and BOOTP Vendor Extensions
+**   - rfc2563: DHCP Option to Disable Stateless Auto-Configuration in
+**              IPv4 Clients
+**   - rfc4578: DHCP Options for the Intel Preboot eXecution Environment (PXE)
+**   - rfc4702: The DHCP Client Fully Qualified Domain Name (FQDN) Option
+**
+** Version:
+**  v1.0 [31/October/2007]: first released
+**
+** License:
+**    This program is free software: you can redistribute it and/or modify
+**  it under the terms of the GNU General Public License as published by
+**  the Free Software Foundation, either version 3 of the License, or
+**  (at your option) any later version.
+**
+**  This program is distributed in the hope that it will be useful,
+**  but WITHOUT ANY WARRANTY; without even the implied warranty of
+**  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**  GNU General Public License for more details.
+**
+**  You should have received a copy of the GNU General Public License
+**  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+**
+=end
+
+# constants defining the values in the different fields of the protocols
+require 'net/dhcp/constants'
+
+# DHCP options as defined in rfc2132 and rfc2563
+require 'net/dhcp/options'
+
+# DHCP messages as defined in rfc2131
+require 'net/dhcp/core'

data/lib/net/dhcp/constants.rb

@@ -0,0 +1,182 @@
+=begin
+**
+** constants.rb
+** 04/OCT/2007
+** ETD-Software
+**  - Daniel Martin Gomez <etd[-at-]nomejortu.com>
+**
+** Desc:
+**   This file provides a set of classes to work with the DHCP protocol. They
+** provide low level access to all the fields and internals of the protocol.
+**
+** See the provided rdoc comments for further information.
+**
+** More information in:
+**   - rfc2131: Dynamic Host Configuration Protocol
+**   - rfc2132: DHCP Options and BOOTP Vendor Extensions
+**   - rfc2563: DHCP Option to Disable Stateless Auto-Configuration in
+**              IPv4 Clients
+**
+** Version:
+**  v1.0 [04/October/2007]: first released
+**
+** License:
+**   Please see dhcp.rb or LICENSE.txt for copyright and licensing information.
+**
+=end
+
+# --------------------------------------------------------------- dhcp messages
+
+# operations ('op' field)
+$DHCP_OP_REQUEST=      0x01
+$DHCP_OP_REPLY=        0x02
+
+# message types
+$DHCP_MSG_DISCOVER=    0x01
+$DHCP_MSG_OFFER=       0x02
+$DHCP_MSG_REQUEST=     0x03
+$DHCP_MSG_DECLINE=     0x04
+$DHCP_MSG_ACK=         0x05
+$DHCP_MSG_NACK=        0x06
+$DHCP_MSG_RELEASE=     0x07
+$DHCP_MSG_INFORM=      0x08
+$DHCP_MSG_NAMES = [
+  'DHCP Discover',
+  'DHCP Offer',
+  'DHCP Request',
+  'DHCP Decline',
+  'DHCP ACK',
+  'DHCP NAK',
+  'DHCP Release',
+  'DHCP Inform'
+]
+
+# ---------------------------------------------------------------- other fields
+
+# hardware types. see "Number Hardware Type (hrd)" in rfc 1700.
+$DHCP_HTYPE_ETHERNET = 0x01
+$DHCP_HLEN_ETHERNET = 0x06
+
+
+$DHCP_MAGIC=          0x63825363
+$BOOTP_MIN_LEN=       0x12c
+$DHCP_PAD=            0x00
+
+# as defined in rfc2132
+$DHCP_SUBNETMASK=     0x01
+$DHCP_TIMEOFFSET=     0x02
+$DHCP_ROUTER=         0x03
+$DHCP_TIMESERVER=     0x04
+$DHCP_NAMESERVER=     0x05
+$DHCP_DNS=            0x06
+$DHCP_LOGSERV=        0x07
+#$DHCP_COOKIESERV=     0x08
+$DHCP_QUOTESSERV=     0x08
+$DHCP_LPRSERV=        0x09
+$DHCP_IMPSERV=        0x0a
+$DHCP_RESSERV=        0x0b
+$DHCP_HOSTNAME=       0x0c
+$DHCP_BOOTFILESIZE=   0x0d
+$DHCP_DUMPFILE=       0x0e
+$DHCP_DOMAINNAME=     0x0f
+$DHCP_SWAPSERV=       0x10
+$DHCP_ROOTPATH=       0x11
+$DHCP_EXTENPATH=      0x12
+$DHCP_IPFORWARD=      0x13
+$DHCP_SRCROUTE=       0x14
+$DHCP_POLICYFILTER=   0x15
+$DHCP_MAXASMSIZE=     0x16
+$DHCP_IPTTL=          0x17
+$DHCP_MTUTIMEOUT=     0x18
+$DHCP_MTUTABLE=       0x19
+$DHCP_MTUSIZE=        0x1a
+$DHCP_LOCALSUBNETS=   0x1b
+$DHCP_BROADCASTADDR=  0x1c
+$DHCP_DOMASKDISCOV=   0x1d
+$DHCP_MASKSUPPLY=     0x1e
+$DHCP_DOROUTEDISC=    0x1f
+$DHCP_ROUTERSOLICIT=  0x20
+$DHCP_STATICROUTE=    0x21
+$DHCP_TRAILERENCAP=   0x22
+$DHCP_ARPTIMEOUT=     0x23
+$DHCP_ETHERENCAP=     0x24
+$DHCP_TCPTTL=         0x25
+$DHCP_TCPKEEPALIVE=   0x26
+$DHCP_TCPALIVEGARBAGE=0x27
+$DHCP_NISDOMAIN=      0x28
+$DHCP_NISSERVERS=     0x29
+$DHCP_NISTIMESERV=    0x2a
+$DHCP_VENDSPECIFIC=   0x2b
+$DHCP_NBNS=           0x2c
+$DHCP_NBDD=           0x2d
+$DHCP_NBTCPIP=        0x2e
+$DHCP_NBTCPSCOPE=     0x2f
+$DHCP_XFONT=          0x30
+$DHCP_XDISPLAYMGR=    0x31
+$DHCP_DISCOVERADDR=   0x32
+$DHCP_LEASETIME=      0x33
+$DHCP_OPTIONOVERLOAD= 0x34
+$DHCP_MESSAGETYPE=    0x35
+$DHCP_SERVIDENT=      0x36
+$DHCP_PARAMREQUEST=   0x37
+$DHCP_MESSAGE=        0x38
+$DHCP_MAXMSGSIZE=     0x39
+$DHCP_RENEWTIME=      0x3a
+$DHCP_REBINDTIME=     0x3b
+$DHCP_CLASSSID=       0x3c
+$DHCP_CLIENTID=       0x3d
+$DHCP_NISPLUSDOMAIN=  0x40
+$DHCP_NISPLUSSERVERS= 0x41
+$DHCP_TFTPSERVER=     0x42
+$DHCP_BOOTFILENAME=   0x43
+$DHCP_MOBILEIPAGENT=  0x44
+$DHCP_SMTPSERVER=     0x45
+$DHCP_POP3SERVER=     0x46
+$DHCP_NNTPSERVER=     0x47
+$DHCP_WWWSERVER=      0x48
+$DHCP_FINGERSERVER=   0x49
+$DHCP_IRCSERVER=      0x4a
+$DHCP_STSERVER=       0x4b
+$DHCP_STDASERVER=     0x4c
+$DHCP_USERCLASS=      0x4d
+$DHCP_PRIVATE=        0xaf
+$DHCP_END=            0xff
+# / as defined in rfc2132
+
+# see http://www.bind9.net/bootp-dhcp-parameters
+
+$DHCP_CLIENTFQDN=     0x51 #rfc4702
+
+
+$DHCP_CLIENTARCH=     0x5d #rfc4578
+$DHCP_CLIENTARCH_I386=     0x0000
+$DHCP_CLIENTARCH_PC98=    0x0001
+$DHCP_CLIENTARCH_ITANIUM= 0x0002
+$DHCP_CLIENTARCH_ALPHA=   0x0003
+$DHCP_CLIENTARCH_X86=     0x0004
+$DHCP_CLIENTARCH_ILC=     0x0005
+$DHCP_CLIENTARCH_IA32=    0x0006
+$DHCP_CLIENTARCH_BC=      0x0007
+$DHCP_CLIENTARCH_XSCALE=  0x0008
+$DHCP_CLIENTARCH_X8664=   0x0009
+$DHCP_CLIENTARCH_NAMES = [
+      'Intel x86PC',
+      'NEC/PC98',
+      'EFI Itanium',
+      'DEC Alpha',
+      'Arc x86',
+      'Intel Lean Client',
+      'EFI IA32',
+      'EFI BC',
+      'EFI Xscale',
+      'EFI x86-64',
+      ]
+
+$DHCP_CLIENTNDI=      0x5e #rfc4578
+#$DHCP_LDAP=           0x5f
+$DHCP_UUIDGUID=       0x61 #rfc4578
+
+$DHCP_AUTOCONF=       0x74 #rfc2563
+$DHCP_AUTOCONF_NO=    0x00 #rfc2563
+$DHCP_AUTOCONF_YES=   0x01 #rfc2563
+

data/lib/net/dhcp/core.rb

@@ -0,0 +1,322 @@
+=begin
+**
+** core.rb
+** 02/OCT/2007
+** ETD-Software
+**  - Daniel Martin Gomez <etd[-at-]nomejortu.com>
+**
+** Desc:
+**   This file provides a set of classes to work with the DHCP protocol. They 
+** provide low level access to all the fields and internals of the protocol.
+** 
+** See the provided rdoc comments for further information.
+**
+** Version:
+**  v1.0 [02/October/2007]: first released
+**  v1.1 [31/October/2007]: file moved under /dhcp/ directory and renamed to
+**                          core.rb. Now it only contains core classes to 
+**                          encapsulate DHCP messages
+**
+** License:
+**   Please see dhcp.rb or LICENSE.txt for copyright and licensing information.
+**
+=end
+
+module DHCP
+  # -------------------------------------------------------------- dhcp messages
+  class Message
+    attr_accessor :op, :htype, :hlen, :hops
+    attr_accessor :xid
+    attr_accessor :secs, :flags
+    attr_accessor :ciaddr, :yiaddr, :siaddr, :giaddr, :chaddr
+    attr_accessor :options
+
+    alias == eql?
+    
+    def Message.from_udp_payload(data)
+      values = data.unpack('C4Nn2N4C16C192NC*')
+
+      params = {
+        :op => values.shift,
+        :htype => values.shift,
+        :hlen => values.shift,
+        :hops => values.shift,
+      
+        :xid => values.shift,
+        :secs => values.shift,
+        :flags => values.shift,
+        :ciaddr => values.shift,
+        :yiaddr => values.shift,
+        :siaddr => values.shift,
+        :giaddr => values.shift,
+        :chaddr => values.slice!(0..15)
+      }
+      
+      # sname and file
+      not_used = values.slice!(0..191)
+      
+      return nil unless ($DHCP_MAGIC == values.shift)
+      
+      #default message class
+      msg_class = Message
+      #default option class
+      opt_class = Option
+      
+      params[:options] = []
+      
+      next_opt = values.shift
+      while(next_opt != $DHCP_END)
+        p = {
+          :type => next_opt,
+          :len => values.shift
+        }
+        p[:payload] = values.slice!(0..p[:len]-1)
+        
+        # check what is the type of dhcp option
+        opt_class = $DHCP_MSG_OPTIONS[p[:type]]
+        if(opt_class.nil?)
+          puts '-------------------- please further investigate!!'
+          puts p[:type]
+          puts '-------------------- /'
+          opt_class == Option
+        end
+        if (opt_class == MessageTypeOption)
+          msg_class = $DHCP_MSG_CLASSES[p[:payload].first]
+        end
+        params[:options] << opt_class.new(p)
+        next_opt = values.shift
+      end
+      
+      if(msg_class.nil?)
+        puts '-------------------- please further investigate!!'
+        p params[:options]
+        puts '-------------------- /'
+        opt_class == Option
+      end
+      msg_class.new(params)
+    end
+  
+    def initialize(params = {})
+    
+      # message operation and options. We need at least an operation and a 
+      # MessageTypeOption to create a DHCP message!!
+      if (([:op, :options]  & params.keys).size != 2)
+        raise ArgumentError('you need to specify at least values for :op and :options') 
+      end
+      
+      self.op = params[:op]
+      
+      self.options = params[:options]
+      found = false
+      self.options.each do |opt|
+        next unless opt.class == MessageTypeOption
+        found = true
+      end
+      raise ArgumentError(':options must include a MessageTypeOption') unless found
+    
+      #hardware type and length of the hardware address
+      self.htype = params.fetch(:htype, $DHCP_HTYPE_ETHERNET)
+      self.hlen = params.fetch(:hlen, $DHCP_HLEN_ETHERNET)
+    
+      # client sets to zero. relay agents may modify
+      self.hops = params.fetch(:hops, 0x00)
+    
+      # initialize a random transaction ID
+      self.xid  = params.fetch(:xid, rand(2**32))
+    
+      # seconds elapsed, flags
+      self.secs = params.fetch(:secs, 0x0000)
+      self.flags = params.fetch(:flags, 0x0000)
+    
+      # client, you, next server  and relay agent addresses
+      self.ciaddr = params.fetch(:ciaddr, 0x00000000)
+      self.yiaddr = params.fetch(:yiaddr, 0x00000000)
+      self.siaddr = params.fetch(:siaddr, 0x00000000)
+      self.giaddr = params.fetch(:giaddr, 0x00000000)
+    
+      if (params.key?(:chaddr))
+        self.chaddr = params[:chaddr]
+        raise 'chaddr field should be of 16 bytes' unless self.chaddr.size == 16
+      else
+        mac = `/sbin/ifconfig | grep HWaddr | cut -c39- | head -1`.chomp.strip.gsub(/:/,'')
+        self.chaddr = [mac].pack('H*').unpack('CCCCCC')
+        self.chaddr += [0x00]*(16-self.chaddr.size)
+      end
+    
+      
+    end
+  
+    def pack()
+      out = [
+      self.op, self.htype, self.hlen, self.hops, 
+      self.xid, 
+      self.secs, self.flags, 
+      self.ciaddr, 
+      self.yiaddr, 
+      self.siaddr, 
+      self.giaddr
+      ].pack('C4Nn2N4')
+
+      out << self.chaddr.pack('C*')
+    
+      
+      # sname and file
+      out << ([0x00]*192).pack('C192')
+    
+      out << [$DHCP_MAGIC].pack('N')
+      self.options.each do |option|
+        out << option.pack
+      end
+      out << [$DHCP_END].pack('C')
+      
+      # add padding up to 300 bytes
+      if out.size < 300
+        out << ([$DHCP_PAD]*(300-out.size)).pack('C*')
+      end
+      return out
+    end
+    
+    def eql?(obj)
+      # objects must be of the same class
+      return false unless (self.class == obj.class)
+      
+      vars1 = self.instance_variables
+      
+      # first make sure that the :options var is equal
+      opt1 = self.instance_variable_get('@options')
+      opt2 = obj.instance_variable_get('@options')
+      
+      return false unless opt1.eql?(opt2)
+      vars1.delete('@options')
+      
+      # check all the other instance vairables
+      vars1.each do |var|
+        return false unless (self.instance_variable_get(var) == obj.instance_variable_get(var))
+      end
+      
+      return true
+    end
+    
+    
+    
+    def to_s
+      out = "DHCP Message\r\n"
+      out << "\tFIELDS:\r\n"
+      out << "\t\tTransaction ID = #{self.xid}\r\n"
+      out << "\t\tClient IP address = #{[self.ciaddr].pack('N').unpack('C4').join('.')}\r\n"
+      out << "\t\tYour IP address = #{[self.yiaddr].pack('N').unpack('C4').join('.')}\r\n"      
+      out << "\t\tNext server IP address = #{[self.siaddr].pack('N').unpack('C4').join('.')}\r\n"
+      out << "\t\tRelay agent IP address = #{[self.giaddr].pack('N').unpack('C4').join('.')}\r\n"      
+      out << "\t\tHardware address = #{self.chaddr.slice(0..(self.hlen-1)).collect do |b| b.to_s(16).upcase.rjust(2,'0') end.join(':')}\r\n"
+      out << "\tOPT:\r\n"
+      self.options.each do |opt|
+        out << "\t\t #{opt.to_s}\r\n"
+      end
+      return out
+    end
+  end
+
+  # Client broadcast to locate available servers.
+  class Discover < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REQUEST
+      # if an :options field is provided, we use it, otherwise, a default is set
+      params[:options] = params.fetch(:options, [MessageTypeOption.new, ParameterRequestListOption.new])
+      super(params)
+    end
+  end
+
+  # Server to client in response to DHCPDISCOVER with offer of configuration
+  # parameters.
+  #
+  # By default an ACK message will contain a Server Identifier (0.0.0.0) and
+  # a Domain Name ('nomejortu.com') option.
+  class Offer < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REPLY
+      params[:options] = params.fetch(:options, [
+      MessageTypeOption.new({:payload=>$DHCP_MSG_OFFER}), 
+      ServerIdentifierOption.new,
+      DomainNameOption.new
+      ])
+      super(params)
+    end        
+  end
+  
+  # Client message to servers either (a) requesting offered parameters from one 
+  # server and implicitly declining offers from all others, (b) confirming
+  # correctness of previously allocated address after, e.g., system reboot, or 
+  # (c) extending the lease on a particular network address.  
+  class Request < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REQUEST
+      params[:options] = params.fetch(:options, [MessageTypeOption.new({:payload=>$DHCP_MSG_REQUEST}), ParameterRequestListOption.new])
+      super(params)
+    end
+  end
+
+  #
+  #   DHCPDECLINE  -  Client to server indicating network address is already
+  #                   in use.
+  
+  # Server to client with configuration parameters, including committed network
+  # address.
+  #
+  # By default an ACK message will contain a Server Identifier (0.0.0.0) and
+  # a Domain Name ('nomejortu.com') option.
+  class ACK < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REPLY
+      params[:options] = params.fetch(:options, [
+      MessageTypeOption.new({:payload=>$DHCP_MSG_ACK}), 
+      ServerIdentifierOption.new,
+      DomainNameOption.new
+      ])
+      super(params)
+    end    
+  end
+  
+  #   DHCPNAK      -  Server to client indicating client's notion of network
+  #                   address is incorrect (e.g., client has moved to new
+  #                   subnet) or client's lease as expired
+
+  # Client to server relinquishing network address and cancelling remaining
+  # lease.
+  #
+  # By default an ACK message will contain a Server Identifier (0.0.0.0)
+  class Release < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REQUEST
+      params[:options] = params.fetch(:options, [
+      MessageTypeOption.new({:payload=>$DHCP_MSG_RELEASE}), 
+      ServerIdentifierOption.new
+      ])
+      super(params)
+    end    
+  end
+  
+  # Client to server, asking only for local configuration parameters; client 
+  # already has externally configured network address.  
+  class Inform < Message
+    def initialize(params={})
+      params[:op] = $DHCP_OP_REQUEST
+      params[:options] = params.fetch(:options, [MessageTypeOption.new({:payload=>$DHCP_MSG_INFORM}), ParameterRequestListOption.new])
+      super(params)
+    end
+  end
+
+  # ------------------------------------ map from values of fields to class names
+
+  $DHCP_MSG_CLASSES = {
+    $DHCP_MSG_DISCOVER  => Discover,
+    $DHCP_MSG_OFFER     => Offer,
+    $DHCP_MSG_REQUEST   => Request,
+    #    $DHCP_MSG_DECLINE=     0x04
+    $DHCP_MSG_ACK       => ACK,
+    #    $DHCP_MSG_NACK=        0x06
+    $DHCP_MSG_RELEASE   => Release,
+    $DHCP_MSG_INFORM    => Inform
+  }
+
+  
+end