Provided by: inadyn_1.96.2-1_amd64 bug

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.