Commit cdb6555ccd for bind
commit cdb6555ccd19fb809003829f992c32514c0c7789
Author: OndÅ™ej Surý <ondrej@isc.org>
Date: Wed Nov 11 14:04:46 2026 +0100
Document that nsupdate does not support relative names
The zone command in nsupdate resembles $ORIGIN in a zone file, so it is
easy to assume that a name without a trailing dot gets the zone name
appended. It does not: nsupdate treats every name as absolute, and the
server then rejects the update with NOTZONE. Say so in the man page.
diff --git a/bin/nsupdate/nsupdate.rst b/bin/nsupdate/nsupdate.rst
index 1138942053..0de8941b87 100644
--- a/bin/nsupdate/nsupdate.rst
+++ b/bin/nsupdate/nsupdate.rst
@@ -282,6 +282,12 @@ The command formats and their meanings are as follows:
If no ``zone`` statement is provided, :program:`nsupdate` attempts to
determine the correct zone to update based on the rest of the input.
+ This command does not set an origin for names in update or prerequisite
+ commands. :program:`nsupdate` does not support zone-relative names: a name
+ without a trailing dot is interpreted relative to the DNS root. For example,
+ with ``zone example.com.``, ``host`` means ``host.``, not
+ ``host.example.com.``. Specify the full name to update a record in the zone.
+
``class classname``
This command specifies the default class. If no ``class`` is specified, the default
class is ``IN``.