[git] GCRYPT - branch, master, updated. libgcrypt-1.6.0-366-ge2cbd22

by Werner Koch cvs at cvs.gnupg.org
Tue Mar 29 11:32:20 CEST 2016

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "The GNU crypto library".

The branch, master has been updated
       via  e2cbd22e03a68fbecc930052330df0c2096d2788 (commit)
      from  f2260e3a2e962ac80124ef938e54041bbea08561 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit e2cbd22e03a68fbecc930052330df0c2096d2788
Author: Werner Koch <wk at gnupg.org>
Date:   Tue Mar 29 11:31:55 2016 +0200

    doc: Update for gcry_cipher_gettag and gcry_cipher_checktag.
    Also re-indent one label.
    Signed-off-by: Werner Koch <wk at gnupg.org>

diff --git a/doc/gcrypt.texi b/doc/gcrypt.texi
index 8451627..5433ae8 100644
--- a/doc/gcrypt.texi
+++ b/doc/gcrypt.texi
@@ -1794,15 +1794,23 @@ authenticated data (AAD) for AEAD cipher modes.
 @end deftypefun
- at deftypefun gcry_error_t gcry_cipher_gettag (gcry_cipher_hd_t @var{h}, void *@var{tag}, size_t @var{taglen})
+ at deftypefun {gcry_error_t} gcry_cipher_gettag @
+            (@w{gcry_cipher_hd_t @var{h}}, @
+            @w{void *@var{tag}}, @w{size_t @var{taglen}})
 This function is used to read the authentication tag after encryption.
 The function finalizes and outputs the authentication tag to the buffer
 @var{tag} of length @var{taglen} bytes.
+Depending on the used mode certain restrictions for @var{taglen} are
+enforced:  For GCM @var{taglen} must be at least 16 or one of the
+allowed truncated lengths (4, 8, 12, 13, 14, or 15).
 @end deftypefun
- at deftypefun gcry_error_t gcry_cipher_checktag (gcry_cipher_hd_t @var{h}, const void *@var{tag}, size_t @var{taglen})
+ at deftypefun {gcry_error_t} gcry_cipher_checktag @
+            (@w{gcry_cipher_hd_t @var{h}}, @
+            @w{const void *@var{tag}}, @w{size_t @var{taglen}})
 Check the authentication tag after decryption. The authentication
 tag is passed as the buffer @var{tag} of length @var{taglen} bytes
@@ -1811,6 +1819,10 @@ decryption.  Error code @code{GPG_ERR_CHECKSUM} is returned if
 the authentication tag in the buffer @var{tag} does not match
 the authentication tag calculated during decryption.
+Depending on the used mode certain restrictions for @var{taglen} are
+enforced: For GCM @var{taglen} must either be 16 or one of the allowed
+truncated lengths (4, 8, 12, 13, 14, or 15).
 @end deftypefun
 The actual encryption and decryption is done by using one of the
diff --git a/tests/basic.c b/tests/basic.c
index 25d31ee..1a7d3cb 100644
--- a/tests/basic.c
+++ b/tests/basic.c
@@ -1812,7 +1812,7 @@ _check_gcm_cipher (unsigned int step)
+    next_tv:
       gcry_cipher_close (hde);
       gcry_cipher_close (hdd);


Summary of changes:
 doc/gcrypt.texi | 16 ++++++++++++++--
 tests/basic.c   |  2 +-
 2 files changed, 15 insertions(+), 3 deletions(-)

The GNU crypto library

Gnupg-commits mailing list
Gnupg-commits at gnupg.org

More information about the Gcrypt-devel mailing list