[dhcp-agent-commits] dhcp-agent INSTALL,NONE,1.1 Makefile.am,1.5,1.6 README,1.4,1.5 TODO,1.10,1.11

[<act...@us...>]

Update of /cvsroot/dhcp-agent/dhcp-agent
In directory sc8-pr-cvs1:/tmp/cvs-serv28236

Modified Files:
	Makefile.am README TODO 
Added Files:
	INSTALL 
Log Message:
updated top level documentation

--- NEW FILE: INSTALL ---
dhcp-agent
----------

Prerequisites
-------------

You can download a copy of dhcp-agent from:

http://dhcp-agent.sourceforge.net/

You will also need libdnet, libpcap, and guile from the following locations:

    * libdnet version 1.7 or higher: 
      http://libdnet.sourceforge.net/

    * libpcap version 0.6.2 or higher: 
      http://www.tcpdump.org/

    * guile version 1.6.4 or higher: 
      http://www.gnu.org/software/guile/guile.html

Some of these libraries may already be installed on your
system. You should only upgrade them if necessary.

libdnet and guile both come with utilities to tell you which
version you have installed. You can check with the following:

dnet-config --version
guile-config --version

libpcap comes with no such tool (at the time of writing). Usually
older versions of libpcap will suffice. If you encounter bugs or
compile errors you think are related to pcap, then please
upgrade.

It is recommended that you use GNU make if you encounter any errors
during the build process. You can get GNU make and lots of other
GNU software from:

http://www.gnu.org/

Building and Installing
-----------------------

To build simply: "./configure; make;"

To install: "make install;"

Before installing please uninstall any previous distribution of
dhcp-agent, or dhcp suite package. Make sure you also disabled
any dhcp client or server running on the host.

Additional Configuration Options
--------------------------------

The following options are specific to dhcp-agent:


--enable-htmldoc:

        This enables the generation of HTML documentation from
        the texinfo pages. You will need texi2html installed.

        If texi2html is not installed you can get a copy from:

                http://www.mathematik.uni-kl.de/~obachman/Texi2html

-- 
Thamer Alharbash <tm...@wh...>

Index: Makefile.am
===================================================================
RCS file: /cvsroot/dhcp-agent/dhcp-agent/Makefile.am,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** Makefile.am	18 May 2003 02:58:25 -0000	1.5
--- Makefile.am	20 May 2003 00:34:29 -0000	1.6
***************
*** 5,9 ****
  
  AUTOMAKE_OPTIONS = foreign
! SUBDIRS = src man tests conf
! EXTRA_DIST = CAVEATS LICENSE README THANKS TODO UPGRADING
  CLEANFILES = stdint_marcos.h
--- 5,9 ----
  
  AUTOMAKE_OPTIONS = foreign
! SUBDIRS = src man tests conf doc
! EXTRA_DIST = CAVEATS LICENSE README THANKS TODO UPGRADING INSTALL
  CLEANFILES = stdint_marcos.h

Index: README
===================================================================
RCS file: /cvsroot/dhcp-agent/dhcp-agent/README,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** README	30 Dec 2002 00:44:15 -0000	1.4
--- README	20 May 2003 00:34:29 -0000	1.5
***************
*** 8,12 ****
  dhcp-agent will be a complete DHCP client/server suite, with a
  number of tools for network troubleshooting, and configuration. In
! its current state a simple dhcp sniffer and an alpha-quality dhcp
  client have been implemented.
  
--- 8,12 ----
  dhcp-agent will be a complete DHCP client/server suite, with a
  number of tools for network troubleshooting, and configuration. In
! its current state a simple dhcp sniffer and an beta-quality dhcp
  client have been implemented.
  
***************
*** 17,95 ****
  client on a production machine.
  
! Portability
! -----------
! 
! Although the current distribution is in alpha state, we are
! porting it about. You can help too. Tests have been run
! successfully on:
! 
! Linux 2.4.x     (Heavily pillaged Slackware 8.1)
! Linux 2.2.x     (Heavily pillaged Slackware 8.0)
! FreeBSD-4.6     (Stock installation with dhclient killed)
! OpenBSD-3.1     (Stock installation with dhclient killed)
! 
! dhcp-agent relies on two portable networking libraries: libpcap and
! libdnet.
! 
! You need the latest copy of libpcap, or libpcap 0.6.2. Older libpcap
! distributions may work, but if you encounter any trouble please
! upgrade to 0.6.2 or later. You may find the latest distribution of
! libpcap at:
! 
! http://www.tcpdump.org/
! 
! You will also need Dug Song's libdnet (1.5 or higher).
! 
! http://libdnet.sourceforge.net/
! 
! Please note that if you wish to get dhcp-agent ported to another
! operating system, you should first check if libdnet and libpcap
! can be ported to that system. dhcp-agent relies on these two
! libraries for a portable raw network layer as well as a portable
! method of setting up networking.
! 
! See the CAVEATS file for more known issues.
! 
! Building and Installing
! -----------------------
! 
! To build simply: "./configure; make;"
! 
! To install: "make install;"
! 
! Before installing please uninstall any previous distribution of
! dhcp-agent, or dhcp suite package. Make sure you have also
! disabled any dhcp client or server running on the host.
! 
! Uninstalling
! -------------
! 
! To uninstall dhcp-agent just type "make uninstall" 
! 
! Using dhcp-sniff to sniff for packets.
! -------------------------------------
! 
! Read the man page for dhcp-sniff for command line options.
! 
! Simply run dhcp-sniff with no arguments to have it sniff the first
! ethernet interface it finds. You need to run this as root since
! it needs access to a packet capturing device.
! 
! Using dhcp-client
! ----------------
! 
! Read the man page for dhcp-client for command line options.
  
! dhcp-client currently only sets up the interface, routing, and domain
! name system if the appropriate DHCP options are received. More
! options will be added later.
  
! dhcp-client is still a bit finnicky about which interface it
! picks. Use the -i option to force it to choose an interface. Or
! down the ethernet interface you wish to use and it will
! automatically detect a downed ethernet interface.
  
! We're still working on a nicer way of making things
! automagic. Feel free to offer your suggestions.
  
  Support
--- 17,30 ----
  client on a production machine.
  
! Read the INSTALL file for instructions on compiling and installing dhcp-agent.
  
! Supported Platforms
! -------------------
  
! dhcp-agent has been tested on:
  
! Linux 2.4.x
! FreeBSD 4.x
! Solaris 2.8 (sparc)
  
  Support
***************
*** 129,131 ****
--- 64,67 ----
  a warm fuzzy feeling.
  
+ -- 
  Thamer Alharbash <sh...@wh...>

Index: TODO
===================================================================
RCS file: /cvsroot/dhcp-agent/dhcp-agent/TODO,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** TODO	11 May 2003 07:53:27 -0000	1.10
--- TODO	20 May 2003 00:34:29 -0000	1.11
***************
*** 79,80 ****
--- 79,82 ----
  
  -- may start using guile hooks instead of loading a guile script.
+ 
+ -- fix message levels to have default of info.