dnsmax.pl Readme
------------------
The dnsmax.pl perl script is a dynamic DNS update client that is 
compatible with the dnsmax.com and thatip.com DNS services.

dnsmax.pl is responsible for keeping your DNS records pointed
at your current IP address. When run, the program checks to see
whether your IP address has changed since the last time an 
update was sent to our servers. If it has, the program sends
an update.

The program should be scheduled to run every few minutes.


GETTING STARTED
-----------------
You may need to install some perl modules in order for dnsmax.pl
to function. Please see the INSTALL file for details.

Follow these steps to start using dnsmax.pl.

1.  Run `./dnsmax.pl --configure`. Enter your account information
    as prompted.

2.  Run `./dnsmax.pl --fetchhosts`. Any dynamic DNS records that 
    you have configured in your account will be downloaded into
    your configuration files.

3.  Run `./dnsmax.pl --choosehosts`. Follow the instructions to 
    determine which of your hosts should be updated on this 
    computer.

4.  Add a crontab entry to run 
        `/path/to/perl /path/to/dnsmax.pl --updateip`
    every few minutes. 


USAGE SUMMARY
---------------
Usage:  dnsmax.pl MODE [configuration_file]

Available Modes

--configure   Create or edit a configuration file; set the account's
              user name, password, and other settings.
--fetchhosts  Retrieve the latest list of dynamic DNS records for
              the configured account. Determine which records
              should be updated when an IP change is detected.
--choosehosts Choose which hosts will be updated when an IP change is
              detected.
--updateip    Determine whether the network's IP has changed since the
              the last time it was checked, and send an update if
              necessary.

If configuration_file is not specified, a file named dnsmax.conf located
in the working directory will be assumed.

