summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNikos Mavrogiannopoulos <nmav@redhat.com>2016-12-01 16:41:55 +0100
committerNikos Mavrogiannopoulos <nmav@gnutls.org>2016-12-01 21:36:19 +0100
commit726ced923f54f0cd30b8f3303410e59ea7f1a1c3 (patch)
treee96b0127de872f56208d39a517a49795847c1b15
parent30cc17e13ea61f1866d76487057f380f14a23961 (diff)
downloadgnutls-726ced923f54f0cd30b8f3303410e59ea7f1a1c3.tar.gz
doc: document the fact that certificates and CRLs are unusable after generation
They must be exported and re-imported if intended to be used for signing or verification.
-rw-r--r--lib/x509/crl_write.c9
-rw-r--r--lib/x509/x509_write.c9
2 files changed, 18 insertions, 0 deletions
diff --git a/lib/x509/crl_write.c b/lib/x509/crl_write.c
index 2cc1a75694..0d46835ad6 100644
--- a/lib/x509/crl_write.c
+++ b/lib/x509/crl_write.c
@@ -1,5 +1,6 @@
/*
* Copyright (C) 2003-2012 Free Software Foundation, Inc.
+ * Copyright (C) 2016 Red Hat, Inc.
*
* Author: Nikos Mavrogiannopoulos
*
@@ -86,6 +87,10 @@ gnutls_x509_crl_set_version(gnutls_x509_crl_t crl, unsigned int version)
* This must be the last step in a certificate CRL since all
* the previously set parameters are now signed.
*
+ * A known limitation of this function is, that a newly-signed CRL will not
+ * be fully functional (e.g., for signature verification), until it
+ * is exported an re-imported.
+ *
* Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
* negative error value.
*
@@ -455,6 +460,10 @@ gnutls_x509_crl_set_number(gnutls_x509_crl_t crl,
* This must be the last step in a certificate CRL since all
* the previously set parameters are now signed.
*
+ * A known limitation of this function is, that a newly-signed CRL will not
+ * be fully functional (e.g., for signature verification), until it
+ * is exported an re-imported.
+ *
* Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
* negative error value.
*
diff --git a/lib/x509/x509_write.c b/lib/x509/x509_write.c
index c2293dac93..3e466bd102 100644
--- a/lib/x509/x509_write.c
+++ b/lib/x509/x509_write.c
@@ -1,5 +1,6 @@
/*
* Copyright (C) 2003-2016 Free Software Foundation, Inc.
+ * Copyright (C) 2016 Red Hat, Inc.
*
* Author: Nikos Mavrogiannopoulos
*
@@ -1066,6 +1067,10 @@ gnutls_x509_crt_set_private_key_usage_period(gnutls_x509_crt_t crt,
* This must be the last step in a certificate generation since all
* the previously set parameters are now signed.
*
+ * A known limitation of this function is, that a newly-signed certificate will not
+ * be fully functional (e.g., for signature verification), until it
+ * is exported an re-imported.
+ *
* Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
* negative error value.
**/
@@ -1714,6 +1719,10 @@ gnutls_x509_crt_set_key_purpose_oid(gnutls_x509_crt_t cert,
* This must be the last step in a certificate generation since all
* the previously set parameters are now signed.
*
+ * A known limitation of this function is, that a newly-signed certificate will not
+ * be fully functional (e.g., for signature verification), until it
+ * is exported an re-imported.
+ *
* Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
* negative error value.
**/