|INADYN(8)||System Manager's Manual (smm)||INADYN(8)|
inadyn, or In-a-Dyn, periodically checks your actual Internet accessible IP for changes. When it changes
inadynupdates your name server record(s) automatically. Common DDNS service providers supported by
inadynare listed below. Some of these services are free of charge for non-commercial use, others take a small fee, but also provide more domain names to choose from.
inadyndefaults to HTTPS for all providers, some may however not support this so try disabling SSL for your provider in case of problems. Providers known to support SSL updates are listed below with https. The list is ordered by the plugin that support the service:
inadynsupported more command line options, from v2.0
inadynhas been greatly simplified. See inadyn.conf(5) for details of the /etc/inadyn.conf configuration file format.
--forceto for an update before exiting.
--onceflag, ignored for all other use-cases.
inadynfrom banning you for excessive updates. When restarting
inadynor rebooting your server, or embedded device,
inadynreads the cache files to seed its internal data structures with the last sent IP address and when the update was performed. It is therefore very important to both have a cache file and for it to have the correct time stamp. The absence of a cache file will currently cause a forced update. On an embedded device with no RTC, or no battery backed RTC, it is strongly recommended to pair this setting with the
--startup-delaySEC command line option.
inadynto not exit on errors from a DDNS provider and instead try again later. Please do not use this, it usually indicates that we are sending a malformed request, e.g. wrong username, password or DNS alias for the given account. Continuing could possibly lock you out of your account!
cmdis called for each listed host name. If
inadynis started with the
-iIFNAME command line option, the INADYN_IFACE environment variable is also set. You will need to quote the complete command if any arguments, or pipe, is given.
inadynwill report the IP address of IFNAME to all DDNS providers listed in the configuration file. This can be useful to register LAN IP addresses, or, when connected directly to a public IP address, to speed up the IP check if the DDNS provider's check-ip servers are slow to respond. This option can also be given as a configuration option in inadyn.conf(5), both serve a purpose, use whichever one works for you.
inadyn, or to simply replace the
inadynname with something more generic, e.g. "DDNS", without renaming the binary. Note, this option only changes the base name of the PID file, not the location, which is system specific. Usually /var/run/inadyn.pid or /run/inadyn.pid.
-soption if you still want to redirect log messages to the syslog.
inadyncreates a PID file so users can easily find the PID of the process to send signals to. See SIGNALS for more information on this. This option tells
inadynto not create a PID file. Some users prefer this when running under systemd.
--identNAME, which is strongly recommended to change over this option. However, some users want to keep application runtime files in separate directories, usually in combination with
--drop-privs, for such cases this is the option to use.
-n, log messages are printed to stdout.
inadynresponds to signals. Intended to allow time for embedded devices without a battery backed real time clock to set their clock via NTP at bootup. This is so that the time since the last update can be calculated correctly from the
inadyncache file and the
forced-updateSEC setting honored across reboots, avoiding unnecessary IP address updates.
inadynprints a message when the IP is updated. If no update is needed then by default it prints a single “.” character, unless
--loglevelis set to none. Therefore, unless
--loglevelis set to none, the log will contain lots of dots. When the connection goes down
inadynmay print some harmless error messages which should be followed by “OK” messages after the Internet connection is restored.
inadynresponds to the following signals:
.conffile, standard UNIX behavior
inadynto exit gracefully
inadyndoes not track such events by itself. You need an external monitor for that
inadynwrites its process ID to /var/run/inadyn.pid, unless the
--identNAME option is used.
inadynhome page is at GitHub: ⟨https://github.com/troglobit/inadyn⟩
inadynwas originally written by Narcis Ilisei ⟨mailto:email@example.com⟩ and Steve Horbachuk. Current patch monkey is Joachim Wiberg ⟨mailto:firstname.lastname@example.org⟩ with a lot of help from Andrey Tikhomirov and Mike Fleetwood. This manual page was originally written for the Debian GNU/Linux project by Shaul Karl ⟨mailto:email@example.com⟩, and is currently maintained by Joachim Wiberg.
|February 20, 2020||Debian|