INADYN(8) | System Manager's Manual (smm) | INADYN(8) |
inadyn
— a small
DDNS client to maintain your presence on the Internet
inadyn |
[-a,
--alias ALIAS[,HASH]]
[-b, --background ]
[-B, --bind IFNAME]
[-d, --drop-privs USER[:GROUP]]
[-e, --exec SCRIPT]
[-f, --forced-update SEC]
[-F, --config FILE]
[-L, --logfile FILE]
[-P, --pidfile FILE]
[-c, --cachefile FILE]
[-s, --syslog ]
[-h, --help ]
[-i, --iface IFNAME]
[-n, --iterations NUM]
[-H, --checkip-url SERVER[:PORT] URL]
[-N, --server-name SERVER[:PORT]]
[-U, --server-url PATH]
[-S, --system PROVIDER]
[-t, --test ]
[-T, --period SEC]
[-u, --username USERNAME]
[-p, --password PASSWORD]
[-v, --version ]
[-V, --verbose LEVEL]
[-w, --wildcard ]
[-x, --proxy-server SERVER[:PORT]] |
inadyn
is a client for
“open” name servers, also known as DDNS service providers.
That is, it lets you have a public Internet name for your DHCP/PPPoE
assigned system. Some of these services are free of charge for
non-commercial use, others take a small fee, but also provide more domains
to choose from.
Common DDNS service providers supported by
inadyn
:
The basic operation of inadyn
is to
periodically check whether the actual Internet accessible IP of your system
is the same one that is recorded in the name server, and update the name
server records when there is a mismatch.
-h,
--help
-u,
--username
USERNAME-p,
--password
PASSWORD-a,
--alias
ALIAS-F,
--config
FILEinadyn
command options
exactly as specified in the command line syntax (adds to those already
present on the cmd line). The default configuration file name,
/etc/inadyn.conf, is looked at automatically if
inadyn
is called without any command line options.
The format is as expected for a UNIX config file; 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.-H,
--checkip-url
SERVER[:PORT]
URL-N,
--server-name
SERVER[:PORT]--system
option so that the default servers will be taken. The option is useful for
generic DynDNS services that support HTTP update.-U,
--server-url
PATH-S,
--system
email@ddns-service.tlddefault@dyndns.org
default@freedns.afraid.org
default@zoneedit.com
default@no-ip.com
default@easydns.com
default@tzo.com
dyndns@3322.org
default@dnsomatic.com
ipv6tb@he.net
dyndns@he.net
default@dynsip.org
default@sitelutions.com
default@dnsexit.com
default@changeip.com
custom@http_svr_basic_auth
-x,
--proxy-server
SERVER[:PORT]-T,
--period
SEC-f,
--forced-update
SEC--L,
--logfile
FILE---syslog
option, below.-b,
--background
-V,
--verbose
LEVEL-n,
--iterations
NUM-s,
--syslog
-d,
--drop-privs
USER[:GROUP]-B,
--bind
IFNAME-i,
--iface
IFNAME-P,
--pidfile
FILE-c,
--cachefile
FILE-e,
--exec
SCRIPT--iface
option used.-w,
--wildcard
inadyn
< 1.96.3 wildcarding was enabled by
default.-t,
--test
inadyn
-u username -p
password -a my.registered.name
inadyn
--username
username --password password --period 60 --alias
test.homeip.net --alias my.second.domain
inadyn
--background -u
test -p test --period 60 --alias test.homeip.net
--alias my.second.domain --logfile
inadyn_srv.log
inadyn
--system
default@freedns.afraid.org -u username -p password
-a my.registrated.name
inadyn
-u username -p
password --period 60 --alias test.homeip.net
-a my.second.domain --system
default@freedns.afraid.org
The “hash” is automatically retrieved by
inadyn
using freedns API.
inadyn
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
will print some error messages. Those
are harmless and should be followed by “OK” messages after the
connection is back up.
inadyn
responds to the following
signals:
inadyn
. The configuration file is reread
every time this signal is evoked. It is also useful when a new DHCP/PPPoE
lease or new gateway is received. Please note that
inadyn
does not track such events by itself. You
need an external monitor for that.inadyn
gracefully.For convenience in sending signals, inadyn
writes its process ID to /var/run/inadyn/inadyn.pid
upon startup.
inadyn.conf(5)
The inadyn
home page is
http://github.com/troglobit/inadyn
inadyn
was written by
Narcis Ilisei
⟨inarcis2002@hotpop.com⟩, Steve Horbachuk and
later Joachim Nilsson
⟨troglobit@gmail.com⟩.
This manual page was initially written for the Debian GNU/Linux system by Shaul Karl ⟨shaul@debian.org⟩. Later Joachim Nilsson picked up maintenance.
October 31, 2010 | Debian |