Update gnutls_{hash,hmac}_copy man-pages as well

Related: #1999639
Signed-off-by: Daiki Ueno <dueno@redhat.com>
This commit is contained in:
Daiki Ueno 2021-12-22 17:22:20 +01:00
parent 99deb50ba7
commit 7089af2e2d
2 changed files with 42 additions and 8 deletions

View File

@ -1,13 +1,14 @@
From 7b68571f43b68085ba9f36afb1e3e97b3ba8d2d5 Mon Sep 17 00:00:00 2001
From b64c8b2aa75e6668ee9115afda8e54d48b2143ac Mon Sep 17 00:00:00 2001
From: rpm-build <rpm-build>
Date: Wed, 22 Dec 2021 08:16:27 +0100
Subject: [PATCH 2/2] Update documentation of gnutls_{hash,hmac}_copy
Date: Wed, 22 Dec 2021 17:19:27 +0100
Subject: [PATCH 2/2] gnutls-3.7.2-doc-hash-copy.patch
Signed-off-by: rpm-build <rpm-build>
---
doc/functions/gnutls_hash_copy | 4 +++-
doc/functions/gnutls_hmac_copy | 4 +++-
2 files changed, 6 insertions(+), 2 deletions(-)
doc/functions/gnutls_hash_copy | 4 +++-
doc/functions/gnutls_hmac_copy | 4 +++-
doc/manpages/gnutls_hash_copy.3 | 4 +++-
doc/manpages/gnutls_hmac_copy.3 | 4 +++-
4 files changed, 12 insertions(+), 4 deletions(-)
diff --git a/doc/functions/gnutls_hash_copy b/doc/functions/gnutls_hash_copy
index 600c0e7..aac7d5d 100644
@ -39,6 +40,36 @@ index a219b21..93b20d5 100644
@strong{Returns:} new MAC context or NULL in case of an error.
diff --git a/doc/manpages/gnutls_hash_copy.3 b/doc/manpages/gnutls_hash_copy.3
index fcf0983..19bb8c4 100644
--- a/doc/manpages/gnutls_hash_copy.3
+++ b/doc/manpages/gnutls_hash_copy.3
@@ -13,7 +13,9 @@ is a \fBgnutls_hash_hd_t\fP type
This function will create a copy of Message Digest context, containing all
its current state. Copying contexts for Message Digests registered using
\fBgnutls_crypto_register_digest()\fP is not supported and will always result in
-an error.
+an error. In addition to that, some of the Message Digest implementations do
+not support this operation. Applications should check the return value and
+provide a proper fallback.
.SH "RETURNS"
new Message Digest context or NULL in case of an error.
.SH "SINCE"
diff --git a/doc/manpages/gnutls_hmac_copy.3 b/doc/manpages/gnutls_hmac_copy.3
index ba5a40d..32b0114 100644
--- a/doc/manpages/gnutls_hmac_copy.3
+++ b/doc/manpages/gnutls_hmac_copy.3
@@ -13,7 +13,9 @@ is a \fBgnutls_hmac_hd_t\fP type
This function will create a copy of MAC context, containing all its current
state. Copying contexts for MACs registered using
\fBgnutls_crypto_register_mac()\fP is not supported and will always result in an
-error.
+error. In addition to that, some of the MAC implementations do not support
+this operation. Applications should check the return value and provide a
+proper fallback.
.SH "RETURNS"
new MAC context or NULL in case of an error.
.SH "SINCE"
--
2.31.1

View File

@ -1,6 +1,6 @@
# This spec file has been automatically updated
Version: 3.7.2
Release: 9%{?dist}
Release: 10%{?dist}
Patch1: gnutls-3.6.7-no-now-guile.patch
Patch2: gnutls-3.2.7-rpath.patch
Patch3: gnutls-3.7.2-config-allowlisting.patch
@ -325,6 +325,9 @@ make check %{?_smp_mflags} GNUTLS_SYSTEM_PRIORITY_FILE=/dev/null
%endif
%changelog
* Wed Dec 22 2021 Daiki Ueno <dueno@redhat.com> - 3.7.2-10
- Update gnutls_{hash,hmac}_copy man-pages as well (#1999639)
* Wed Dec 22 2021 Daiki Ueno <dueno@redhat.com> - 3.7.2-9
- Drop support for GNUTLS_NO_EXPLICIT_INIT envvar in favor of
GNUTLS_NO_IMPLICIT_INIT (#1999639)