From 8be8e1470f11914bf2e455905746170a9eb9a8b1 Mon Sep 17 00:00:00 2001 From: "Jason D. McCormick" Date: Fri, 15 Mar 2019 18:56:11 -0400 Subject: first pass of readme --- README.md | 44 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 86b1cb5..90db6b5 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,44 @@ # he-dyndns -Shell-based dynamic DNS client for Hurricane Electric's dns.he.net service +This code is a shell-based dynamic DNS client for Hurricane Electric's +dns.he.net service. This code is designed to be maximally portable +using common Linux/BSD commands and avoid Perl, Python, etc. In its +default mode, it updates one or more FQDNs with the IP address that +dns.he.net detects as the source request. + +# Installation +There is really nothing to install. Copy he-dyndns somewhere useful +such as /usr/local/bin. + +# Configuration +The only configuration file/item is if you want to use the file +/etc/he-dns-secret to contain the key for authenticating to +dns.he.net. Otherwise, you can provide it on the command line with the +**-s** option. + +# Runtime Options +**he-dyndns** takes the following options: + +## Requied Options +- **-4**: Update the IPv4 "A" record for the FQDN(s) +- **-6**: Update the IPv6 "AAAA" record for the FQDN(s). +- **-d**: One or more fully-qualified host entries for the domain separated by commas + +Note that one or both of -4 and -6 must be specified for the script to +actually do anything. + +## Optional Options +- **-s**: The secret key for updating the entries + +Any other unsupported option or no options will print a usage message + +# Return Values +Returns 0 on success or 1 on failure. Failure message returns the exact error +from dyn.dns.he.net, no more and no less. + +# Usage +This script is designed to be called from a Cron entry or another script. An +example usage: + +``` +# /usr/local/bin/he-dyndns -46 -s SECRETKEY -d foo.example.com,bar.example.com +``` -- cgit v1.2.3