INADYN(8)						    System management commands							 INADYN(8)

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.  Unfortu-
       nately  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  fol-
       lowed 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.

Linux applications						   October, 2004							 INADYN(8)