DragonFly On-Line Manual Pages
inadyn-mt(8) System management commands inadyn-mt(8)
w.
NAME
inadyn-mt - a client for open DNS servers.
SYNOPSIS
inadyn-mt [-h | --help] [-u | --username username] [-p | -- password
password] [-a | --alias alias[,hash] [dual | coupled | ip4 | ip6 |
auto]] [--input_file path/name] [--ip_server_name server[:port] url]
[--dyndns_server_name server[:port]] [--dyndns_server_url url]
[--dyndns_system service] [--proxy_server[:port] proxy[:port]]
[--update_period ms] [--update_period_sec sec] [--forced_update_period
sec] [--log_file path/name] [--background] [--verbose level]
[--iterations iterations] [--syslog] [--change_persona uid[:gid]]
DESCRIPTION
inadyn-mt is a client for `open' name servers. That is, it allows the
user's machine to have an Internet recognized name by transferring some
control over a name server not managed by the user. Some of the
services that are offered by those open name servers are free of
charge, and work even when the client machine does not have a static
IP. Supports both IPv4, and IPv6 addresses.
Supported name servers are:
http://www.dyndns.org
http://freedns.afraid.org
http://www.zoneedit.com
http://www.no-ip.com
http://www.easydns.com
http://www.3322.org
http://www.sitelutions.com
http://www.tzo.com
http://www.dnsomatic.com
http://www.tunnelbroker.net
http://www.dynsip.org
http://www.dhis.org
http://www.zerigo.com
http://www.two-dns.de
http://www.dnsdynamic.org
http://dnspark.com
http://regfish.de
http://www.ovh.com
http://joker.com
http://dyndns.strato.com
http://system-ns.com
http://www.dtdns.com
http://changeip.com
http://dnsexit.com
http://nsupdate.info
http://loopia.com
http://domains.google.com (requires SSL bridge, like stunnel)
http://duckdns.org
Its basic operation is to periodically check whether the actual IP of
the client machine is the same one that is recorded in the name server,
and update the name server records when there is a mismatch.
For IPv6 addresses, see below, alias, and ip_server_name options.
Also, network status can be checked at a user specified interval, and
audible alerts issued in event of network status down.
OPTIONS
"-h, --help"
Print a summary of the options to inadyn-mt and exit.
"-u, --username"
The username, if applicable. This might be referred to as hash.
"-p, --password"
The password, if applicable.
"-a, --alias[,hash] [dual | coupled | ip4 | ip6 | auto]"
A host name alias, optional comma delimited hash, and optional
ip version, default auto. This option can appear multiple times,
for each domain that has the same IP.
For alias ip type, it may often suffice to use either dual, for
dual stack clients updating a given alias to both IPv4, and IPv6
addresses, or ip4 when the client is dual stack and requires at
least one IPv4 only address update. Leaving ip type up to the
ip server (see ip_server_name option, below) may be also, in
many instances, sufficient (auto alias ip type, which is the
default).
Use ip type coupled instead of dual in cases where ip server
update specification requires dual stack updates in a single
update request, i.e., both ip address types may be sent in a
comma delimited list fashion.
--input_file
The file name that contains inadyn-mt command options exactly as
specified in the command line syntax (adds to those already
present in the cmd line). The default configuration file name is
'/etc/inadyn.conf'. It is looked at automatically if inadyn-mt
is called without any command line options. The format is as
expected for a **NIX config the hash character is used to
comment entire lines. Spaces are ingored. The long options may
be specified without -- if placed at the beginning of the line.
--ip_server_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.
--ip_server_host
Host name used in http request to ip server if differnt 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[:port]
The server that receives the update DNS requests. When no proxy
is specified it is sufficient to set the dyndns_system so that
the default servers will be taken. The option is useful for
generic DynDNS services that support HTTP update.
--dyndns_server_url
The update path inside the DynDNS server.
--dyndns_server_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
An optional DNS service. For
http://www.dyndns.org
the acceptable services are one of dyndns@dyndns.org,
statdns@dyndns.org or custom@dyndns.org.
There is only one acceptable service for
http://freedns.afraid.org, which is default@freedns.afraid.org.
Other services are:
default@zoneedit.com
default@no-ip.com
default@easydns.com
dyndns@3322.org
default@sitelutions.com
default@dnsomatic.com
ipv6tb@he.net
default@tzo.com
default@dynsip.org
default@dhis.org
default@zerigo.com
default@two-dns.de
default@dnsdynamic.org
default@dnspark.com
ipv4@regfish.de
ipv6@regfish.de
default@ovh.com
default@joker.com
default@strato.com
default@system-ns.com
default@dtdns.com
default@changeip.com
default@dnsexit.com
ipv4@nsupdate.info
ipv6@nsupdate.info
default@loopia.com
default@domains.google.com
Requires SSL bridge, like stunnel; set --server_host_name
domains.google.com
default@duckdns.org
custom@http_svr_basic_auth
See also custom server options, --svr_rsp_succes,
--svr_rsp_other, --svr_ip_param, --svr_ip_in_rsp
The default service is dyndns@dyndns.org, which is believed to
be used by most users, at least initially.
--proxy_server[:port]
An http proxy server name and port. The default is none.
--update_period
How often the IP is checked. This value denotes millisecond
(There are 1000 milliseconds in one second). 30000..864000000.
Default is about 10 min. maximum is 10 days.
--update_period_sec
How often the IP is checked. Here the value denotes seconds.
30..864000. The default is about 10 min. The maximum value is
10 days.
--forced_update_period
How often the IP should be updated even if it is not changed.
The time should be given in seconds. 30 sec..30 days. Default,
30 days.
--forced_update_adjust
Fine timer control. Slow, or speed timer between -4..5.
Default, 0.
--log_file
The name, including the full path, of a log file.
--cache_dir
Directory to which ip, and time update files are written.
Defaults to /tmp on **NIX systems.
--background
run in background. Output is sent to the UNIX syslog facilities
or to a log file, if one was specified.
--verbose
Set the debug level, which is an integer between 0 to 5.
--iterations
Set the number of DNS updates. The default is 0, which means
infinity.
--syslog
Explicitly sending the output to a syslog like file, such as
/var/log/messages.
--change_persona uid[:gid]
After init changes user ID and group ID to the provided ones.
This allows dropping unneeded [root] privileges after startup.
--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
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] local_url - URL to reach to confirm online
status.
--status_interval
Seconds [30..864000] interval at which to check online status,
defaults to 600.
--alert_retries
Network retries before audible network status alerts. [0..100],
default 0.
--status_offline_interval
Seconds [0..864000] interval at which to check online status,
after offline detected, defaults to 15.
--audible
Audible network status alerts toggle (log output only), default
off.
--wave_file
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; -1 for
infinite number of times per wave play call to play wave file.
--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
Optional for custom DDNS updates. A quoted comma delimited
string, e.g., "good, nochg", representing custom DDNS server
successful update return values.
--svr_rsp_other
Optional for custom DDNS updates. A quoted comma delimited
string, e.g., "dnserr,911", representing custom DDNS server non-
fatal update failure return values.
--svr_ip_param
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_add_cfg
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 Name of network interface to use for ip server, and DDNS server
comm. Defaults to system configured default.
--addr_pref
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.
TYPICAL USAGE
http://www.dyndns.org
inadyn-mt -u username -p password -a my.registered.name
inadyn-mt --username test --password test --update_period 60000 --alias
test.homeip.net --alias my.second.domain
inadyn-mt --background -u test -p test --update_period 60000 --alias
inarcis.homeip.net --alias my.second.domain --log_file inadyn-mt.log
http://freedns.afraid.org
inadyn-mt --dyndns_system default@freedns.afraid.org -a
my.registrated.name,hash_from_freedns
inadyn-mt --update_period 60000 --alias test.homeip.net,hash_for_host1
-a my.second.domain,hash2 --dyndns_system default@freedns.afraid.org
The 'hash' should be extracted from the grab url batch file that can be
downloaded from the site. A single hashed (base64 encoded) string is
preferred upon a username and password pair, apparently to reduce the
computational resources that is required on their side. Unfortunately
the hash can not be computed by inadyn-mt because it requires the index
to the username record in the freedns database, which is not known. The
simplest solution seems to be a copy&paste action from the grab url
batch file offered on their website. When the batch file looks is like
graburl
http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUIHEOIFEOIHJFEIO=
the hash string, which is what the user should copy and paste, is the
string that begins right after the '?' character and ends with the end
of line. This string shell be used as the username in inadyn-mt
command. When the user has several names then each name should be
followed with that name hash string.
OUTPUT
inadyn-mt prints a message when the IP is updated. When the connection
goes down it could be that inadyn-mt will print some error messages.
Those are harmless and should be followed by 'OK' messages after the
connection is back up.
Signals
Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn-mt to terminate
gracefully. SIG_USR1 will cause inadyn-mt to update ip, if changed.
SEE ALSO
Other manual pages
The syntax of the optional configuration file is given by
inadyn-mt.conf(5).
Internet resources
inadyn:
http://www.inatech.eu/
inadyn-advanced:
http://sourceforge.net/projects/inadyn-advanced/
inadyn-mt:
http://sourceforge.net/projects/inadyn-mt/
AUTHOR
inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.com>; inadyn-
advanced, Steve Horbachuk; inadyn-mt unicode, other augmentations,
Bryan Hoover <bhoover@wecs.com>
This manual page was written by Shaul Karl, <shaul@debian.org>, for the
Debian GNU/Linux system, based on the readme.html file that is found in
the source.
Linux applications September, 2009 inadyn-mt(8)