summaryrefslogtreecommitdiffstats
path: root/doc/functions/gnutls_x509_crt_get_serial
diff options
context:
space:
mode:
Diffstat (limited to 'doc/functions/gnutls_x509_crt_get_serial')
-rw-r--r--doc/functions/gnutls_x509_crt_get_serial19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/functions/gnutls_x509_crt_get_serial b/doc/functions/gnutls_x509_crt_get_serial
new file mode 100644
index 0000000..990bd12
--- /dev/null
+++ b/doc/functions/gnutls_x509_crt_get_serial
@@ -0,0 +1,19 @@
+
+
+
+
+@deftypefun {int} {gnutls_x509_crt_get_serial} (gnutls_x509_crt_t @var{cert}, void * @var{result}, size_t * @var{result_size})
+@var{cert}: should contain a @code{gnutls_x509_crt_t} type
+
+@var{result}: The place where the serial number will be copied
+
+@var{result_size}: Holds the size of the result field.
+
+This function will return the X.509 certificate's serial number.
+This is obtained by the X509 Certificate serialNumber field. Serial
+is not always a 32 or 64bit number. Some CAs use large serial
+numbers, thus it may be wise to handle it as something uint8_t.
+
+@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
+negative error value.
+@end deftypefun