INADYN - Simple DYN DNS client.
Version 1.70 July 2004
--------------------------

                        INADYN Help

        INADYN is a dynamic DNS client. That is, it maintains the IP address
of a host name. It periodically checks whether the IP address stored by the
DNS server is the real current address of the machine that is running INADYN.


Features:
---------
	- supports the following dynamic DNS services:
        - dyndns.org (in all three flavors: dynamic, static, custom)
        - freedns.afraid.org 
	- maintains up multiple aliases of the same IP address
	- runs as a service (Windows NT, 2000)
	- or runs as a console application 
	- updates the correct IP address even behind a NAT router.
	- supports access via http proxy
	- does not perform unneccessary updates.	
	
OS Support
----------
    - Windows NT, 2000 (as service or console application)
    - Unix compatible
    - pSOS embedded OS. (not free)

Installation as a service in Windows
------------------------------------

1. IF you want inadyn to run as a service. For installation you need Administrator rights and you need to launch the batch:
	install_inadyn_sevice.bat
from the same directory where inadyn.exe is located.	

This will allow a standard console to run as a service.
The programs are provided together with inadyn. (intsrv.exe, srvany.exe) 
They can be also found on Win res Kit CD.

2. Edit the registry file 'configure_inadyn_service.reg' in order to pass  
your username, password, aliases, and other params to inadyn.
  After yu have finished double click on the reg file.
  Notes:
    1. The correct path to inadyn binary file has to be entered in the configuration file.
    2. By default the log file is located in your %System%\system32 directory!

3. Go to ControlPanel/AdministrativeTools/Services/inadyn and START the service.
Also make sure that the startup mode is 'automatic'.


Notes:
    1. 
Command line options.
---------------------

They are printed if inadyn gets wrong parameters or if --help opiton is used.

Typical usage:
        -for dyndns.org system:
                inadyn -u username -p password -a my.registrated.name
        -for freedns.afraid.org:
                 inadyn  --dyndns_system default@freedns.afraid.org -a my.registrated.name,hash_from_freedns
                         'hash' is extracted from the grab url batch file that is downloaded from freedns.afraid.org

Parameters:
        '--help': help
        '-h': help
        '--username': your  membername (if applicable)
        '-u': your  membername 
        '--password': your password.(if applicable)
        '-p': your password
        '--alias': <--alias host_name[,hash]> -  alias host name. this option can appear multiple times.
        '-a': alias host name. this option can appear multiple times.
	'--input_file': the file name containing [further] inadyn options
        '--ip_server_name': [NAME] - local IP is detected calling a CGI from this server name. default checkip.dyndns.org
        '--dyndns_server_name': [<NAME>[:port]]
                The server that receives the update DNS request.
                For dyndns.org is: members.dyndns.org.
                For freedns.afraid.org is: freedns.afraid.org
                If no proxy is wanted, then it is enough to set the dyndns system. The default servers will be taken.
        '--dyndns_system': [NAME] - optional DYNDNS service type. SHOULD be one of the following:
                -For dyndns.org DNS system: dyndns@dyndns.org OR statdns@dyndns.org OR custom@dyndns.org.
                -For freedns.afraid.org DNS system: default@freedns.afraid.org
                DEFAULT value is intended for default service at dyndns.org (most users): dyndns@dyndns.org
        '--proxy_server': [NAME[:port]]  - the http proxy server name and port. Default is none.
        '--update_period': how often the IP is checked. The period is in [ms]. Default is about 1 min. Max is 10 days
        '--update_period_sec': how often the IP is checked. The period is in [sec]. Default is about 1 min. Max is 10 days
        '--forced_update_period': how often the IP is updated even if it is not changed. [in sec]
        '--log_file': log file path abd name
        '--background': run in background. output to log file. (works on windows only)
        '--verbose': set dbg level. 0 to 5
	'--iterations: set the number of DNS updates. Default is 0, which means infinity.'

LOG Output
---------

Inadyn prints some message when the ip is updated. 
if no update is needed by default it prints a '.' 
So typically you will see a lot of dots in the log file.
When the connection goes down it is possible that inadyn displays some errors. But they should be followed by 'OK' messages after the connection is back up.


For freedns.afraid.org
----------------------
They prefer to get as parameter a single hashed (base64 encoded) value instead username, password. 
This saves some computing resources apparently. The hash cannot be computed by inadyn because it involves 
the database index of your username in freedns database which is not known. 
The simplest solution seems to be the copy-paste action from the graburl batch file offered on their website.

Example: The batch file looks like this:
graburl http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUIHEOIFEOIHJFEIO=
The user has to copy and paste the hash value after the '?' until the end of line. 
The hash will be used as username in inadyn parameters. (see typical usage above) 
Example: inadyn -a hostname,hash -a hostname2,hash2 ...other_params...


	
HISTORY
-------
Ver. 1.70  - 5 July 2004
	Bugfix: 
		custom dns from dyndns option was not accepted by the cmd line parser. "Copy-paste" error :-( !

	New option: (not tested. It was a debug option now made accessible via cmd line. It should work)
		--iterations. Now one can run inadyn with only one iteration. 

Ver. 1.60  - 5 June 2004
	On users' request the inadyn can read the options from file.

Ver. 1.51  - 3 May 2004
	- support for more aliases for DNS service offered by freedns.afraid.org 

Ver. 1.5  - 1 May 2004
	- Support for dynamic DNS service offered by freedns.afraid.org
	- support for http proxy
	- GPL Copyright notice added.
	
Ver. 1.4  - 1 March 2004
	- Support for custom DNS and static DNS services offered by dyndns.org.
	- support for forced IP update (so the account will not expire even though the IP never changes)
	
Ver. 1.35 - February 2004
	-Bugfixes:
		- multiple aliases are AGAIN supported
		- in case of error in IP update the OS signal handler is not installed again.
Ver. 1.34  
	- Various bugfixes. 
	
Ver. 1.3 - 6 November 2003 - first port to *NIX - (Linux)

    -Linux version running OK as console app
        
	Future plans:
		- run as a background daemon in Unix
		- better interface

Ver 1.2 - June 2003
    - port to pSOS
    Note:
        - no DNS support under pSOS -> hard coded IP addresses of the server

Ver. 1.0 - 20 May 2003 - first stable version.
	main features ready: 
		- DYNDNS client
		- free
		- works fine behind a NAT router
		- runs fine as a service
		- has a nice log file
		- it is MINE ;)
	Future plans:
		- port to *NIX
		- port to pSOS


		
