EDNSCLI v0.01  Win32 and OS/2 versions
=============

Introduction
------------
EleDynDNS is a free dynamic DNS service offered by www.theBBS.org.
This client program will automaticly update your account at theBBS.org
with your current IP-address whenever your IP changes. It sits in your
system tray when minimized, so its never in the way.

This allows you to maintain a sub domain name on your home computer,
so you could run telnet, web, ftp servers and so on, using the address
yourname.theBBS.org as your own domain.
===================


How to Configure
----------------
You need to edit the text file named EDNSCLI.INI.

First go to http://thebbs.org/dns and create your free Dynamic DNS
Account. There you will select a hostname for your sub domain name.
For example if you selected "foobar" as your hostname, then your
address would be "foobar.theBBS.org"

You will be given a password for this Hostname. You can then cut
and paste this password into the EDNSCLI.INI file, as well as your
hostname (also known as a username).

Under normal circumstances, you will not need to include your IP
in the EDNSCLI.INI, just your hostname and password.

Now run either the Win32 or the OS/2 version of Ele DNS Client.
I suggest you add this to your startup menu, so that it automaticly
runs each time you boot your operating system.

This program is provided with full (Pascal) source to show you an
implementation of such a program. The program should compile using
Delphi4 and VirtualPascal.


Technical Info
--------------
IP addresses at theBBS.org can be updated manually by using their web site.
HowEver, this work is cumbersome if your IP changes quite often as it will
on most dialup connections.

EDNSCLI automates this task by reading the username and password from the
configuration file EDNSCLI.INI. This is a plain textfile which you can edit
to fit your needs.

When executes, EDNSLCLI sends a simple HTTP GET request on port 80 to the
server "www.thebbs.org". It tries to run /cgi-bin/cgi_updateip.exe and passes
the following parameters:

username                = username/hostname to access at theBBS.org.
password                = password needed to modify this hostname.
ipaddress               = IP address the hostname should direct to.

Imagine using username "username" and password "password". Your IP would be
127.0.0.1, such an request could become:

http://www.thebbs.org/cgi-bin/cgi_updateip.exe?username=hostname&
password=yourpassword&ipaddress=127.0.0.1

Typing this directly into your browser would yield the desired result.

For a more correct explanation of the HTTP protocol, please refer to
the RFC2616 specifications.

