                           IPFN v1.05 by Adam McKee

*** INTRODUCTION **************************************************************

Many ISPs use dynamic IP allocation.  One problem with this is that users
cannot simply advertise a hostname or IP for their machines.  This simple
client/server application is designed to alleviate that problem.  You can
probably guess how it works:

	- The server keeps track of (person name, IP address) pairings.
	- The client can therefore associate an IP address with a person's
	  name by querying the server.

Very simple and (I hope) very useful ;-)


*** USAGE *********************************************************************

--- The Client: ipfn --------------------------------------------------------

The usage is:

	ipfn -s <server> [-p <port>] <request>
	
	<request> ::= A[dd] <passwd> <hours> <host> <name>
		   |  R[emove] <passwd> <name>
		   |  S[earch] <name>

-s <server>:
	A server *must* be specified with the '-s' switch.

-p <port>:
	The default port is 2000.  A different port can be specified with
	the '-p' switch.

A[dd]:
	<passwd>:  A password used to prevent unauthorized parties from
		   deleting the entry.
	 <hours>:  How many hours to keep the entry.  The server will not
		   allow values less than 2 hours or greater than 24 hours.
	  <host>:  The hostname.
          <name>:  The name of the person.

	For example:

	  ipfn -s hup1.usask.ca Add secret 2 janus1-1.usask.ca Adam McKee

R[emove]:
	<passwd>:  An entry cannot be removed without specifying the required
		   password.
	  <name>:  Which entry to remove.

S[earch]:
	  <name>:  The person with whom a hostname/IP is to be associated.

--- The Server: ipfnd -------------------------------------------------------

The usage is:

	ipfnd [-p <port>]

-p <port>:
	The default port is 2000.  A different port can be specified with
	the '-p' switch.

*** INSTALLATION **************************************************************

Red Hat users:

	make depend ; make rpm ; rpm -i ipfn-1.0-1.i386.rpm

Others:

	get Red Hat and do above ;-)
	           -OR-
	make depend ; make install
