1INADYN(8) System management commands INADYN(8)
3
7 inadyn - a client for open DNS servers.
8
10 inadyn [-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 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. The name servers that are supported by inayn are:
27 http://www.dyndns.org ⟨⟩ and http://freedns.afraid.org ⟨⟩
28 Its basic operation is to periodically check whether the actual IP of
30 the client machine is the same one that is recorded in the name server,
31 and update the name server records when there is a mismatch.
32 OPTIONS
34 -h, --help
35 Print a summary of the options to inadyn and exit.
36 -u, --username
38 The username, if applicable. This might be referred to as hash.
39 -p, --password
41 The password, if applicable.
42 -a, --alias[,hash]
44 A host name alias. This option can appear multiple times, for
45 each domain that has the same IP.
46 --input_file
48 The file name that contains inadyn command options exactly as
49 specified in the command line syntax (adds to those already
50 present in the cmd line). The default configuration file name is
51 '/etc/inadyn.conf'. It is looked at automatically if inadyn is
52 called without any command line options. The format is as
53 expected for a **NIX config the hash character is used to com‐
54 ment entire lines. Spaces are ingored. The long options may be
55 specified without -- if placed at the beginning of the line.
56 --ip_server_name[:port] url
58 The client IP is detected by calling 'url' from this
59 'ip_server_name:port'. Defaults to checkip.dyndns.org:80 /.
60 --dyndns_server_name[:port]
62 The server that receives the update DNS requests. When no proxy
63 is specified it is sufficient to set the dyndns_system so that
64 the default servers will be taken. The option is useful for
65 generic DynDNS services that support HTTP update.
66 --dyndns_server_url name
68 The update path inside the DynDNS server.
69 --dyndns_system
71 An optional DNS service. For http://www.dyndns.org ⟨⟩ the
72 acceptable services are one of dyndns@dyndns.org, statdns@dyn‐
73 dns.org or custom@dyndns.org. There is only one acceptable ser‐
74 vice for http://freedns.afraid.org ⟨⟩ , which is
75 default@freedns.afraid.org. Other services are:
76 default@zoneedit.com, custom@http_svr_basic_auth. The default
77 service is dyndns@dyndns.org, which is believed to be used by
78 most users, at least initially.
79 --proxy_server[:port]
81 An http proxy server name and port. The default is none.
82 --update_period
84 How often the IP is checked. This value denotes millisecond
85 (There are 1000 milliseconds in one second). The default is
86 about 1 minute. The maximum is 10 days.
87 --update_period_sec
89 How often the IP is checked. Here the value denotes seconds. The
90 default is about 1 minute. The maximum value is 10 days.
91 --forced_update_period
93 How often the IP should be updated even if it is not changed.
94 The time should be given in seconds.
95 --log_file
97 The name, including the full path, of a log file.
98 --background
100 run in background. Output is sent to the UNIX syslog facilities
101 or to a log file, if one was specified.
102 --verbose
104 Set the debug level, which is an integer between 0 to 5.
105 --iterations
107 Set the number of DNS updates. The default is 0, which means
108 infinity.
109 --syslog
111 Explicitly sending the output to a syslog like file, such as
112 /var/log/messages.
113 --change_persona uid[:gid]
115 After init changes user ID and group ID to the provided ones.
116 This allows dropping unneeded [root] privileges after startup.
117
121 http://www.dyndns.org
122 ⟨⟩
123 inadyn
125 -u username -p password -a my.registered.name
126 inadyn --username test --password test --update_period 60000 --alias
128 test.homeip.net --alias my.second.domain
129 inadyn --background -u test -p test --update_period 60000 --alias inar‐
131 cis.homeip.net --alias my.second.domain --log_file ina‐
132 dyn_srv.log
133 http://freedns.afraid.org
135 ⟨⟩
136 inadyn --dyndns_service default@freedns.afraid.org -a my.regis‐
138 trated.name,hash_from_freedns
139 inadyn --update_period 60000 --alias test.homeip.net,hash_for_host1 -a
141 my.second.domain,hash2 --dyndns_system
142 default@freedns.afraid.org
143 The 'hash' should be extracted from the grab url batch file that can be
145 downloaded from the site. A single hashed (base64 encoded) string is
146 preferred upon a username and password pair, apparently to reduce the
147 computational resources that is required on their side. Unfortunately
148 the hash can not be computed by inadyn because it requires the index to
149 the username record in the freedns database, which is not known. The
150 simplest solution seems to be a copy&paste action from the grab url
151 batch file offered on their website. When the batch file looks is like
152 graburl http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUI‐
154 HEOIFEOIHJFEIO=
155 the hash string, which is what the user should copy and paste, is the
157 string that begins right after the '?' character and ends with the end
158 of line. This string shell be used as the username in inadyn command.
159 When the user has several names then each name should be followed with
160 that name hash string.
161
163 inadyn prints a message when the IP is updated. If no update is needed
164 then by default it prints a single '.' character, unless --verbose is
165 set to 0. Therefore, unless --verbose is set to 0, the log file will
166 contains lot of dots. When the connection goes down it could be that
167 inadyn will print some error messages. Those are harmless and should be
168 followed by 'OK' messages after the connection is back up.
169
172 Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause inadyn to terminate
173 gracefully.
174
177 Other manual pages
178 The syntax of the optional configuration file is given by ina‐
179 dyn.conf(5).
180 Internet resources
182 Inadyn ´s home page is http://inadyn.ina-tech.net. ⟨⟩
183
185 inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.com>.
186 This manual page was written by Shaul Karl, <shaul@debian.org>, for the
188 Debian GNU/Linux system, based on the readme.html file that is found in
189 the source.
190Linux applications October, 2004 INADYN(8)