summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7d33170
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# go-nsupdate
+Update dynamic DNS records from netlink.
+
+`go-nsupdate` reads interface addresses from netlink, updating on `ip link up/down` and `ip addr add/del` events.
+
+The set of active interface IPv4/IPv6 addresses is used to send DNS `UPDATE` requests to the primary NS for a DNS zone.
+
+## Install
+
+ go get -v github.com/qmsk/go-nsupdate
+
+## Usage
+
+ TSIG_SECRET=... go-nsupdate --interface=vlan-wan --tsig-algorithm=hmac-sha256 yzzrt.dyn.qmsk.net --watch
+
+ # Using a generated TSIG key:
+ # TSIG_SECRET=$(python -c 'import os; print os.urandom(32).encode("base64")')
+
+