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 alias[, hash] [dual | coupled | ip4 | ip6 |
12 auto] [if] [pub | policy | home | careof | crypto | nocrypto | tmp |
13 pubtmp] [ip server[:port] <ip server url> [ip server host]]
14 [--input_file path/name] [--ip_server_name server[:port] url]
15 [--ip_server_host hostname] [--dyndns_server_name server[:port]]
16 [--dyndns_server_url url] [--dyndns_system service]
17 [--proxy_server[:port] proxy[:port]] [--update_period ms]
18 [--update_period_sec sec] [--forced_update_period sec] [--log_file
19 path/name] [--background] [--verbose level] [--iterations iterations]
20 [--syslog] [--change_persona uid[:gid]]
21
24 inadyn-mt is a client for `open' name servers. That is, it allows the
25 user's machine to have an internet recognized name by transferring some
26 control over a name server not managed by the user. Some of the ser‐
27 vices that are offered by those open name servers are free of charge,
28 and work even when the client machine does not have a static IP. Sup‐
29 ports both IPv4, and IPv6 addresses.
30 Supported name servers are:
32 http://www.dyndns.org
34 http://freedns.afraid.org
36 http://www.zoneedit.com
38 http://www.no-ip.com
40 http://www.easydns.com
42 http://www.3322.org
44 http://www.sitelutions.com
46 http://www.tzo.com
48 http://www.dnsomatic.com
50 http://www.tunnelbroker.net
52 http://www.dynsip.org
54 http://www.dhis.org
56 http://www.zerigo.com
58 http://www.two-dns.de
60 http://www.dnsdynamic.org
62 http://dnspark.com
64 http://regfish.de
66 http://www.ovh.com
68 http://joker.com
70 http://dyndns.strato.com
72 http://system-ns.com
74 http://www.dtdns.com
76 http://changeip.com
78 http://dnsexit.com
80 http://nsupdate.info
82 http://loopia.com
84 http://domains.google.com (requires SSL bridge, like stunnel)
86 http://duckdns.org
88 http://www.dy.fi
90 http://ddnss.de
92 http://dynv6.com
94 http://selfhost.de
96 Its basic operation is to periodically check whether the actual IP of
98 the client machine is the same one that is recorded in the name server,
99 and update the name server records when there is a mismatch.
100 For IPv6 addresses, see below, alias, and ip_server_name options.
102 Also, network status can be checked at a user specified interval, and
104 audible alerts issued in event of network status down.
105 OPTIONS
108 -h, --help
109 Print a summary of the options to inadyn-mt and exit.
110 -u, --username username
112 The username, if applicable. This might be referred to as hash.
113 -p, --password password
115 The password, if applicable.
116 -a, --alias alias[, hash] [ip type] [if] [addr pref] [ip server[:port]
118 <ip server url> [ip server host]]
119 A host name alias, optional comma delimited hash, and optional
120 ip version (default auto), network interface, address prefer‐
121 ence, ip server (and optional colon delimited port) and url, ip
122 server host. This option can appear multiple times.
123 IP types are dual, coupled, ip4, ip6, or auto. IP type auto is
125 the default. IP type dual (for dual ip stack), denotes the
126 alias should be updated to both ipv6, ipv4. Coupled is like
127 dual, but denotes DDNS server accepts dual stack updates in a
128 single request, where the ipv4, ipv6 addresses are presented as
129 a comma delimited list.
130 Network interface parameter should denote the network interface
132 to be used as the ip server connect source address. When this
133 parameter is opted, unless ip type is ip4, the alias will be
134 updated to the ipv6 address obtained from this interface, along
135 with, if indicated, the ipv4 address obtained from ip server.
136 The addr pref parameter denotes ipv6 privacy extentions address
138 preference. It can be one of either pub, policy, home, careof,
139 crypto, nocrypto, tmp, pubtmp. Logical OR not yet supported.
140 The default is pub.
141 Use the ip server parameter for other than the DDNS server's ip
143 server as per default inadyn-mt hard coded configuration set‐
144 tings. It can include a colon delimted port number. It must be
145 accompanied by a url parameter. Finally, an ip server host can
146 be designated - useful in case of ip server running on multiple
147 server hosts, or the ip server domain name used to reach the
148 server otherwise differs from actual ip server domain name.
149 Except the host (alias) parameter, all of these parameters are
151 optional, but order matters.
152 --input_file file
155 The file name that contains inadyn-mt command options exactly as
156 specified in the command line syntax (adds to those already
157 present in the cmd line). The default configuration file name is
158 '/etc/inadyn-mt.conf'. It is looked at automatically if inadyn-
159 mt is called without any command line options. The format is as
160 expected for a **NIX config the hash character is used to com‐
161 ment entire lines. Spaces are ingored. The long options may be
162 specified without -- if placed at the beginning of the line.
163 --ip_server_name server[:port] url
165 The client IP is detected by calling 'url' from this
166 'server:port'.
167 Choice of ip server name parameter option can determine what
169 type of address is updated. To update an IPv6 address, simply
170 choose an ip server that supports IPv6, such as, ip6.me /,
171 myip.dk /, dhis.org /, among others. And, of course, dynamic
172 dns server should be set to one that supports IPv6.
173 --ip_server_host hostname
175 Host name used in http request to ip server if different from ip
176 server name, as when, e.g., ip_server_name is 'localhost:port /'
177 through an SSL bridge. Defaults to ip server name.
178 --dyndns_server_name server[:port]
180 The server that receives the update DNS requests. When no proxy
181 is specified it is sufficient to set the dyndns_system so that
182 the default servers will be taken. The option is useful for
183 generic DynDNS services that support HTTP update.
184 --dyndns_server_url url
186 The update path inside the DynDNS server.
187 --dyndns_server_host hostname
189 Host name used in http update DNS request, if different from
190 dyndns server name, as when, e.g., ip_server_name is 'local‐
191 host:port' through an SLL bridge. Defaults to dyndns server
192 name.
193 --dyndns_system system
195 An optional DDNS service (dyndns@dyndns.org is the default). For
196 http://www.dyndns.org
198 the acceptable services are one of dyndns@dyndns.org or
200 dual@dyndns.org, statdns@dyndns.org or custom@dyndns.org.
201 There is only one acceptable service for
203 http://freedns.afraid.org, which is default@freedns.afraid.org.
204 This option can be used multiple times - once for each DDNS
206 server to update - followed by --alias, and other options corre‐
207 sponding to the --dyndns_system entry. Per --dyndns_system entry
208 options are username, password, alias, ip_server_name,
209 ip_server_host, dyndns_server_name, dyndns_server_url, dyn‐
210 dns_server_host, and proxy_server.
211 Other services are:
213 default@zoneedit.com
214 default@no-ip.com
215 default@easydns.com
216 dyndns@3322.org
217 default@sitelutions.com
218 default@dnsomatic.com
219 ipv6tb@he.net
220 default@tzo.com
221 default@dynsip.org
222 default@dhis.org
223 default@zerigo.com
224 default@two-dns.de
225 default@dnsdynamic.org
226 default@dnspark.com
227 ipv4@regfish.de
228 ipv6@regfish.de
229 default@ovh.com
230 default@joker.com
231 default@strato.com
232 default@system-ns.com
233 default@dtdns.com
234 default@changeip.com
235 default@dnsexit.com
236 ipv4@nsupdate.info
237 ipv6@nsupdate.info
238 default@loopia.com
239 default@domains.google.com
240 Requires SSL bridge, like stunnel; set --server_host_name
241 domains.google.com
242 default@duckdns.org
243 default@dy.fi
244 default@ddnss.de
245 ipv4@dynv6.com
246 ipv6@dynv6.com
247 dual@dynv6.com
248 default@selfhost.de
249 custom@http_svr_basic_auth
250 See also custom server options, --svr_rsp_success,
251 --svr_rsp_other, --svr_ip_param, --svr_ip_in_rsp
252 The default service is dyndns@dyndns.org.
253 --proxy_server proxy[:port]
255 An http proxy server name and port. The default is none.
256 --update_period milliseconds
258 How often the IP is checked. This value denotes millisecond
259 (There are 1000 milliseconds in one second). 30000..864000000.
260 Default is about 10 min. maximum is 10 days.
261 --update_period_sec seconds
263 How often the IP is checked. Here the value denotes seconds.
264 30..864000. The default is about 10 min. The maximum value is
265 10 days.
266 --forced_update_period seconds
268 How often the IP should be updated even if it is not changed.
269 The time should be given in seconds. 30 sec..30 days. Default,
270 30 days.
271 --forced_update_adjust control
273 Fine timer control. Slow, or speed timer between -4..5.
274 Default, 0.
275 --log_file file
277 The name, including the full path, of a log file.
278 --cache_dir dir
280 Directory to which ip, and time update files are written.
281 Defaults to /tmp on **NIX systems.
282 --background
284 run in background. Output is sent to the UNIX syslog facilities
285 or to a log file, if one was specified.
286 --verbose level
288 Set the debug level, which is an integer between 0 to 5.
289 --iterations number
291 Set the number of DNS updates. The default is 0, which means
292 infinity.
293 --syslog
295 Explicitly sending the output to a syslog like file, such as
296 /var/log/messages.
297 --change_persona uid[:gid]
299 After init changes user ID and group ID to the provided ones.
300 This allows dropping unneeded [root] privileges after startup.
301 --retries number
303 Network comm retry attempts. 0 to 100, default 0.
304 --retry_interval milliseconds
306 Network comm miliseconds retry interval, 0 to 30,000, default
307 1,000.
308 --retry_pending
310 Retry ip update even after network comm retries exhausted,
311 default on.
312 --retry_pending_interval seconds
314 Network comm seconds update retry interval, after retries
315 exhausted. 5 to 3600, default 300.
316 --lang_file file
318 Language file path, and file name, defaults to either ../inadyn-
319 mt/lang/en.lng, or etc/inadyn-mt/en.lng. No parameter option
320 gives hard coded defaults.
321 --online_check_url srv_name[:port] url
323 srv_name[:port] url - URL to reach to confirm online status.
324 --status_interval seconds
326 Seconds [30..864000] interval at which to check online status,
327 defaults to 600.
328 --alert_retries number
330 Network retries before audible network status alerts. [0..100],
331 default 0.
332 --status_offline_interval seconds
334 Seconds [0..864000] interval at which to check online status,
335 after offline detected, defaults to 15.
336 --audible
338 Audible network status alerts toggle (log output only), default
339 off.
340 --wave_file file
342 Audible network status alerts wave file path, and file name.
343 defaults to either ../inadyn-mt/extra/wav/alarm.wav, or etc/ina‐
344 dyn-mt/extra/wav/alarm.wav. [wave loops: 0..100; -1 for infi‐
345 nite] same as wave_loops below -- optional number of times per
346 wave play call to repeat wave file play, default 0.
347 --wave_loops number
349 Same as wave_file parameter optional parameter -- 0..100; -1 for
350 infinite number of times per wave play call to play wave file.
351 --wave_buff number
353 Wave file output buffer size control -- integer or float multi‐
354 ple of wave file bytes per sec. [.25..10], default .25.
355 --wave_gain number
357 Gain (amplitude adjust) at which to play audible alert (beware
358 clipping), integer or float. [-10..10], default 10 (0db, no
359 attenuation).
360 --alert_interval milliseconds
362 Time in miliseconds between consecutive audible network status
363 alerts, [0..3600000], default 0.
364 --svr_rsp_success string
366 Optional for custom DDNS updates. A quoted comma delimited
367 string, e.g., "good, nochg", representing custom DDNS server
368 successful update return values.
369 --svr_rsp_other string
371 Optional for custom DDNS updates. A quoted comma delimited
372 string, e.g., "dnserr,911", representing custom DDNS server non-
373 fatal update failure return values.
374 --svr_ip_param param [user] [pass]
376 Optional for custom DDNS updates. DDNS url parameter for ip
377 address, e.g., myip.
378 --svr_ip_in_rsp
380 Optional for custom DDNS updates. Flag that custom DDNS server
381 returns your ip address on update success. Defaults to false.
382 --svr_auto_dual
384 Flag that server defaults to dual list (coupled) alias ip type.
385 Defaults to false.
386 --svr_auto_detect
388 Flag server auto detects ip. Defaults to false.
389 --svr_add_cfg file
391 Additional servers file. Default search for servers_addi‐
392 tional.cfg in ./extra, /etc, /etc/inadyn-mt, /etc/inadyn-
393 mt/extra. Contains additional preconfigured DDNS servers to be
394 used as --dyndns_system option parameter in same fashion as
395 servers inadyn-mt supports natively. Should appear before any
396 dyndns_system, option in inadyn-mt.conf or command line if not
397 using inadyn-mt.conf.
398 --if interface
400 Name of network interface to use for ip server, and DDNS server
401 comm. Defaults to system configured default.
402 --addr_pref preference
404 ipv6 privacy extensions address preference. Valid parameters
405 are 'pub,' 'policy,' 'home,' 'careof,' 'crypto,' 'nocrypto,'
406 'tmp,' 'pubtmp.' Defaults to 'pub.' See rfc5014. Combining
407 via logical OR not presently supported.
408 --if_enum
410 Enumerate network interfaces.
411
413 http://www.dyndns.org
414 inadyn-mt -u username -p password -a my.registered.name
415 inadyn-mt --username test --password test --update_period 60000 --alias
417 test.homeip.net --alias my.second.domain
418 inadyn-mt --background -u test -p test --update_period 60000 --alias
420 inarcis.homeip.net --alias my.second.domain --log_file inadyn-mt.log
421 http://freedns.afraid.org
424 inadyn-mt --dyndns_system default@freedns.afraid.org -a my.regis‐
425 trated.name,hash_from_freedns
426 inadyn-mt --update_period 60000 --alias test.homeip.net,hash_for_host1
428 -a my.second.domain,hash2 --dyndns_system default@freedns.afraid.org
429 This provider prefers to get as parameter a single hashed (base64
431 encoded) value.
432 As of inadyn-mt version 02.24.07-afraid_00_patch, aliases hashes can be
434 automatically obtained via sha1 hashed ´username|password´. To this
435 end, use options username, and password.
436 Otherwise, the freedns.afraid.org DDNS web user interface provides a
438 "Direct URL" link via which corresponding alias hash may be copied, and
439 pasted into inadyn-mt config as alias option hash paramter.
440 Example: Resulting address window url looks like this:
442 http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUI‐
443 HEOIFEOIHJFEIO=
444 The user has to copy and paste the hash value after the '?' until the
446 end of line.
447 The hash will be used as additional param in --alias option. (see typi‐
449 cal usage above)
450
453 inadyn-mt prints a message when the IP is updated. When the connection
454 goes down it could be that inadyn-mt will print some error messages.
455 Those are harmless and should be followed by 'OK' messages after the
456 connection is back up.
457
460 Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn-mt to terminate
461 gracefully. SIG_USR1 will cause inadyn-mt to update ip, if changed.
462
465 Other manual pages
466 The syntax of the optional configuration file is given by inadyn-
467 mt.conf(5).
468 Internet resources
470 inadyn:
471 http://www.inatech.eu/
473 inadyn-advanced:
476 http://sourceforge.net/projects/inadyn-advanced/
478 inadyn-mt:
481 http://sourceforge.net/projects/inadyn-mt/
483
487 inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.com>; inadyn-
488 advanced, Steve Horbachuk; inadyn-mt unicode, other augmentations,
489 Bryan Hoover <bhoover@wecs.com>
490 This manual page was written by Shaul Karl, <shaul@debian.org>, for the
492 Debian GNU/Linux system, based on the readme.html file that is found in
493 the source.
494Linux applications September, 2009 inadyn-mt(8)