1inadyn-mt(8) System management commands inadyn-mt(8)
3
7 inadyn-mt - a client for open DNS servers.
8
10 inadyn-mt [-h | --help] [-u | --username username ] [-p | -- password
11 password ] [-a | --alias[,hash] alias,hash [-a | --alias[,hash]
12 another_alias,the_other_hash ... ]] [--input_file path/name ]
13 [--ip_server_name server[:port] url ] [--dyndns_server_name[:port]
14 server[:port] ] [--dyndns_system service ] [--proxy_server[:port]
15 proxy[:port] ] [--update_period ms ] [--update_period_sec sec ]
16 [--forced_update_period sec ] [--log_file path/name ] [--background]
17 [--verbose level ] [--iterations iterations ] [--syslog] ]
18 [--change_persona uid[:gid] ]
19
21 inadyn-mt is a client for `open' name servers. That is, it let the user
22 have an Internet recognized name for his machine by transferring to him
23 some control over a name server that he does not manage. Some of the
24 services that are offered by those open name servers are free of
25 charge, and work even when the client machine does not have a static
26 IP.
27 Supported name servers are:
29 http://www.dyndns.org
31 http://freedns.afraid.org,
33 http://www.zoneedit.com,
35 http://www.no-ip.com,
37 http://www.easydns.com,
39 http://www.3322.org,
41 http://www.sitelutions.com,
43 http://www.tzo.com,
45 http://www.dnsomatic.com,
47 http://www.tunnelbroker.net,
49 http://www.dynsip.org
51 Its basic operation is to periodically check whether the actual IP of
54 the client machine is the same one that is recorded in the name server,
55 and update the name server records when there is a mismatch.
56 Also, network status can be checked at a user specified interval, and
58 audible alerts issued in event of network status down.
59 OPTIONS
62 -h, --help
63 Print a summary of the options to inadyn-mt and exit.
64 -u, --username
66 The username, if applicable. This might be referred to as hash.
67 -p, --password
69 The password, if applicable.
70 -a, --alias[,hash]
72 A host name alias. This option can appear multiple times, for
73 each domain that has the same IP.
74 --input_file
76 The file name that contains inadyn-mt command options exactly as
77 specified in the command line syntax (adds to those already
78 present in the cmd line). The default configuration file name is
79 '/etc/inadyn.conf'. It is looked at automatically if inadyn-mt
80 is called without any command line options. The format is as
81 expected for a **NIX config the hash character is used to com‐
82 ment entire lines. Spaces are ingored. The long options may be
83 specified without -- if placed at the beginning of the line.
84 --ip_server_name[:port] url
86 The client IP is detected by calling 'url' from this
87 'ip_server_name:port'. Defaults to checkip.dyndns.org:80 /.
88 --dyndns_server_name[:port]
90 The server that receives the update DNS requests. When no proxy
91 is specified it is sufficient to set the dyndns_system so that
92 the default servers will be taken. The option is useful for
93 generic DynDNS services that support HTTP update.
94 --dyndns_server_url name
96 The update path inside the DynDNS server.
97 --dyndns_system
99 An optional DNS service. For http://www.dyndns.org ⟨⟩ the
100 acceptable services are one of dyndns@dyndns.org, statdns@dyn‐
101 dns.org or custom@dyndns.org. There is only one acceptable ser‐
102 vice for http://freedns.afraid.org ⟨⟩ ,which is
103 default@freedns.afraid.org. Other services are:
104 default@zoneedit.com, default@no-ip.com, default@easydns.com,
105 dyndns@3322.org, default@sitelutions.com, cus‐
106 tom@http_svr_basic_auth. The default service is dyndns@dyn‐
107 dns.org, which is believed to be used by most users, at least
108 initially.
109 --proxy_server[:port]
111 An http proxy server name and port. The default is none.
112 --update_period
114 How often the IP is checked. This value denotes millisecond
115 (There are 1000 milliseconds in one second). 30000..864000000.
116 Default is about 2 min. maximum is 10 days.
117 --update_period_sec
119 How often the IP is checked. Here the value denotes seconds.
120 30..864000. The default is about 2 minute. The maximum value
121 is 10 days.
122 --forced_update_period
124 How often the IP should be updated even if it is not changed.
125 The time should be given in seconds. 30 sec..30 days. Default,
126 30 days.
127 --log_file
129 The name, including the full path, of a log file.
130 --background
132 run in background. Output is sent to the UNIX syslog facilities
133 or to a log file, if one was specified.
134 --verbose
136 Set the debug level, which is an integer between 0 to 5.
137 --iterations
139 Set the number of DNS updates. The default is 0, which means
140 infinity.
141 --syslog
143 Explicitly sending the output to a syslog like file, such as
144 /var/log/messages.
145 --change_persona uid[:gid]
147 After init changes user ID and group ID to the provided ones.
148 This allows dropping unneeded [root] privileges after startup.
149 --retries
151 Network comm retry attempts. 0 to 100, default 0.
152 --retry_interval
154 Network comm miliseconds retry interval, 0 to 30,000, default
155 1,000.
156 --retry_pending
158 Retry ip update even after network comm retries exhausted,
159 default on.
160 --retry_pending_interval
162 Network comm miliseconds update retry interval, after retries
163 exhausted. 0 to 30,000, default 5,000
164 --lang_file
166 Language file path, and file name, defaults to either ../inadyn-
167 mt/lang/en.lng, or etc/inadyn-mt/en.lng. No parameter option
168 gives hard coded defaults.
169 --online_check_url
171 <srv_name[:port] local_url> - URL to reach to confirm online
172 status. Default value: --ip_server_name, or checkip.dyndns.org.
173 --status_interval
175 Seconds [30..864000] interval at which to check online status,
176 defaults to 30.
177 --alert_retries
179 Network retries before audible network status alerts. [0..100],
180 default 0.
181 --status_offline_interval
183 Seconds [0..864000] interval at which to check online status,
184 after offline detected, defaults to 30.
185 --audible
187 Audible network status alerts toggle (log output only), default
188 off.
189 --wave_file
191 Audible network status alerts wave file path, and file name.
192 defaults to either ../inadyn-mt/extra/wav/alarm.wav, or etc/ina‐
193 dyn-mt/extra/wav/alarm.wav. [wave loops: 0..100; -1 for infi‐
194 nite] same as wave_loops below -- optional number of times per
195 wave play call to repeat wave file play, default 0.
196 --wave_loops
198 Same as wave_file parameter optional parameter -- 0..100; -1 for
199 infinite number of times per wave play call to play wave file.
200 --wave_buff
202 Wave file output buffer size control -- integer or float multi‐
203 ple of wave file bytes per sec. [.25..10], default .25.
204 --wave_gain
206 gain (amplitude adjust) at which to play audible alert (beware
207 clipping), integer or float. [-10..10], default 10 (0db, no
208 attenuation).
209 --alert_interval
211 Time in miliseconds between consecutive audible network status
212 alerts, [0..3600000], default 0.
213
215 http://www.dyndns.org
216 ⟨⟩
217 inadyn-mt
219 -u username -p password -a my.registered.name
220 inadyn-mt
222 --username test --password test --update_period 60000 --alias
223 test.homeip.net --alias my.second.domain
224 inadyn-mt
226 --background -u test -p test --update_period 60000 --alias inar‐
227 cis.homeip.net --alias my.second.domain --log_file inadyn-mt.log
228 http://freedns.afraid.org
230 ⟨⟩
231 inadyn-mt
233 --dyndns_service default@freedns.afraid.org -a my.regis‐
234 trated.name,hash_from_freedns
235 inadyn-mt
237 --update_period 60000 --alias test.homeip.net,hash_for_host1 -a
238 my.second.domain,hash2 --dyndns_system
239 default@freedns.afraid.org
240 The 'hash' should be extracted from the grab url batch file that can be
242 downloaded from the site. A single hashed (base64 encoded) string is
243 preferred upon a username and password pair, apparently to reduce the
244 computational resources that is required on their side. Unfortunately
245 the hash can not be computed by inadyn-mt because it requires the index
246 to the username record in the freedns database, which is not known. The
247 simplest solution seems to be a copy&paste action from the grab url
248 batch file offered on their website. When the batch file looks is like
249 graburl http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUI‐
251 HEOIFEOIHJFEIO=
252 the hash string, which is what the user should copy and paste, is the
254 string that begins right after the '?' character and ends with the end
255 of line. This string shell be used as the username in inadyn-mt com‐
256 mand. When the user has several names then each name should be fol‐
257 lowed with that name hash string.
258
260 inadyn-mt prints a message when the IP is updated. If no update is
261 needed then by default it prints a single '.' character, unless --ver‐
262 bose is set to 0. Therefore, unless --verbose is set to 0, the log
263 file will contains lot of dots. When the connection goes down it could
264 be that inadyn-mt will print some error messages. Those are harmless
265 and should be followed by 'OK' messages after the connection is back
266 up.
267
270 Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn-mt to terminate
271 gracefully.
272
275 Other manual pages
276 The syntax of the optional configuration file is given by inadyn-
277 mt.conf(5).
278 Internet resources
280 inadyn: http://www.inatech.eu/inadyn/ ⟨⟩
281 inadyn-advanced: http://sourceforge.net/projects/inadyn-advanced/ ⟨⟩
283 inadyn-mt: http://sourceforge.net/projects/inadyn-mt/ ⟨⟩
285
288 inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.com>; inadyn-
289 advanced, Steve Horbachuk; inadyn-mt unicode, other augmentations,
290 Bryan Hoover <bhoover@wecs.com>
291 This manual page was written by Shaul Karl, <shaul@debian.org>, for the
293 Debian GNU/Linux system, based on the readme.html file that is found in
294 the source.
295Linux applications September, 2009 inadyn-mt(8)