inadyn-mt - Simple DYNAMIC DNS client.

Version 02.28.10, October 2016

INADYN Advanced Help

INADYN Advanced 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 Advanced.

inadyn-mt contains some substantive bug fixes, and feature additions, including built in Windows service installation and management, connection event trapping, unicode, additional dynamic dns servers support, IPv6, and a few other things.

inadyn-mt source, and binaries can be found at http://sourceforge.net/projects/inadyn-mt/

Download

Features:

• supports the following dynamic DNS services:
• dyndns.org (in all three flavors: dynamic, static, custom)
• freedns.afraid.org
• zoneedit.com
• no-ip.com
• 3322.org
• easydns.com
• sitelutions.com
• dnsomatic.com
• ipv6tb.he.net
• tzo.com
• dynsip.org
• dhis.org
• zerigo.com
• two-dns.de
• www.dnsdynamic.org
• dnspark.com
• regfish.de
• www.ovh.com
• joker.com
• dyndns.strato.com
• system-ns.com
• dtdns.com
• changeip.com
• dnsexit.com
• nsupdate.com
• loopia.com
• domains.google.com (requires SSL bridge, like stunnel)
• duckdns.org
• dy.fi
• ddnss.de
• dynv6.com
• selfhost.de
• maintains multiple aliases of the same IP address
• supports multiple dynamic dns servers on Windows as well as Linux, BSD
• supports access via http proxy
• does not perform unnecessary updates
• runs as a service (*nix, Windows 2000/XP sans MS utilities)
• runs as a console application
• Separate Windows service log file parameter option
• updates the correct IP address even behind a NAT router
• Windows RAS event trapping ip update trigger
• SIGUSR1 network status event trapping ip update trigger
• unicode
• separate configurable network status test thread
• audible alert on network status down
• compiler options for sound, threads, debug output, or use ./makefile-deprecated
• IPv6 dynamic dns updates

1. As of version 02.00.00 inadyn-mt, MS service related files aren't needed (but, still work if desired). The program can be started as a service (Windows NT) without these files, either from the command line, or the Windows service interface after command line installation. The service is named 'inadyn-mt'.
   
   Install
   
   inadyn-mt -i ["My Service Description"]
   
   Optionally, a service may be installed with a specified name (defaults to inadyn-mt), providing for multiple service instances, useful for multiple dynamic dns server accounts (just point AppParamerters registry entry to corresponding configuration file, with the --input_file (see inadyn-mt program parameters below) parameter):
   
   inadyn-mt -i ["My Service Description"] -n <service_name>
   
   Installation gives a default registry setup. The registry entry can be found at:
   
   HKEY_LOCAL_MACHINE\CurrentControlSet\Control\Services\inadyn-mt
   
   Edit the Parameters\AppParameters default string value to customize to your dynamic dns system, and preferences. See below for a full list of parameters, or simply type the program name, with no commands to see a listing.
   
   Post installation configuration can also be done using the registry files method listed in step 2 below (edit the "mt" registry file for inadyn-mt -i install method).
   
   Start
   
   inadyn-mt -s
   
   Or:
   
   inadyn-mt -s -n <service_name>
   
   (The service name (-n) parameter may be similarly applied to all service commands.)
   
   Assuming a configuration file of say, d:\inadyn-mt\inadyn-mt.cfg, the service can be installed, and started from the command line, with:
   
   inadyn-mt -i ["My Service Description"] -s --input_file d:\inadyn-mt\inadyn-mt.cfg
   
   The optional service description command option is commited to Windows registry. Other parameters are not commited to the Windows registry, and still need setting up as listed in step 2 (edit the "mt" registry file for inadyn-mt -i install method), or by editing installation registry defaults directly, as described in Install section above.
   
   Command line parameters override registry, parameters. Configuration file parameters are inserted at point configuration file command appears.
   
   Exit
   
   inadyn-mt -e
   
   Uninstall
   
   inadyn-mt -x
   
   Restart (if the service is not running, this command will start it):
   
   inadyn-mt -r
   
   If it appears commands are not carried out according to parameters given on command line, try closing other service related programs such as the Windows Services interface.
   
   See inadyn-mt\bin\win32 for registry, and batch files named corresponding to the present program version, and function corresponding to registry, and batch files mentioned in the present html page. The batch files are convenient for service installation, or removal without the command line -- just double click.
   
   Windows 95/98
   
   For unicode compatibility on Windows 95/98, in MS VC6 Project Settings, C/C++ tab, define preprocessor definition, UNICOWS, link with unicows.lib, and place the dll, unicows.dll in program executable directory.
   
   
2. Edit the registry file with the correct name for your service (e.g. 'configure_inadyn-mt_service_dyndns.reg') in order to pass your username, password, aliases, and other params to inadyn-mt. After you have finished double click on the reg file.

   Notes:

   • The correct path to inadyn-mt binary has to be entered in the config file.
   • The log file is located in %System%\system32 by default
   • Beware of the double backslashes '\\' and the correct paths!
     

   After you have finished double click on the reg file.

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

	(As of inadyn-mt version 02.16.01-beta, regular makefile is deprecated for automake.  makefile is still maintained, 
	but must be copied from makefile-deprecated to makefile in order to use.)

1. No installation necessary. The inadyn-mt executable found in bin/linux/inadyn-mt is self contained and can be launched at any time
   

1. Put the binary somewhere in path (e.g. ~/bin),
   Start it with the following AppleScript saved as an Application and dragged to
   System Preferences -> Accounts -> Login Items:
   

   do shell script "~/bin/inadyn-mt -a HOST.dyndns.org -u USER -p PASSWORD"

   
   Alternatively, one can put it in the system startup scripts.

1. Adjust the makefile - change the architecture to yours. (e.g. solaris)
2. Recompile  - make clean all
   

Command line options

They are automatically printed if inadyn-mt gets wrong parameters or if --help option is used.

Typical usage:

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

Parameters:

'--help': help
'-h': help

'--username <name>': your membername/hash
'-u <name>': your membername/hash

'--password <password>': your password. Optional.
'-p <password>': your password. Optional.

'--alias <alias host name>[, hash] [ip type] [if] [addr pref] [ip server[:port] <ip server url> [ip server host]]':
     alias host name, optional comma delimted hash, optional ip version (default auto), ipv6 source address preference, network interface, ip server, ip server port, ip server host.
'-a <alias host name>' --alias short option.

     This option can appear multiple times.

A host name alias, optional comma delimited hash, and optional ip version (default auto), network interface, address preference, ip server (and optional colon delimited port) and url, ip server host.

IP types are dual, coupled, ip4, ip6, or auto. IP type auto is the default. IP type dual (for dual ip stack), denotes the alias should be updated to both ipv6, ipv4. Coupled is like dual, but denotes DDNS server accepts dual stack updates in a single request, where the ipv4, ipv6 addresses are presented as a comma delimited list.

Network interface parameter should denote the network interface to be used as the ip server connect source address. When this parameter is opted, unless ip type is ip4, the alias will be updated to the ipv6 address obtained from this interface, along with, if indicated, the ipv4 address obtained from ip server.

The addr pref parameter denotes ipv6 privacy extentions address preference. It can be one of either pub, policy, home, careof, crypto, nocrypto, tmp, pubtmp. Logical OR not yet supported. The default is pub.

Use the ip server parameter for other than the DDNS server's ip server as per default inadyn-mt hard coded configuration set‐ tings. It can include a colon delimted port number. It must be accompanied by a url parameter. Finally, an ip server host can be designated - useful in case of ip server running on multiple server hosts, or the ip server domain name used to reach the server otherwise differs from actual ip server domain name.

Except the host (alias) parameter, all of these parameters are optional, but order matters.

'--debug': <#> - debug level 1..7 (higher = more output)
'-d': debug level 1..7 (higher = more output).

'-i [quoted service description] [-n <service name>]': install service

'-s [-n <service name>]': start service

'-e [-n <service name>]': exit service

'-r [-n <service name>]': restart service

'-x [-n <service name>]': remove service

'--input_file <path/file>': input file name that contains inadyn-mt command options (adds to those already present in the cmd line). The default configuration file name is '/etc/inadyn-mt.conf'. It is only used if inadyn-mt is called without any command line options. This allows inadyn-mt to be called without any arguments. The format is as expected for a **NIX config  file. See below for details.

'--ip_server_name <name>[:port] <url>': The client IP is detected by calling 'url' from this 'ip_server_name:port'.

Choice of ip server name parameter option can determine what type of address is updated. To update an IPv6 address, simply choose an ip server that supports IPv6, such as, ip6.me /, myip.dk /, dhis.org /, among others. And, of course, dynamic dns server should be set to one that supports IPv6. See IPv6 section below for more information.

'--ip_server_host <host>': Host name used in http request to ip server if different from ip server name, as when, e.g., ip_server_name is 'localhost:port /' through an SSL bridge. Defaults to ip server name.

'--dyndns_server_name <name>[:port]': dynamic dns server name, and optional port.

The server that receives the update DNS request.
If no proxy is wanted, then it is enough to set the dyndns system. The default servers will be taken.

'--dyndns_server_url <url>': full URL relative to DynDNS server root.

'--dyndns_server_host <host>': Host name used in http update DNS request, if different from dyndns server name, as when, e.g., ip_server_name is 'localhost:port' through an SLL bridge. Defaults to dyndns server name.

'--dyndns_system <NAME>': optional DYNDNS service type.

This option can be used multiple times - once for each DDNS server to update - followed by --alias, and other options corresponding to the --dyndns_system entry. Per --dyndns_system entry options are username, password, alias, ip_server_name, ip_server_host, dyndns_server_name, dyndns_server_url, dyndns_server_host, and proxy_server.

dyndns_system parameter should be one of the following:

-For dyndns.org DNS system: dyndns@dyndns.org, dual@dyndns.org OR statdns@dyndns.org OR custom@dyndns.org.
-For freedns.afraid.org DNS system: default@freedns.afraid.org
-For zoneedit.com: default@zoneedit.com
-For no-ip.com: default@no-ip.com
-For easydns.com: default@easydns.com
-For 3322.org: dyndns@3322.org
-For sitelutions.com: default@sitelutions.com
-For dnsomatic.com: default@dnsomatic.com
-For tunnelbroker.net: ipv6tb@he.net
-For tzo.com: default@tzo.com
-For dynsip.org: default@dynsip.org
-For dhis.org: default@dhis.org
-For zerigo.com: default@zerigo.com
-For two-dns.de: default@two-dns.de
-For www.dnsdynamic.org: default@dnsdynamic.org
-For dnspark.com: default@dnspark.com
-For regfish.de: ipv4@regfish.de
-For regfish.de: ipv6@regfish.de
-For www.ovh.com: default@ovh.com
-For joker.com: default@joker.com
-For dyndns.strato.com: default@strato.com
-For system-ns.com: default@system-ns.com
-For www.dtdns.com: default@dtdns.com
-For changeip.com: default@changeip.com
-For dnsexit.com: default@dnsexit.com
-For nsupdate.info: ipv4@nsupdate.info
-For nsupdate.info: ipv6@nsupdate.info
-For loopia.com: default@loopia.com
-For domains.google.com: default@domains.google.com (requires SSL bridge, like stunnel)
-For duckdns.org: default@duckdns.org
-For dy.fi: default@dy.fi
-For ddnss.de: default@ddnss.de
-For dynv6.com: ipv4@dynv6.com
-For dynv6.com: ipv6@dynv6.com
-For dynv6.com: dual@dynv6.com
-For selfhost.de: default@selfhost.de
-For generic DNS system: custom@http_svr_basic_auth

DEFAULT: 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]. 30000..864000000. Default is about 10 min. Max is 10 days

'--update_period_sec <#>': how often the IP is checked. The period is in [sec]. 30..864000. Default is about 10 min. Max is 10 days

'--forced_update_period <#>': how often, in seconds, the IP is updated even if it is not changed. 30 sec..30 days, default, 30 days.

'--log_file <path/file>': log file path and name

'--background': runs in background.  Output to syslog or to log file [if specified].

'--verbose <#>': set dbg level. 0 to 5

'--iterations <#>': set the number of DNS updates. Default is 0, which means infinity.

'--syslog': explicit set output to syslog. (e.g. /var/log/messages). Works on **NIX systems only.

'--change_persona <uid[:gid]>': After init changes user ID and group ID to the provided ones. This allows dropping
    unneeded [root] privileges after startup. Works for **NIX only.

'--exec <command>': external command to exec after an IP update. Include the full path.

'--cache_dir <path>': cache directory name. (e.g. /tmp/ddns). Defaults to /tmp on **NIX systems.

'--wildcard': enable domain wildcarding for dyndns.org, 3322.org, or easydns.com.

'--retries <#>': network comm retry attempts. 0 to 100, default 0.

'--retry_interval <#>': network comm miliseconds retry interval. 0 to 30,000, default 1,000.

'--retry_pending': retry ip update even after network comm retries exhausted, default on.

'--retry_pending_interval <#>': network comm seconds update retry interval, after retries exhausted, 5 to 3600,
    default 300.

'--lang_file <path/file>': [language file path, and file name]. defaults to either ../inadyn-mt/lang/en.lng,
    or /etc/inadyn-mt/en.lng. No parameter option gives hard coded defaults

'--online_check_url <srv_name[:port] url>': server name, optional port, and url to reach to confirm online status.

'--status_interval <#>': seconds [30..864000] interval at which to check online status, default 600.

'--alert_retries <#>': network retries before audible network status alerts. [0..100], default 0.

'--status_offline_interval <#>': seconds [5..864000] interval at which to check online status, after offline detected,
    default 15.

'--audible': audible network status alerts toggle. default off.

'--wave_file <file/path>': audible network status alerts wave file path, and file name. defaults to either
    ../inadyn-mt/extra/wav/alarm.wav, or etc/inadyn-mt/extra/wav/alarm.wav [wave loops: 0..100; -1 for
    infinite] same as wave_loops below -- optional number of times per wave play call to repeat wave file
    play, default 0.

'--wave_loops <#>': same as wave_file parameter optional parameter -- 0..100 or -1 for infinite number of times
    per wave play call to repeat wave file play, default 0.

'--wave_buff <#>': wave file output buffer size control -- integer or float multiple of wave file bytes per sec.
    [.25..10], default .25.

'--wave_gain <#>': gain (amplitude adjust) at which to play audible alert (beware clipping), integer or float.
    [-10..10], default 10 (0db, no attenuation).

'--alert_interval <#>': time in miliseconds between consecutive audible network status alerts. [0..3600000],
    default 0.

'--svr_rsp_success <custom DDNS server update success return code>': Optional for custom DDNS updates. A comma delimited quoted
    string, e.g., "good, nochg", representing custom DDNS server successful update return values.

'--svr_rsp_other <custom DDNS server non-fatal return codes>': Optional for custom DDNS updates. A comma delimited quoted string
    representing custom DDNS server non-fatal update failure return values, e.g., "dnserr,911,unknown error".

'--svr_ip_param <custom DDNS server ip name parameter> [user] [pass]': Optional for custom DDNS updates. DDNS url parameter for ip address,
    e.g., myip.

'--svr_ip_in_rsp': Optional for custom DDNS updates. Flag that custom DDNS server returns your ip address on update success.
    Defaults to false.

'--svr_auto_dual': Flag that server defaults to dual list (coupled) alias ip type. Defaults to false.

'--svr_auto_detect': Flag server auto detects ip. Defaults to false.

'--svr_add_cfg <full path, file name>': Additional servers file. Default search for servers_additional.cfg in ./extra, /etc, /etc/inadyn-mt,
     /etc/inadyn-mt/extra. Contains additional preconfigured DDNS servers to be used as --dyndns_system option parameter in same
     fashion as servers inadyn-mt supports natively. Should appear before any dyndns_system option in inadyn-mt.conf or command
     line if not using inadyn-mt.conf.

'--if <network interface name>': Name of network interface to use for ip server, and DDNS server comm. Defaults to
    system configured default.

'--addr_pref <pub | policy | home | careof | crypto | nocrypto | tmp | pubtmp>': ipv6 privacy extensions address
    preference. Valid parameters are 'pub,' 'policy,' 'home,' 'careof,' 'crypto,' 'nocrypto,' 'tmp,'
    'pubtmp.' Defaults to 'pub.' See rfc5014. Combining via logical OR not presently supported.

'--if_enum': Enumerate network interfaces.

'--improb': ????

SPECIAL NOTE: Cache file :

There are two cache files: inadyn_time.cache and inadyn_ip.cache. They store the time and IP address when an update last occurred. Under **NIX systems, the cache directory defaults to /tmp, under windows it defaults to the directory where inadyn-mt.exe was launched.

Example usage:

1. Update every minute, in console mode, for a dyndns.org system:

inadyn-mt --username test --password test --update_period 60000 --alias test.homeip.net --alias my.second.domain

2. Update every minute, in demon mode (background task), with log file, of an dyndns.org address:

inadyn-mt --background -u test -p test --update_period 60000 --alias inarcis.homeip.net --alias my.second.domain --log_file inadyn_srv.log

3. Update freedns.afraid.org, every minute, in daemon mode, with configuration read from file.

Config file can be placed anywhere. In linux, default location: /etc/inadyn-mt.conf

Content of config file:

--update_period 60000
--alias test.homeip.net, hash_for_host1
--log_file /var/log/inadyn.log
--change_persona 10012 #to change to another user id after init.

Launching of inadyn-mt does not need any params. It looks for /etc/inadyn-mt.conf

4. Freedns update in console

inadyn-mt --update_period 60000 --alias test.homeip.net,hash_for_host1 -a my.second.domain,hash2 --dyndns_system default@freedns.afraid.org

Examples:

1.

#Some comment about  inadyn-mt  cfg file
--username test --password test --update_period 60000 --alias test.homeip.net --alias my.second.domain

2.

--username test #user
--password test
update_period 60000  #some other param without '--'
alias test.homeip.net