bind9/doc/arm
Michał Kępień 84b96df153
Remove "tkey-gssapi-credential" and related code
Since the "tkey-gssapi-credential" statement has been previously
deprecated, mark it as ancient and remove all code related to it:

  - The code processing the "tkey-gssapi-credential" statement in the
    configuration is the only user of the dst_gssapi_acquirecred() and
    dst_gssapi_releasecred() functions, so remove them along with their
    static helper functions and a backup definition of the
    GSS_KRB5_MECHANISM macro.

  - When calling gss_accept_sec_context(), pass GSS_C_NO_CREDENTIAL
    instead of the credential acquired by gss_acquire_cred().
    (Previously, NULL was passed when "tkey-gssapi-credential" was not
    specified.  Kerberos headers define GSS_C_NO_CREDENTIAL as
    (gss_cred_id_t) 0, so the logic was effectively the same, but using
    the GSS_C_NO_CREDENTIAL macro is more appropriate.)  This renders
    the 'cred' parameter for dst_gssapi_acceptctx() redundant, so remove
    it from the prototype of the latter.  (Contrary to what the
    documentation for dst_gssapi_acceptctx() claims,
    dst_gssapi_releasecred() does not need to subsequently be called to
    free the GSS-API context; a dst_gssapi_deletectx() call in
    gssapi_destroy() takes care of that when the dynamically generated
    TSIG key is destroyed.)

  - Remove the 'gsscred' member from struct dns_tkeyctx, along with its
    related dns_gss_cred_id_t typedef.

Update the relevant sections of the ARM and code comments accordingly.

This makes the "tkey-gssapi-keytab" statement the only way to set up
GSS-TSIG in named.

Remove redundant code from bin/named/tkeyconf.c while at it.
2025-10-06 13:19:50 +02:00
..
_ext Remove build requirements from building arm 2025-06-23 13:45:04 +03:00
_static ARM style change: render literals in black color 2022-06-02 17:13:19 +02:00
.gitignore Convert the documentation to Sphinx documentation format 2020-05-07 16:02:56 +02:00
advanced.inc.rst Deprecate the "tkey-gssapi-credential" statement 2025-09-01 21:23:30 +02:00
build.inc.rst Add named-lto option to meson build to named with LTO 2025-09-24 13:19:37 +02:00
catz.inc.rst Review and update ARM documentation 2024-09-11 16:23:30 +02:00
changelog.rst Generate changelog for BIND 9.21.12 2025-09-04 17:38:18 +02:00
chapter1.rst Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
chapter2.rst Remove build from chapter 2 and move it to the end of ARM 2022-05-11 10:51:26 +02:00
chapter3.rst Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
chapter4.rst Split Configuration chapter in the ARM into chapters 3 and 4 2022-05-11 10:51:26 +02:00
chapter5.rst Move "DNSSEC" chapter before "Advanced" and "Security" 2022-06-22 13:37:18 +02:00
chapter6.rst Move "DNSSEC" chapter before "Advanced" and "Security" 2022-06-22 13:37:18 +02:00
chapter7.rst further cleanup after removing diffie-hellman TKEY mode 2023-03-08 08:36:25 +01:00
chapter9.rst Restructure includes for chapter 9 Troubleshooting 2022-05-11 10:51:26 +02:00
chapter10.rst Remove build from chapter 2 and move it to the end of ARM 2022-05-11 10:51:26 +02:00
conf.py Prevent Sphinx from messing up syntax with "smartquotes" feature 2025-09-11 11:04:10 +00:00
config-auth.inc.rst Document the new unreachable cache behavior 2025-06-04 09:16:35 +00:00
config-intro.inc.rst Update example.com zone SOA expire value 2024-10-01 06:32:28 +00:00
config-resolve.inc.rst Remove manually defined anchors pointing to statement definitions 2022-10-05 11:36:22 +02:00
dlz.inc.rst Fix broken markup in doc/arm/dlz.inc.rst 2025-07-17 07:17:12 +02:00
dns-ops.inc.rst Document that SIGUSR1 closes log files 2024-07-31 17:36:39 +10:00
dns-security-overview.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-security-overview.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-servers.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-servers.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-tree.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dns-tree.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
dnssec-guide.rst Minor DNSSEC guide tweaks 2022-05-11 10:51:26 +02:00
dnssec.inc.rst Add a note about pregenarating keys for key rolls 2025-04-14 14:27:25 +00:00
dyndb.inc.rst Add tag and short description for dyndb statement 2022-07-29 18:56:04 +02:00
general.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
history.rst Update the copyright information in all files in the repository 2022-01-11 09:05:02 +01:00
index.rst Reorder appendices in ARM 2025-09-11 11:04:10 +00:00
intro-dns-bind.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
intro-security.inc.rst Review and update ARM documentation 2024-09-11 16:23:30 +02:00
introduction.inc.rst Remove trailing whitespace from all text files 2023-06-13 15:05:40 +02:00
isc-logo.pdf Update ISC logo 2020-07-08 02:00:11 +00:00
logging-categories.inc.rst Add option request-zoneversion 2025-03-24 22:16:09 +00:00
managed-keys.inc.rst Grammar fixes and assorted text edits in the ARM 2022-07-04 15:50:51 +02:00
manpages.rst add synthrecord plugin documentation 2025-10-01 12:16:05 +02:00
meson.build replace the build system with meson 2025-06-11 10:30:12 +03:00
name-resolution.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
name-resolution.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
notes.rst Prepare release notes for BIND 9.21.12 2025-09-04 17:38:18 +02:00
pkcs11.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
platforms.inc.rst Add Debian "trixie" 2025-09-01 16:28:33 +02:00
plugins.inc.rst add synthrecord plugin documentation 2025-10-01 12:16:05 +02:00
primary-secondary.dia Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
primary-secondary.png Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
recursive-query.dia Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
recursive-query.png Rewrite Introduction chapters of the ARM 2022-05-11 10:51:26 +02:00
reference.rst Remove "tkey-gssapi-credential" and related code 2025-10-06 13:19:50 +02:00
requirements.inc.rst Deduplicate link anchors in the ARM 2022-10-05 11:36:19 +02:00
requirements.txt Update Sphinx to 8.2.3 2025-06-19 15:22:02 +02:00
resolver-forward.dia Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
resolver-forward.png Rewrite Configurations and Zone Files section in the ARM 2022-05-11 10:51:26 +02:00
rpz.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
security.inc.rst Review and update ARM documentation 2024-10-21 12:55:14 +02:00
sig0.inc.rst Split chapter Advanced DNS Features in the ARM into chapters 5, 6, 7 2022-05-11 10:51:26 +02:00
troubleshooting.inc.rst Fix broken links in documentation 2025-01-24 12:07:36 +01:00
tsig.inc.rst further cleanup after removing diffie-hellman TKEY mode 2023-03-08 08:36:25 +01:00
zones.inc.rst remove "sortlist" 2024-12-11 15:09:24 -08:00