summaryrefslogtreecommitdiff
path: root/he-dns/README.md
diff options
context:
space:
mode:
authorJason D. McCormick <jason@mfamily.org>2022-12-11 13:19:29 -0500
committerJason D. McCormick <jason@mfamily.org>2022-12-11 13:19:29 -0500
commit2da68157a5994dfc46ea83ad5093e5f893925f02 (patch)
treea44ede64671a975755364b44aeb062315892dc6c /he-dns/README.md
parent7b0bfba024a1d7d0f12c159da6b9b7fecb7a6775 (diff)
new READme
Diffstat (limited to 'he-dns/README.md')
-rw-r--r--he-dns/README.md52
1 files changed, 0 insertions, 52 deletions
diff --git a/he-dns/README.md b/he-dns/README.md
deleted file mode 100644
index 7598c3a..0000000
--- a/he-dns/README.md
+++ /dev/null
@@ -1,52 +0,0 @@
-# he-dyndns
-A Python-based script to update dynamic DNS records when using the
-Hurricant Electric DNS service at ``dns.he.net``. This code is
-designed to ba maximally portable by relying on standard
-Python 3 libraries. It is not compatible with Python 2.
-
-# Installation
-There is really nothing to install unless you need to add
-Python3 stock libraries to your system. Copy he-dyndns somewhere useful
-such as `/usr/local/bin`.
-
-For Debian/Ubuntu systems: ``apt install python3-dns python3-dnspython python3-urllib3``
-
-For Fedora systems: ``dnf install python3-dns python3-urllib3``
-
-# Configuration
-Unless using the ``--key`` argument, keys for the dyanmic record
-are read from ``/etc/he-dyndns.conf`` or from an alternative
-location specified by ``--keyfile``. The configuration file
-format is one section [keys] with record = key pairs. For example:
-
-```
-[keys]
-dynamic.example.com = 123412341234
-```
-
-Other configuration sections will be ignored.
-
-# Usage
-```
-usage: he-dyndns [-h] [--v4] [--v6] [--addr4 ADDR4] [--addr6 ADDR6] [--key KEY] [--debug] record
-
-Update Hurricane Electric DNS dynamic record
-
-positional arguments:
- record DNS record to update
-
-optional arguments:
- -h, --help show this help message and exit
- --v4 Update IPv4 A record (default)
- --v6 Update IPv6 AAAA record
- --addr4 ADDR4 Update A record with provided IP rather than detected IP
- --addr6 ADDR6 Update AAAA record with provided IP rather than detected IP
- --keyfile KEYFILE Alternate location for key config file (default /etc/he-dns-secret.conf)
- --key KEY HE DDNS key for record (by default read from /etc/he-dns-secret.conf or --keyfile)
- --debug Enable debug logging
-
-```
-
-# Return Values
-Returns 0 on success (successful change or no change) or 1 on failure.
-Failures also include a single line error message.