1
2inadyn-mt(8)              System management commands              inadyn-mt(8)
3
4
5

NAME

7       inadyn-mt - a client for open DNS servers.
8

SYNOPSIS

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
22

DESCRIPTION

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
31       Supported name servers are:
32
33       http://www.dyndns.org
34
35       http://freedns.afraid.org
36
37       http://www.zoneedit.com
38
39       http://www.no-ip.com
40
41       http://www.easydns.com
42
43       http://www.3322.org
44
45       http://www.sitelutions.com
46
47       http://www.tzo.com
48
49       http://www.dnsomatic.com
50
51       http://www.tunnelbroker.net
52
53       http://www.dynsip.org
54
55       http://www.dhis.org
56
57       http://www.zerigo.com
58
59       http://www.two-dns.de
60
61       http://www.dnsdynamic.org
62
63       http://dnspark.com
64
65       http://regfish.de
66
67       http://www.ovh.com
68
69       http://joker.com
70
71       http://dyndns.strato.com
72
73       http://system-ns.com
74
75       http://www.dtdns.com
76
77       http://changeip.com
78
79       http://dnsexit.com
80
81       http://nsupdate.info
82
83       http://loopia.com
84
85       http://domains.google.com (requires SSL bridge, like stunnel)
86
87       http://duckdns.org
88
89       http://www.dy.fi
90
91       http://ddnss.de
92
93       http://dynv6.com
94
95       http://selfhost.de
96
97       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
101       For IPv6 addresses, see below, alias, and ip_server_name options.
102
103       Also, network status can be checked at a user specified  interval,  and
104       audible alerts issued in event of network status down.
105
106
107   OPTIONS
108       -h, --help
109              Print a summary of the options to inadyn-mt and exit.
110
111       -u, --username username
112              The username, if applicable. This might be referred to as hash.
113
114       -p, --password password
115              The password, if applicable.
116
117       -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
124              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
131              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
137              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
142              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
150              Except  the  host (alias) parameter, all of these parameters are
151              optional, but order matters.
152
153
154       --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
164       --ip_server_name server[:port] url
165              The   client   IP   is  detected  by  calling  'url'  from  this
166              'server:port'.
167
168              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
174       --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
179       --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
185       --dyndns_server_url url
186              The update path inside the DynDNS server.
187
188       --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
194       --dyndns_system system
195              An optional DDNS service (dyndns@dyndns.org is the default). For
196
197              http://www.dyndns.org
198
199              the  acceptable  services  are  one  of   dyndns@dyndns.org   or
200              dual@dyndns.org, statdns@dyndns.org or custom@dyndns.org.
201
202              There     is     only     one     acceptable     service     for
203              http://freedns.afraid.org, which is default@freedns.afraid.org.
204
205              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
212              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
254       --proxy_server proxy[:port]
255              An http proxy server name and port. The default is none.
256
257       --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
262       --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
267       --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
272       --forced_update_adjust control
273              Fine  timer  control.   Slow,  or  speed  timer  between  -4..5.
274              Default, 0.
275
276       --log_file file
277              The name, including the full path, of a log file.
278
279       --cache_dir dir
280              Directory to which  ip,  and  time  update  files  are  written.
281              Defaults to /tmp on **NIX systems.
282
283       --background
284              run  in background. Output is sent to the UNIX syslog facilities
285              or to a log file, if one was specified.
286
287       --verbose level
288              Set the debug level, which is an integer between 0 to 5.
289
290       --iterations number
291              Set the number of DNS updates. The default  is  0,  which  means
292              infinity.
293
294       --syslog
295              Explicitly  sending  the  output  to a syslog like file, such as
296              /var/log/messages.
297
298       --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
302       --retries number
303              Network comm retry attempts.  0 to 100, default 0.
304
305       --retry_interval milliseconds
306              Network  comm  miliseconds  retry interval, 0 to 30,000, default
307              1,000.
308
309       --retry_pending
310              Retry ip update  even  after  network  comm  retries  exhausted,
311              default on.
312
313       --retry_pending_interval seconds
314              Network  comm  seconds  update  retry  interval,  after  retries
315              exhausted.  5 to 3600, default 300.
316
317       --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
322       --online_check_url srv_name[:port] url
323              srv_name[:port] url - URL to reach to confirm online status.
324
325       --status_interval seconds
326              Seconds [30..864000] interval at which to check  online  status,
327              defaults to 600.
328
329       --alert_retries number
330              Network  retries before audible network status alerts. [0..100],
331              default 0.
332
333       --status_offline_interval seconds
334              Seconds [0..864000] interval at which to  check  online  status,
335              after offline detected, defaults to 15.
336
337       --audible
338              Audible  network status alerts toggle (log output only), default
339              off.
340
341       --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
348       --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
352       --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
356       --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
361       --alert_interval milliseconds
362              Time in miliseconds between consecutive audible  network  status
363              alerts, [0..3600000], default 0.
364
365       --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
370       --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
375       --svr_ip_param param [user] [pass]
376              Optional  for  custom  DDNS  updates.  DDNS url parameter for ip
377              address, e.g., myip.
378
379       --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
383       --svr_auto_dual
384              Flag  that server defaults to dual list (coupled) alias ip type.
385              Defaults to false.
386
387       --svr_auto_detect
388              Flag server auto detects ip.  Defaults to false.
389
390       --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
399       --if interface
400              Name of network interface to use for ip server, and DDNS  server
401              comm.  Defaults to system configured default.
402
403       --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
409       --if_enum
410              Enumerate network interfaces.
411

TYPICAL USAGE

413   http://www.dyndns.org
414       inadyn-mt -u username -p password -a my.registered.name
415
416       inadyn-mt --username test --password test --update_period 60000 --alias
417       test.homeip.net --alias my.second.domain
418
419       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
422
423   http://freedns.afraid.org
424       inadyn-mt  --dyndns_system  default@freedns.afraid.org   -a   my.regis‐
425       trated.name,hash_from_freedns
426
427       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
430       This provider prefers to get  as  parameter  a  single  hashed  (base64
431       encoded) value.
432
433       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
437       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
441       Example:    Resulting    address    window   url   looks   like   this:
442       http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUI
443       HEOIFEOIHJFEIO=
444
445       The  user  has to copy and paste the hash value after the '?' until the
446       end of line.
447
448       The hash will be used as additional param in --alias option. (see typi‐
449       cal usage above)
450
451

OUTPUT

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
458

Signals

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
463

SEE ALSO

465   Other manual pages
466       The  syntax  of  the  optional  configuration  file is given by inadyn-
467       mt.conf(5).
468
469   Internet resources
470       inadyn:
471
472       http://www.inatech.eu/
473
474
475       inadyn-advanced:
476
477       http://sourceforge.net/projects/inadyn-advanced/
478
479
480       inadyn-mt:
481
482       http://sourceforge.net/projects/inadyn-mt/
483
484
485

AUTHOR

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
491       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.
494
495
496
497
498
499
500Linux applications              September, 2009                   inadyn-mt(8)
Impressum