Rechercher une page de manuel
inadyn
Langue: en
Version: September, 2009 (fedora - 01/12/10)
Section: 8 (Commandes administrateur)
Sommaire
NAME
inadyn-mt - a client for open DNS servers.SYNOPSIS
inadyn-mt [-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-mt 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.Supported name servers are: http://www.dyndns.org and 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.
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.
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]
- 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-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'. 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, default@no-ip.com, default@easydns.com, dyndns@3322.org, default@sitelutions.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.
- --retry_interval
- Network comm miliseconds retry interval, 0 to 30,000, default 1,000.
- --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
- --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_retries
- Network retries before audible network status alerts. [0..100], default 0.
- --alert_interval
- Time in miliseconds between consecutive audible network status alerts, [0..3600000], default 0.
- --audible
- Audible network status alerts toggle (log output only), default off.
- --status_interval
- Seconds [30..864000] interval at which to check online status, defaults to 30.
- --status_offline_interval
- Seconds [0..864000] interval at which to check online status, after offline detected, defaults to 30.
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
- inadyn-mt
- --dyndns_service 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. 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-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.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/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.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre