NAME¶
inadyn - a client for open DNS servers.
SYNOPSIS¶
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] ]
DESCRIPTION¶
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.
OPTIONS¶
- -h, --help
- Print a summary of the options to inadyn and
exit.
- -u, --username
- The username, if applicable. This might be referred to as
hash.
- -p, --password
- The password, if applicable.
- -a, --alias[,hash]
- A host name alias. This option can appear multiple times,
for each domain that has the same IP.
- --input_file
- 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.
- --ip_server_name[:port] url
- The client IP is detected by calling 'url' from this
'ip_server_name:port'. Defaults to checkip.dyndns.org:80 /.
- --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 name
- The update path inside the DynDNS server.
- --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, custom@http_svr_basic_auth. 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). The default is about 1
minute. The maximum is 10 days.
- --update_period_sec
- How often the IP is checked. Here the value denotes
seconds. The default is about 1 minute. 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.
- --log_file
- The name, including the full path, of a log file.
- --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.
TYPICAL USAGE¶
http://www.dyndns.org
- 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_srv.log
http://freedns.afraid.org
- inadyn
- --dyndns_service default@freedns.afraid.org -a
my.registrated.name,hash_from_freedns
- inadyn
- --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 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 command. When the user has
several names then each name should be followed with that name hash string.
OUTPUT¶
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.
Signals¶
Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn to terminate gracefully.
SEE ALSO¶
Other manual pages¶
The syntax of the optional configuration file is given by
inadyn.conf(5).
Internet resources¶
Inadyn ´s home page is
http://inadyn.ina-tech.net.
AUTHOR¶
inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.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.