b6b438
From 8391caf4f4aa8fed5167b5e5cf04197a29ba40e8 Mon Sep 17 00:00:00 2001
b6b438
From: Andreas Schneider <asn@samba.org>
b6b438
Date: Thu, 18 Jul 2019 13:27:57 +0200
b6b438
Subject: [PATCH 006/187] lib:crypto: Document gnutls_error_to_werror()
b6b438
b6b438
Signed-off-by: Andreas Schneider <asn@samba.org>
b6b438
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
b6b438
(cherry picked from commit e43678b84a3434b977f44b265599f1d9207d3b78)
b6b438
---
b6b438
 lib/crypto/gnutls_helpers.h | 16 ++++++++++++++++
b6b438
 1 file changed, 16 insertions(+)
b6b438
b6b438
diff --git a/lib/crypto/gnutls_helpers.h b/lib/crypto/gnutls_helpers.h
b6b438
index 8a2a49baf73..debaa701554 100644
b6b438
--- a/lib/crypto/gnutls_helpers.h
b6b438
+++ b/lib/crypto/gnutls_helpers.h
b6b438
@@ -40,6 +40,21 @@ NTSTATUS _gnutls_error_to_ntstatus(int gnutls_rc,
b6b438
 	_gnutls_error_to_ntstatus(gnutls_rc, blocked_status, \
b6b438
 				  __FUNCTION__, __location__)
b6b438
 
b6b438
+#ifdef DOXYGEN
b6b438
+/**
b6b438
+ * @brief Convert a gnutls error code to a corresponding WERROR.
b6b438
+ *
b6b438
+ * @param[in]  gnutls_rc      The GnuTLS return code.
b6b438
+ *
b6b438
+ * @param[in]  blocked_werr   The WERROR code which should be returned if e.g
b6b438
+ *                            the cipher we want to used it not allowed to be
b6b438
+ *                            used because of FIPS mode.
b6b438
+ *
b6b438
+ * @return A corresponding WERROR code.
b6b438
+ */
b6b438
+WERROR gnutls_error_to_werror(int gnutls_rc,
b6b438
+			       WERROR blocked_werr);
b6b438
+#else
b6b438
 WERROR _gnutls_error_to_werror(int gnutls_rc,
b6b438
 			       WERROR blocked_werr,
b6b438
 			       const char *function,
b6b438
@@ -47,6 +62,7 @@ WERROR _gnutls_error_to_werror(int gnutls_rc,
b6b438
 #define gnutls_error_to_werror(gnutls_rc, blocked_werr) \
b6b438
 	_gnutls_error_to_werror(gnutls_rc, blocked_werr, \
b6b438
 				__FUNCTION__, __location__)
b6b438
+#endif
b6b438
 
b6b438
 enum samba_gnutls_direction {
b6b438
 	SAMBA_GNUTLS_ENCRYPT,
b6b438
-- 
b6b438
2.23.0
b6b438