From 545b985cae31ab9a4856249ad5bf356503c18372 Mon Sep 17 00:00:00 2001 From: "Jason D. McCormick" Date: Sun, 11 Dec 2022 12:56:12 -0500 Subject: move python readme to subfolder --- README.md | 52 ---------------------------------------------------- he-dns/README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+), 52 deletions(-) delete mode 100644 README.md create mode 100644 he-dns/README.md diff --git a/README.md b/README.md deleted file mode 100644 index 7598c3a..0000000 --- a/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. diff --git a/he-dns/README.md b/he-dns/README.md new file mode 100644 index 0000000..7598c3a --- /dev/null +++ b/he-dns/README.md @@ -0,0 +1,52 @@ +# 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. -- cgit v1.2.3