ddns — Dynamic DNS update client
ddns [OPTIONS...] COMMAND
ddns is a simple, extensible, cross-distribution, cross-platform dynamic DNS updater written in Python.
The following options are understood:
-c CONFIG
,
--config CONFIG
Load the specified configuration file.
(Default: /etc/ddns/ddns.conf)
For further details of the config file layout, please consult the ddns.conf(5) manual page.
-d
,
--debug
Enables the debugging output.
-h
,
--help
Shows the help message provided by the program and exit.
The following commands are understood:
[--force] HOSTNAME
Perform an update for a single host, specified by the given hostname.
An update is only sent when it is needed: when the IP addresses have changed since the last update that has been sent, or when the provider wants to have its records refreshed. Before the first update of a host, its name is being resolved to find out whether its records are up to date.
After an update has failed, no further updates are being sent for some time, so that the provider does not block the account.
The --force switch can be used to skip those
checks and perform an update. Please note that some providers
may block your account if unnecessary updates are repeatedly
performed.
[--force]
Update all configured dynamic DNS hosts when an update is necessary. Updates for several hosts are being sent at the same time.
The --force switch has the same effect as
with the update command.
Guesses the public IPv6 and IPv4 addresses with help of an external server and prints them on the console.
This command will print out a list of all supported dynamic DNS providers.
This command will print out a list of all providers that support authentication with a token.
ddns logs to the systemd journal if python-systemd is
available, and otherwise to syslog. Messages about an update carry the
hostname and the provider in the fields DDNS_HOSTNAME
and DDNS_PROVIDER of the journal.
Passwords, tokens and other credentials from the configuration are never
being logged, not even with --debug, so that the output
can be shared in bug reports.
Success: all records are up to date.
An update has failed, or has been withheld because an earlier update has failed, or there has been another error (e.g. in the configuration file).
The command line was invalid.