inadyn - a client for open DNS servers.
inadyn [-h | --help] [-u | --username username ] [-p | -- password
password ] [-a | --alias[,hash] alias,hash [-a | --alias[,hash]
another_alias,the_other_hash ... ]] [--input_file path/name ]
[--ip_server_name server[:port] url ] [--dyndns_server_name[:port]
server[:port] ] [--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] ]
inadyn is a client for ‘open’ name servers. That is, it let the user
have an Internet recognized name for his machine by transferring to him
some control over a name server that he does not manage. 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. The name servers that are supported by inayn are:
http://www.dyndns.org and http://freedns.afraid.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.
Print a summary of the options to inadyn and exit.
The username, if applicable. This might be referred to as hash.
The password, if applicable.
A host name alias. This option can appear multiple times, for
each domain that has the same IP.
The file name that contains inadyn 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 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.
The client IP is detected by calling ’url’ from this
’ip_server_name:port’. Defaults to checkip.dyndns.org:80 /.
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.
The update path inside the DynDNS server.
An optional DNS service. For http://www.dyndns.org the
acceptable services are one of firstname.lastname@example.org,
email@example.com or firstname.lastname@example.org. There is only one
acceptable service for http://freedns.afraid.org , which is
email@example.com. Other services are:
firstname.lastname@example.org, custom@http_svr_basic_auth. The default
service is email@example.com, which is believed to be used by
most users, at least initially.
An http proxy server name and port. The default is none.
How often the IP is checked. This value denotes millisecond
(There are 1000 milliseconds in one second). The default is
about 1 minute. The maximum is 10 days.
How often the IP is checked. Here the value denotes seconds. The
default is about 1 minute. The maximum value is 10 days.
How often the IP should be updated even if it is not changed.
The time should be given in seconds.
The name, including the full path, of a log file.
run in background. Output is sent to the UNIX syslog facilities
or to a log file, if one was specified.
Set the debug level, which is an integer between 0 to 5.
Set the number of DNS updates. The default is 0, which means
Explicitly sending the output to a syslog like file, such as
After init changes user ID and group ID to the provided ones.
This allows dropping unneeded [root] privileges after startup.
inadyn -u username -p password -a my.registered.name
inadyn --username test --password test --update_period 60000 --alias
test.homeip.net --alias my.second.domain
inadyn --background -u test -p test --update_period 60000 --alias
inarcis.homeip.net --alias my.second.domain --log_file
inadyn --dyndns_service firstname.lastname@example.org -a
inadyn --update_period 60000 --alias test.homeip.net,hash_for_host1 -a
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 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
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 command.
When the user has several names then each name should be followed with
that name hash string.
inadyn prints a message when the IP is updated. If no update is needed
then by default it prints a single ’.’ character, unless --verbose is
set to 0. Therefore, unless --verbose is set to 0, the log file will
contains lot of dots. When the connection goes down it could be that
inadyn will print some error messages. Those are harmless and should be
followed by ’OK’ messages after the connection is back up.
Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn to terminate
Other manual pages
The syntax of the optional configuration file is given by
Inadyn ´s home page is http://inadyn.ina-tech.net.
inadyn was written by Narcis Ilisei, <email@example.com>.
This manual page was written by Shaul Karl, <firstname.lastname@example.org>, for the
Debian GNU/Linux system, based on the readme.html file that is found in