===============================================================================
DDCLIENT 2.2.1

ddclient is a Perl client used to update dynamic DNS entries for accounts
on Dynamic DNS Network Services' free DNS service.  See http://www.dyndns.org 
for details on obtaining a free account.

The latest version of ddclient and this README may always be obtained from:
	ftp://burry.dyndns.org/pub/ddclient/ddclient.tar.gz
	ftp://burry.dyndns.org/pub/ddclient/README

Comments can always be sent to:
	mailto:paul+ddclient@burry.dyndns.org

If you use ddclient, please send a brief note to:
	mailto:paul+ddclient@burry.dyndns.org
and indicate if you would like to be notified of new releases.

Paul Burry

-------------------------------------------------------------------------------
CHANGES

- 2.3
- fixed a problem reading in cached entries


- 2.2.1
- sample-etc_ppp_ip-up.local - local ip address is $4 or $PPP_LOCAL (for debian)
- use <CR><LF> as the line terminator (some proxies are strict about this)

- 2.2
- added support (-static) for updating static DNS (thanks Marc Sira <toh@victoria.tc.ca>)
- changed ddclient.cache format (old style is still read)
- sample-etc_ppp_ip-up.local - detect improper calling sequences
- sample-etc_ppp_ip-up.local - local ip address is $3 or $PPP_LOCAL (for debian)

- 2.1.2
- updated README

- 2.1.1
- make sure result code reflects any failures
- optionally (-quiet) omit messages for unnecessary updates
- update sample-etc_cron.d_ddclient to use -quiet

- 2.1
- avoid unnecessary updates by recording the last hosts updated in a 
  cache file (default /etc/ddclient.cache)

- optionally (-force) force an update, even if it may be unnecessary. 

  This can be used to prevent dyndns.org from deleting a host that has not 
  required an update for a long period of time.

- optionally (-refresh), reissue all host updates.

  This can be used together with cron to periodically update DynDNS. 
  See sample-etc-cron.d-ddclient for details.

- optionally (-retry) save failed updates for future processing.

  This feature can be used to reissue updates that may have failed due to
  network connectivity problems or a DynDNS server outage

-------------------------------------------------------------------------------
REQUIREMENTS:

- one or more FREE accounts from http://www.dyndns.org
- Perl 5.004 or later
- Linux or probably any common Unix system

-------------------------------------------------------------------------------
INSTALLATION:

  cp ddclient /root/bin/
  cp sample-ddclient.conf /etc/ddclient.conf
  vi /etc/ddclient.conf
  -- and change hostnames, logins, and passwords appropriately

  ## configure cron to force an update twice a month
  cp sample-etc_cron.d_ddclient /etc/cron.d/ddclient
  vi /etc/cron.d/ddclient

-------------------------------------------------------------------------------
USING DDCLIENT WITH ppp

If you ar using a ppp connection, you can easily update your DynDNS
entry with each connection, with:
  ## configure pppd to update DynDNS with each connection
  cp sample-etc_ppp_ip-up.local /etc/ppp/ip-up.local

-------------------------------------------------------------------------------
USING DDCLIENT WITH dhcpcd-1.3.17

If you are using dhcpcd-1.3.17 or thereabouts, you can easily update
your DynDNS entry automatically every time your lease is obtained
or renewed by creating an executable file named:
  /etc/dhcpc/dhcpcd-{your-interface}.exe
ie.:
  cp sample-etc_dhcpc_dhcpcd-eth0.exe /etc/dhcpc/dhcpcd-{your-interface}.exe

In my case, it is named dhcpcd-eth0.exe and contains the lines:
  #!/bin/sh
  logger -t dhcpcd IP address changed to $1
  /root/bin/ddclient -proxy fasthttp.sympatico.ca -wildcard -ip $1 | logger -t ddclient 
  exit 0

Other DHCP clients may have another method of calling out to programs
for updating DNS entries. 
-------------------------------------------------------------------------------
$Header: /home/paul/src/ddclient/RCS/README,v 1.7 2000/04/22 13:54:06 root Exp $
