DialupDNS Client
Version 1.0.0

Copyright (C) 1999 Kev Vance <kvance@zeux.org>

1. INTRODUCTION
The DialupDNS client is a UNIX program for interfacing with the dynamic DNS service at
http://www.dialupdns.com/  The protocol it uses, while not documented anywhere, is
quite simple and the client was banged out in a matter of hours.

2. INSTALLATION
To install this program, uncompress and untar the package into your sources directory.
% tar xvzf dialupdns-1.0.0.tar.gz

Change to the directory it creates.
% cd dialupdns-1.0.0

Compile the program with a simple "make"
% make

If all is successful, switch to root (if you're not already)...
% su -

...and install it with a "make install"
% make install

3. CONFIGURATION
Before you can run the program, you must make a simple configuration file.  Create the
file ".dialupdns" in your homedir.  It is in the format of:

User: <USERNAME>
Password: <PASSWD>

USERNAME is your DialupDNS username and PASSWD is the password associated with it.

Make sure the permissions of .dialupdns are 600 so that naughty users can't comandeer
your password.

4. USAGE
Now that you've created your config file, you can run the DialupDNS client.  This should
only be run when your IP address has changed.  Otherwise, it's just strain on DialupDNS's
server.  To update your entry, simply run:
% dialupdns -u

It should connect, update your IP, and return you to your shell.  The program has really
forked off and keeps an open connection with DialupDNS, though.  As far as I can tell, it
keeps your DNS updated until you close the socket, at which point your DNS name resolves
to their IP instead.

When you disconnect, you must kill off the dialupdns process.  A simple "killall
dialupdns" should do.  It makes a lockfile in your homedir to make sure that you don't
accidently run a bunch of copies at once.

5. CONTACT
You can reach me via email at kvance@zeux.org.  Please send me comments and especially
bugreports & patches.  If you wish to discuss world domination or hostile corporate
takeovers, please consider using GNU Privacy Guard to encrypt the messages.  My public
key can be found by fingering kvance@tekktonik.dynip.com.

You may also find me on pfNet IRC (irc.pfnet.org) as CapnKev in #megazeux

6. 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 2 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, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
