]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
use 'tsig-keygen' as the primary name for the tool
authorEvan Hunt <each@isc.org>
Thu, 2 Jul 2020 22:27:54 +0000 (15:27 -0700)
committerEvan Hunt <each@isc.org>
Mon, 6 Jul 2020 08:41:52 +0000 (01:41 -0700)
'ddns-confgen' is now an alias for 'tsig-keygen', rather than
the other way around.

28 files changed:
CHANGES
bin/confgen/Makefile.am
bin/confgen/tsig-keygen.c [moved from bin/confgen/ddns-confgen.c with 97% similarity]
bin/confgen/tsig-keygen.rst [moved from bin/confgen/ddns-confgen.rst with 71% similarity]
bin/confgen/win32/tsigkeygen.vcxproj.filters.in [moved from bin/confgen/win32/ddnsconfgen.vcxproj.filters.in with 92% similarity]
bin/confgen/win32/tsigkeygen.vcxproj.in [moved from bin/confgen/win32/ddnsconfgen.vcxproj.in with 96% similarity]
bin/confgen/win32/tsigkeygen.vcxproj.user [moved from bin/confgen/win32/ddnsconfgen.vcxproj.user with 92% similarity]
bin/named/named.conf.rst
bin/nsupdate/nsupdate.rst
bin/tests/system/conf.sh.in
bin/tests/system/conf.sh.win32
bin/tests/system/dlzexternal/setup.sh
bin/tests/system/nsupdate/setup.sh
bin/win32/BINDInstall/BINDInstall.vcxproj.in
doc/arm/advanced.rst
doc/arm/manpages.rst
doc/man/Makefile.am
doc/man/conf.py
doc/man/ddns-confgen.8in [deleted file]
doc/man/named.conf.5in
doc/man/nsupdate.1in
doc/man/tsig-keygen.8in [new file with mode: 0644]
doc/man/tsig-keygen.rst [moved from doc/man/ddns-confgen.rst with 100% similarity]
doc/misc/named.conf.rst
doc/misc/rst-options.pl
util/copyrights
win32utils/Configure
win32utils/bind9.sln.in

diff --git a/CHANGES b/CHANGES
index 226534ea38ce500c9275f9b5ce163ec5edb2e955..761f9a1161abaa022f76555298b0657da012201b 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,8 @@
+5460.  [cleanup]       tsig-keygen was previously an alias for
+                       ddns-confgen and was documented in the ddns-confgen
+                       man page. This has been reversed; tsig-keygen is
+                       now the primary name. [GL #1998]
+
 5459.  [bug]           Bad isc_mem_put() size when an invalid type was
                        specified in a update-policy rule. [GL #1990]
 
index 7d0f41dc376c55b8e4fba6c0e44e432acef48626..3101aba39ead1763fc4482ecbfc97be48244b8a3 100644 (file)
@@ -20,11 +20,11 @@ libconfgen_la_SOURCES =             \
        util.c                  \
        unix/os.c
 
-sbin_PROGRAMS = ddns-confgen rndc-confgen
+sbin_PROGRAMS = tsig-keygen rndc-confgen
 
 install-exec-hook:
-       ln -f $(DESTDIR)$(sbindir)/ddns-confgen \
-             $(DESTDIR)$(sbindir)/tsig-confgen
+       ln -f $(DESTDIR)$(sbindir)/tsig-keygen \
+             $(DESTDIR)$(sbindir)/ddns-confgen
 
 uninstall-hook:
-       -rm -f $(DESTDIR)$(sbindir)/tsig-confgen
+       -rm -f $(DESTDIR)$(sbindir)/ddns-confgen
similarity index 97%
rename from bin/confgen/ddns-confgen.c
rename to bin/confgen/tsig-keygen.c
index 02e3f72bc5bb8a64d6037e6a00a8055bf49dc637..5e7860faff92f698c36bdb4b19114be29ebf5104 100644 (file)
@@ -12,9 +12,8 @@
 /*! \file */
 
 /**
- * ddns-confgen generates configuration files for dynamic DNS. It can
- * be used as a convenient alternative to writing the ddns.key file
- * and the corresponding key and update-policy statements in named.conf.
+ * tsig-keygen generates TSIG keys that can be used in named configuration
+ * files for dynamic DNS.
  */
 
 #include <stdarg.h>
similarity index 71%
rename from bin/confgen/ddns-confgen.rst
rename to bin/confgen/tsig-keygen.rst
index 5380c8a714b3448d5b0430061c230630eba3bf71..d9a2756b71cff68a620dc925cdf6a0f65a786d8c 100644 (file)
 
 .. highlight: console
 
-.. _man_ddns-confgen:
+.. _man_tsig-keygen:
 
-ddns-confgen - ddns key generation tool
----------------------------------------
+tsig-keygen, ddns-confgen - TSIG key generation tool
+----------------------------------------------------
 
 Synopsis
 ~~~~~~~~
@@ -37,15 +37,16 @@ Description
 
 ``tsig-keygen`` and ``ddns-confgen`` are invocation methods for a
 utility that generates keys for use in TSIG signing. The resulting keys
-can be used, for example, to secure dynamic DNS updates to a zone or for
+can be used, for example, to secure dynamic DNS updates to a zone, or for
 the ``rndc`` command channel.
 
 When run as ``tsig-keygen``, a domain name can be specified on the
 command line to be used as the name of the generated key. If no
 name is specified, the default is ``tsig-key``.
 
-When run as ``ddns-confgen``, the generated key is accompanied by
-configuration text and instructions that can be used with ``nsupdate``
+When run as ``ddns-confgen``, the key name can specified using ``-k``
+parameter and defaults to ``ddns-key``. The generated key is accompanied
+by configuration text and instructions that can be used with ``nsupdate``
 and ``named`` when setting up dynamic DNS, including an example
 ``update-policy`` statement. (This usage is similar to the ``rndc-confgen``
 command for setting up command-channel security.)
@@ -60,20 +61,20 @@ Options
 ~~~~~~~
 
 ``-a algorithm``
-   This option specifies the algorithm to use for the TSIG key. Available choices
-   are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, and
-   hmac-sha512. The default is hmac-sha256. Options are
+   This option specifies the algorithm to use for the TSIG key. Available
+   choices are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384,
+   and hmac-sha512. The default is hmac-sha256. Options are
    case-insensitive, and the "hmac-" prefix may be omitted.
 
 ``-h``
    This option prints a short summary of options and arguments.
 
 ``-k keyname``
-   This option specifies the key name of the DDNS authentication key. The default is
-   ``ddns-key`` when neither the ``-s`` nor ``-z`` option is specified;
-   otherwise, the default is ``ddns-key`` as a separate label followed
-   by the argument of the option, e.g., ``ddns-key.example.com.`` The
-   key name must have the format of a valid domain name, consisting of
+   This option specifies the key name of the DDNS authentication key. The
+   default is ``ddns-key`` when neither the ``-s`` nor ``-z`` option is
+   specified; otherwise, the default is ``ddns-key`` as a separate label
+   followed by the argument of the option, e.g., ``ddns-key.example.com.``
+   The key name must have the format of a valid domain name, consisting of
    letters, digits, hyphens, and periods.
 
 ``-q`` (``ddns-confgen`` only)
@@ -82,13 +83,12 @@ Options
    ``tsig-keygen``.
 
 ``-s name`` (``ddns-confgen`` only)
-   This option generates a configuration example to allow
-   dynamic updates of a single hostname. The example ``named.conf`` text
-   shows how to set an update policy for the specified name using the
-   "name" nametype. The default key name is ``ddns-key.name``. Note that the
-   "self" nametype cannot be used, since the name to be updated may
-   differ from the key name. This option cannot be used with the ``-z``
-   option.
+   This option generates a configuration example to allow dynamic updates
+   of a single hostname. The example ``named.conf`` text shows how to set
+   an update policy for the specified name using the "name" nametype. The
+   default key name is ``ddns-key.name``. Note that the "self" nametype
+   cannot be used, since the name to be updated may differ from the key
+   name. This option cannot be used with the ``-z`` option.
 
 ``-z zone`` (``ddns-confgen`` only)
    This option generates a configuration example to allow
similarity index 92%
rename from bin/confgen/win32/ddnsconfgen.vcxproj.filters.in
rename to bin/confgen/win32/tsigkeygen.vcxproj.filters.in
index ccdaa818bb08a0bb5af351513617e83a0750b065..ef6527dccb74ed012622449b2efdb46753e323d9 100644 (file)
@@ -11,8 +11,8 @@
     </Filter>
   </ItemGroup>
   <ItemGroup>
-    <ClCompile Include="..\ddns-confgen.c">
+    <ClCompile Include="..\tsig-keygen.c">
       <Filter>Source Files</Filter>
     </ClCompile>
   </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
similarity index 96%
rename from bin/confgen/win32/ddnsconfgen.vcxproj.in
rename to bin/confgen/win32/tsigkeygen.vcxproj.in
index a49330cae7a4267c3b1655215422748590e1dfc0..c12dd1c0b0f8de606bea78ed6374a48e969fa051 100644 (file)
@@ -13,7 +13,7 @@
   <PropertyGroup Label="Globals">
     <ProjectGuid>{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}</ProjectGuid>
     <Keyword>Win32Proj</Keyword>
-    <RootNamespace>ddnsconfgen</RootNamespace>
+    <RootNamespace>tsigkeygen</RootNamespace>
     @WINDOWS_TARGET_PLATFORM_VERSION@
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
     <OutDir>..\..\..\Build\$(Configuration)\</OutDir>
     <IntDir>.\$(Configuration)\</IntDir>
     <IntDirSharingDetected>None</IntDirSharingDetected>
-    <TargetName>ddns-confgen</TargetName>
+    <TargetName>tsig-keygen</TargetName>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|@PLATFORM@'">
     <LinkIncremental>false</LinkIncremental>
     <OutDir>..\..\..\Build\$(Configuration)\</OutDir>
     <IntDir>.\$(Configuration)\</IntDir>
     <IntDirSharingDetected>None</IntDirSharingDetected>
-    <TargetName>ddns-confgen</TargetName>
+    <TargetName>tsig-keygen</TargetName>
   </PropertyGroup>
   <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|@PLATFORM@'">
     <ClCompile>
@@ -81,8 +81,8 @@
     </Link>
     <PostBuildEvent>
       <Command>cd ..\..\..\Build\$(Configuration)
-copy /Y ddns-confgen.exe tsig-keygen.exe
-copy /Y ddns-confgen.ilk tsig-keygen.ilk
+copy /Y tsig-keygen.exe ddns-confgen.exe
+copy /Y tsig-keygen.ilk ddns-confgen.ilk
 </Command>
     </PostBuildEvent>
   </ItemDefinitionGroup>
@@ -119,12 +119,12 @@ copy /Y ddns-confgen.ilk tsig-keygen.ilk
     </Link>
     <PostBuildEvent>
       <Command>cd ..\..\..\Build\$(Configuration)
-copy /Y ddns-confgen.exe tsig-keygen.exe
+copy /Y tsig-keygen.exe ddns-confgen.exe
 </Command>
     </PostBuildEvent>
   </ItemDefinitionGroup>
   <ItemGroup>
-    <ClCompile Include="..\ddns-confgen.c" />
+    <ClCompile Include="..\tsig-keygen.c" />
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\..\..\lib\isc\win32\libisc.vcxproj">
similarity index 92%
rename from bin/confgen/win32/ddnsconfgen.vcxproj.user
rename to bin/confgen/win32/tsigkeygen.vcxproj.user
index ace9a86acb77340247c6d79e985eca55840261de..7135522534c83c1897f2220267a0ffd9e6943e51 100644 (file)
@@ -1,3 +1,3 @@
 ï»¿<?xml version="1.0" encoding="utf-8"?>
 <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-</Project>
\ No newline at end of file
+</Project>
index 0716c1b748d92dcefa2be939cd5b657c56f91027..2b982d580afcbfe8f84143dea42bb16ae2c0bd8e 100644 (file)
@@ -1025,5 +1025,5 @@ Files
 See Also
 ~~~~~~~~
 
-:manpage:`ddns-confgen(8)`, :manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, BIND 9 Administrator Reference Manual.
+:manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, :manpage:`tsig-keygen(8)`, BIND 9 Administrator Reference Manual.
 
index 55d1b26a35e5b8572a8c194bfcd15f100ca20b81..ffb22bec280502e4dca9b573eab38ba6c62d23ec 100644 (file)
@@ -355,7 +355,7 @@ See Also
 ~~~~~~~~
 
 :rfc:`2136`, :rfc:`3007`, :rfc:`2104`, :rfc:`2845`, :rfc:`1034`, :rfc:`2535`, :rfc:`2931`,
-:manpage:`named(8)`, :manpage:`ddns-confgen(8)`, :manpage:`dnssec-keygen(8)`.
+:manpage:`named(8)`, :manpage:`dnssec-keygen(8)`, :manpage:`tsig-keygen(8)`.
 
 Bugs
 ~~~~
index 9e3ab3248c03f79f1bcba8be37d5e79f27dd0a65..8ff73f0ad0c7b3407e529d9b17cb92d045f5871b 100644 (file)
@@ -31,7 +31,6 @@ ARPANAME=$TOP_BUILDDIR/bin/tools/arpaname
 CDS=$TOP_BUILDDIR/bin/dnssec/dnssec-cds
 CHECKCONF=$TOP_BUILDDIR/bin/check/named-checkconf
 CHECKZONE=$TOP_BUILDDIR/bin/check/named-checkzone
-DDNSCONFGEN=$TOP_BUILDDIR/bin/confgen/ddns-confgen
 DELV=$TOP_BUILDDIR/bin/delv/delv
 DIG=$TOP_BUILDDIR/bin/dig/dig
 DNSTAPREAD=$TOP_BUILDDIR/bin/tools/dnstap-read
index 6565e1620b308f0bbaec22b9652b8dd34edd4ffc..c0600eee44b23cfacd1422ed8534479255950ca9 100644 (file)
@@ -32,7 +32,6 @@ ARPANAME=$TOP_BUILDDIR/Build/$VSCONF/arpaname@EXEEXT@
 CDS=$TOP_BUILDDIR/Build/$VSCONF/dnssec-cds@EXEEXT@
 CHECKCONF=$TOP_BUILDDIR/Build/$VSCONF/named-checkconf@EXEEXT@
 CHECKZONE=$TOP_BUILDDIR/Build/$VSCONF/named-checkzone@EXEEXT@
-DDNSCONFGEN=$TOP_BUILDDIR/Build/$VSCONF/ddns-confgen@EXEEXT@
 DELV=$TOP_BUILDDIR/Build/$VSCONF/delv@EXEEXT@
 DIG=$TOP_BUILDDIR/Build/$VSCONF/dig@EXEEXT@
 DNSTAPREAD=$TOP_BUILDDIR/Build/$VSCONF/dnstap-read@EXEEXT@
index 063cdba5ab0a75d0266de1f2f4f35016908038cd..d7551eade99f176d4fbefaf6dd8af2c55d629c7f 100644 (file)
@@ -11,6 +11,6 @@
 
 . $SYSTEMTESTTOP/conf.sh
 
-$DDNSCONFGEN -q -z example.nil > ns1/ddns.key
+$TSIGKEYGEN ddns-key.example.nil > ns1/ddns.key
 
 copy_setports ns1/named.conf.in ns1/named.conf
index f0ccd9ef3e3f464d721f702bb1dfba9d9860bd54..2c73a45a9b4708e174d360c61ddee6639f5027bb 100644 (file)
@@ -53,14 +53,14 @@ ns1.update.nil.         A       10.53.0.2
 ns2.update.nil.                AAAA    ::1
 EOF
 
-$DDNSCONFGEN -q -z example.nil > ns1/ddns.key
+$TSIGKEYGEN ddns-key.example.nil > ns1/ddns.key
 
-$DDNSCONFGEN -q -a hmac-md5 -k md5-key -z keytests.nil > ns1/md5.key
-$DDNSCONFGEN -q -a hmac-sha1 -k sha1-key -z keytests.nil > ns1/sha1.key
-$DDNSCONFGEN -q -a hmac-sha224 -k sha224-key -z keytests.nil > ns1/sha224.key
-$DDNSCONFGEN -q -a hmac-sha256 -k sha256-key -z keytests.nil > ns1/sha256.key
-$DDNSCONFGEN -q -a hmac-sha384 -k sha384-key -z keytests.nil > ns1/sha384.key
-$DDNSCONFGEN -q -a hmac-sha512 -k sha512-key -z keytests.nil > ns1/sha512.key
+$TSIGKEYGEN -a hmac-md5 md5-key > ns1/md5.key
+$TSIGKEYGEN -a hmac-sha1 sha1-key > ns1/sha1.key
+$TSIGKEYGEN -a hmac-sha224 sha224-key > ns1/sha224.key
+$TSIGKEYGEN -a hmac-sha256 sha256-key > ns1/sha256.key
+$TSIGKEYGEN -a hmac-sha384 sha384-key > ns1/sha384.key
+$TSIGKEYGEN -a hmac-sha512 sha512-key > ns1/sha512.key
 
 (cd ns3; $SHELL -e sign.sh)
 
index e54a8f5ba6c544fa8ebd98d38a27d89fefd982a0..7e01a4b9f6344ebc69443b5580f594bad407dd46 100644 (file)
     <ProjectReference Include="..\..\..\bin\confgen\win32\confgentool.vcxproj">
       <Project>{64964B03-4815-41F0-9057-E766A94AF197}</Project>
     </ProjectReference>
-    <ProjectReference Include="..\..\..\bin\confgen\win32\ddnsconfgen.vcxproj">
+    <ProjectReference Include="..\..\..\bin\confgen\win32\tsigkeygen.vcxproj">
       <Project>{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}</Project>
     </ProjectReference>
     <ProjectReference Include="..\..\..\bin\confgen\win32\rndcconfgen.vcxproj">
index 921039a1360503cba85c5fefcde00cb34fd34cd4..d7c2edd8536389ea30d24c3238646538ae0a735e 100644 (file)
@@ -416,7 +416,7 @@ email, etc.)
 
 ``tsig-keygen`` can also be run as ``ddns-confgen``, in which case its
 output includes additional configuration text for setting up dynamic DNS
-in ``named``. See :ref:`man_ddns-confgen` for details.
+in ``named``. See :ref:`man_tsig-keygen` for details.
 
 Loading a New Key
 ~~~~~~~~~~~~~~~~~
index 1579ff2a08e966a023cefaeb051e20a59dedc2a0..0ca442053a0051d7d8c1565bfdcb210da084c33e 100644 (file)
@@ -14,7 +14,7 @@ Manual Pages
 ============
 
 .. include:: ../../bin/tools/arpaname.rst
-.. include:: ../../bin/confgen/ddns-confgen.rst
+.. include:: ../../bin/confgen/tsig-keygen.rst
 .. include:: ../../bin/delv/delv.rst
 .. include:: ../../bin/dig/dig.rst
 .. include:: ../../bin/dnssec/dnssec-cds.rst
index 625d0da0e07549a6c2c782fa919826f8511790b7..d038d01e6e1a1fd71b5078e29cedb1dbd27b9e9e 100644 (file)
@@ -3,7 +3,6 @@ include $(top_srcdir)/Makefile.docs
 
 MANPAGES_RST =                         \
        arpaname.rst                    \
-       ddns-confgen.rst                \
        delv.rst                        \
        dig.rst                         \
        dnssec-cds.rst                  \
@@ -37,10 +36,11 @@ MANPAGES_RST =                              \
        rndc-confgen.rst                \
        rndc.conf.rst                   \
        rndc.rst                        \
+       tsig-keygen.rst                 \
        ../../bin/check/named-checkconf.rst \
        ../../bin/check/named-checkzone.rst \
-       ../../bin/confgen/ddns-confgen.rst \
        ../../bin/confgen/rndc-confgen.rst \
+       ../../bin/confgen/tsig-keygen.rst \
        ../../bin/delv/delv.rst \
        ../../bin/dig/dig.rst \
        ../../bin/dig/host.rst \
@@ -84,7 +84,6 @@ man_MANS =                            \
        nsupdate.1                      \
        named.conf.5                    \
        rndc.conf.5                     \
-       ddns-confgen.8                  \
        dnssec-cds.1                    \
        dnssec-dsfromkey.1              \
        dnssec-importkey.1              \
@@ -102,7 +101,8 @@ man_MANS =                          \
        named.8                         \
        nsec3hash.1                     \
        rndc-confgen.8                  \
-       rndc.8
+       rndc.8                          \
+       tsig-keygen.8
 
 if HAVE_PKCS11
 man_MANS +=                            \
index 03d70dd7e003af4f1dda32085e9ac0c7c18b60d9..8e1706f169f534c645f73fd6218d90c91bd83345 100644 (file)
@@ -60,7 +60,6 @@ master_doc = 'index'
 # pylint: disable=line-too-long
 man_pages = [
     ('arpaname', 'arpaname', 'translate IP addresses to the corresponding ARPA names', author, 1),
-    ('ddns-confgen', 'ddns-confgen', 'ddns key generation tool', author, 8),
     ('delv', 'delv', 'DNS lookup and validation utility', author, 1),
     ('dig', 'dig', 'DNS lookup utility', author, 1),
     ('dnssec-cds', 'dnssec-cds', 'change DS records for a child zone based on CDS/CDNSKEY', author, 1),
@@ -93,4 +92,5 @@ man_pages = [
     ('rndc-confgen', 'rndc-confgen', 'rndc key generation tool', author, 8),
     ('rndc.conf', 'rndc.conf', 'rndc configuration file', author, 5),
     ('rndc', 'rndc', 'name server control utility', author, 8),
+    ('tsig-keygen', 'tsig-keygen', 'TSIG key generation tool', author, 8),
     ]
diff --git a/doc/man/ddns-confgen.8in b/doc/man/ddns-confgen.8in
deleted file mode 100644 (file)
index fe0d843..0000000
+++ /dev/null
@@ -1,109 +0,0 @@
-.\" Man page generated from reStructuredText.
-.
-.TH "DDNS-CONFGEN" "8" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
-.SH NAME
-ddns-confgen \- ddns key generation tool
-.
-.nr rst2man-indent-level 0
-.
-.de1 rstReportMargin
-\\$1 \\n[an-margin]
-level \\n[rst2man-indent-level]
-level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
--
-\\n[rst2man-indent0]
-\\n[rst2man-indent1]
-\\n[rst2man-indent2]
-..
-.de1 INDENT
-.\" .rstReportMargin pre:
-. RS \\$1
-. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
-. nr rst2man-indent-level +1
-.\" .rstReportMargin post:
-..
-.de UNINDENT
-. RE
-.\" indent \\n[an-margin]
-.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.nr rst2man-indent-level -1
-.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
-.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
-..
-.SH SYNOPSIS
-.sp
-\fBtsig\-keygen\fP [\fB\-a\fP algorithm] [\fB\-h\fP] [\fB\-r\fP randomfile] [\fB\-s\fP name]
-.sp
-\fBddns\-confgen\fP [\fB\-a\fP algorithm] [\fB\-h\fP] [\fB\-k\fP keyname] [\fB\-q\fP] [\fB\-r\fP randomfile] [\fB\-s\fP name] [\fB\-z\fP zone]
-.SH DESCRIPTION
-.sp
-\fBtsig\-keygen\fP and \fBddns\-confgen\fP are invocation methods for a
-utility that generates keys for use in TSIG signing. The resulting keys
-can be used, for example, to secure dynamic DNS updates to a zone or for
-the \fBrndc\fP command channel.
-.sp
-When run as \fBtsig\-keygen\fP, a domain name can be specified on the
-command line to be used as the name of the generated key. If no
-name is specified, the default is \fBtsig\-key\fP\&.
-.sp
-When run as \fBddns\-confgen\fP, the generated key is accompanied by
-configuration text and instructions that can be used with \fBnsupdate\fP
-and \fBnamed\fP when setting up dynamic DNS, including an example
-\fBupdate\-policy\fP statement. (This usage is similar to the \fBrndc\-confgen\fP
-command for setting up command\-channel security.)
-.sp
-Note that \fBnamed\fP itself can configure a local DDNS key for use with
-\fBnsupdate \-l\fP; it does this when a zone is configured with
-\fBupdate\-policy local;\fP\&. \fBddns\-confgen\fP is only needed when a more
-elaborate configuration is required: for instance, if \fBnsupdate\fP is to
-be used from a remote system.
-.SH OPTIONS
-.INDENT 0.0
-.TP
-.B \fB\-a algorithm\fP
-This option specifies the algorithm to use for the TSIG key. Available choices
-are: hmac\-md5, hmac\-sha1, hmac\-sha224, hmac\-sha256, hmac\-sha384, and
-hmac\-sha512. The default is hmac\-sha256. Options are
-case\-insensitive, and the "hmac\-" prefix may be omitted.
-.TP
-.B \fB\-h\fP
-This option prints a short summary of options and arguments.
-.TP
-.B \fB\-k keyname\fP
-This option specifies the key name of the DDNS authentication key. The default is
-\fBddns\-key\fP when neither the \fB\-s\fP nor \fB\-z\fP option is specified;
-otherwise, the default is \fBddns\-key\fP as a separate label followed
-by the argument of the option, e.g., \fBddns\-key.example.com.\fP The
-key name must have the format of a valid domain name, consisting of
-letters, digits, hyphens, and periods.
-.TP
-.B \fB\-q\fP (\fBddns\-confgen\fP only)
-This option enables quiet mode, which prints only the key, with no
-explanatory text or usage examples. This is essentially identical to
-\fBtsig\-keygen\fP\&.
-.TP
-.B \fB\-s name\fP (\fBddns\-confgen\fP only)
-This option generates a configuration example to allow
-dynamic updates of a single hostname. The example \fBnamed.conf\fP text
-shows how to set an update policy for the specified name using the
-"name" nametype. The default key name is \fBddns\-key.name\fP\&. Note that the
-"self" nametype cannot be used, since the name to be updated may
-differ from the key name. This option cannot be used with the \fB\-z\fP
-option.
-.TP
-.B \fB\-z zone\fP (\fBddns\-confgen\fP only)
-This option generates a configuration example to allow
-dynamic updates of a zone. The example \fBnamed.conf\fP text shows how
-to set an update policy for the specified zone using the "zonesub"
-nametype, allowing updates to all subdomain names within that zone.
-This option cannot be used with the \fB\-s\fP option.
-.UNINDENT
-.SH SEE ALSO
-.sp
-\fBnsupdate(1)\fP, \fBnamed.conf(5)\fP, \fBnamed(8)\fP, BIND 9 Administrator Reference Manual.
-.SH AUTHOR
-Internet Systems Consortium
-.SH COPYRIGHT
-2020, Internet Systems Consortium
-.\" Generated by docutils manpage writer.
-.
index bc3319edd5094450aac2e4c15fde6c6d0360af3f..f8feea55aa1407fd593bde6e7a538dd90c4d9880 100644 (file)
@@ -1120,7 +1120,7 @@ zone string [ class ] {
 \fB/etc/named.conf\fP
 .SH SEE ALSO
 .sp
-\fBddns\-confgen(8)\fP, \fBnamed(8)\fP, \fBnamed\-checkconf(8)\fP, \fBrndc(8)\fP, \fBrndc\-confgen(8)\fP, BIND 9 Administrator Reference Manual.
+\fBtsig\-keygen(8)\fP, \fBnamed(8)\fP, \fBnamed\-checkconf(8)\fP, \fBrndc(8)\fP, \fBrndc\-confgen(8)\fP, BIND 9 Administrator Reference Manual.
 .SH AUTHOR
 Internet Systems Consortium
 .SH COPYRIGHT
index a52c03d6d15d3731a6be82e7afc292d8499a132e..3e53a1b351e79de5d2b8d9f01d996a5e16b72f2e 100644 (file)
@@ -364,7 +364,7 @@ Base\-64 encoding of the HMAC\-MD5 key created by \fBdnssec\-keygen\fP\&.
 .SH SEE ALSO
 .sp
 \fI\%RFC 2136\fP, \fI\%RFC 3007\fP, \fI\%RFC 2104\fP, \fI\%RFC 2845\fP, \fI\%RFC 1034\fP, \fI\%RFC 2535\fP, \fI\%RFC 2931\fP,
-\fBnamed(8)\fP, \fBddns\-confgen(8)\fP, \fBdnssec\-keygen(8)\fP\&.
+\fBnamed(8)\fP, \fBtsig\-keygen(8)\fP, \fBdnssec\-keygen(8)\fP\&.
 .SH BUGS
 .sp
 The TSIG key is redundantly stored in two separate files. This is a
diff --git a/doc/man/tsig-keygen.8in b/doc/man/tsig-keygen.8in
new file mode 100644 (file)
index 0000000..cd19148
--- /dev/null
@@ -0,0 +1,38 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "TSIG-KEYGEN" "8" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
+.SH NAME
+tsig-keygen \- TSIG key generation tool
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH AUTHOR
+Internet Systems Consortium
+.SH COPYRIGHT
+2020, Internet Systems Consortium
+.\" Generated by docutils manpage writer.
+.
index 24ff5aa1b8eda26a22ada6355b11a9e243accbcd..1de1a2a2c10bd09cdab4393a54c6769fb0c94d89 100644 (file)
@@ -1021,5 +1021,5 @@ Files
 See Also
 ~~~~~~~~
 
-:manpage:`ddns-confgen(8)`, :manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, BIND 9 Administrator Reference Manual.
+:manpage:`tsig-keygen(8)`, :manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, BIND 9 Administrator Reference Manual.
 
index c82dd0bab3220e54e307a3139719b9a9eb98ac7c..d65e62033006ddf2cf80e18f9f941a10152f60e7 100644 (file)
@@ -114,6 +114,6 @@ Files
 See Also
 ~~~~~~~~
 
-:manpage:`ddns-confgen(8)`, :manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, BIND 9 Administrator Reference Manual.
+:manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, :manpage:`tsig-keygen(8)`, BIND 9 Administrator Reference Manual.
 
 END
index e049c42f45ad29269fc3dcff1a02e94da65bca03..135b8f835a6fdcb0a0c386f73fe88fb5dab96b3d 100644 (file)
 ./bin/check/win32/checkzone.vcxproj.filters.in X       2013,2015,2018,2019,2020
 ./bin/check/win32/checkzone.vcxproj.in         X       2013,2014,2015,2016,2017,2018,2019,2020
 ./bin/check/win32/checkzone.vcxproj.user       X       2013,2018,2019,2020
-./bin/confgen/ddns-confgen.c                   C       2009,2011,2014,2016,2018,2019,2020
-./bin/confgen/ddns-confgen.rst                 RST     2020
 ./bin/confgen/include/confgen/os.h             C       2009,2016,2018,2019,2020
 ./bin/confgen/keygen.c                         C       2009,2012,2013,2014,2015,2016,2017,2018,2019,2020
 ./bin/confgen/keygen.h                         C       2009,2016,2018,2019,2020
 ./bin/confgen/rndc-confgen.c                   C       2001,2003,2004,2005,2007,2008,2009,2011,2013,2014,2016,2017,2018,2019,2020
 ./bin/confgen/rndc-confgen.rst                 RST     2020
+./bin/confgen/tsig-keygen.c                    C       2009,2011,2014,2016,2018,2019,2020
+./bin/confgen/tsig-keygen.rst                  RST     2020
 ./bin/confgen/unix/os.c                                C       2009,2016,2018,2019,2020
 ./bin/confgen/util.c                           C       2009,2015,2016,2018,2019,2020
 ./bin/confgen/util.h                           C       2009,2016,2018,2019,2020
 ./bin/confgen/win32/confgentool.vcxproj.filters.in     X       2013,2015,2018,2019,2020
 ./bin/confgen/win32/confgentool.vcxproj.in     X       2013,2015,2016,2017,2018,2019,2020
 ./bin/confgen/win32/confgentool.vcxproj.user   X       2013,2018,2019,2020
-./bin/confgen/win32/ddnsconfgen.vcxproj.filters.in     X       2013,2015,2018,2019,2020
-./bin/confgen/win32/ddnsconfgen.vcxproj.in     X       2013,2014,2015,2016,2017,2018,2019,2020
-./bin/confgen/win32/ddnsconfgen.vcxproj.user   X       2013,2018,2019,2020
 ./bin/confgen/win32/os.c                       C       2009,2016,2018,2019,2020
 ./bin/confgen/win32/rndcconfgen.vcxproj.filters.in     X       2013,2015,2018,2019,2020
 ./bin/confgen/win32/rndcconfgen.vcxproj.in     X       2013,2015,2016,2017,2018,2019,2020
 ./bin/confgen/win32/rndcconfgen.vcxproj.user   X       2013,2018,2019,2020
+./bin/confgen/win32/tsigkeygen.vcxproj.filters.in      X       2013,2015,2018,2019,2020
+./bin/confgen/win32/tsigkeygen.vcxproj.in      X       2013,2014,2015,2016,2017,2018,2019,2020
+./bin/confgen/win32/tsigkeygen.vcxproj.user    X       2013,2018,2019,2020
 ./bin/delv/delv.c                              C       2014,2015,2016,2017,2018,2019,2020
 ./bin/delv/delv.rst                            RST     2020
 ./bin/delv/win32/delv.vcxproj.filters.in       X       2014,2015,2018,2019,2020
 ./doc/doxygen/mainpage                         X       2006,2018,2019,2020
 ./doc/man/arpaname.rst                         RST     2020
 ./doc/man/conf.py                              PYTHON  2020
-./doc/man/ddns-confgen.rst                     RST     2020
 ./doc/man/delv.rst                             RST     2020
 ./doc/man/dig.rst                              RST     2020
 ./doc/man/dnssec-cds.rst                       RST     2020
 ./doc/man/rndc-confgen.rst                     RST     2020
 ./doc/man/rndc.conf.rst                                RST     2020
 ./doc/man/rndc.rst                             RST     2020
+./doc/man/tsig-keygen.rst                      RST     2020
 ./doc/misc/cfg_test.c                          C       2020
 ./doc/misc/delegation-only.zoneopt             X       2018,2019,2020
 ./doc/misc/format-options.pl                   PERL    2001,2004,2007,2012,2016,2018,2019,2020
index e33ed59215f4e5cbb51e3b1627db21e88baf1665..4567fb39b7a329b8b4de7e6ba8252fc659361c18 100644 (file)
@@ -40,8 +40,8 @@ my @projectlist = ("../bin/check/win32/checkconf.vcxproj",
                    "../bin/check/win32/checkzone.vcxproj.filters",
                    "../bin/confgen/win32/confgentool.vcxproj",
                    "../bin/confgen/win32/confgentool.vcxproj.filters",
-                   "../bin/confgen/win32/ddnsconfgen.vcxproj",
-                   "../bin/confgen/win32/ddnsconfgen.vcxproj.filters",
+                   "../bin/confgen/win32/tsigkeygen.vcxproj",
+                   "../bin/confgen/win32/tsigkeygen.vcxproj.filters",
                    "../bin/confgen/win32/rndcconfgen.vcxproj",
                    "../bin/confgen/win32/rndcconfgen.vcxproj.filters",
                    "../bin/delv/win32/delv.vcxproj",
index 1cd3ca3283af8d11654d7ca383996c2799f38f24..fe004aece39ec4519b515f04bddc837338939b16 100644 (file)
@@ -92,7 +92,7 @@ Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "confgentool", "..\bin\confg
 EndProject
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "rndcconfgen", "..\bin\confgen\win32\rndcconfgen.vcxproj", "{1E2C1635-3093-4D59-80E7-4743AC10F22F}"
 EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "ddnsconfgen", "..\bin\confgen\win32\ddnsconfgen.vcxproj", "{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}"
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "tsigkeygen", "..\bin\confgen\win32\tsigkeygen.vcxproj", "{1EA4FC64-F33B-4A50-970A-EA052BBE9CF1}"
 EndProject
 @IF PKCS11
 Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "pk11keygen", "..\bin\pkcs11\win32\pk11keygen.vcxproj", "{5042D371-0402-4FA3-A52A-769708694422}"