1gnutls_x509_crt_set_serial(3)       gnutls       gnutls_x509_crt_set_serial(3)
2
3
4

NAME

6       gnutls_x509_crt_set_serial - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int gnutls_x509_crt_set_serial(gnutls_x509_crt_t cert, const void * se‐
12       rial, size_t serial_size);
13

ARGUMENTS

15       gnutls_x509_crt_t cert
16                   a certificate of type gnutls_x509_crt_t
17
18       const void * serial
19                   The serial number
20
21       size_t serial_size
22                   Holds the size of the serial field.
23

DESCRIPTION

25       This function will set the X.509 certificate's  serial  number.   While
26       the serial number is an integer, it is often handled as an opaque field
27       by several CAs. For this reason this function accepts any kind of  data
28       as a serial number. To be consistent with the X.509/PKIX specifications
29       the provided  serial should be a big-endian positive number  (i.e.  its
30       leftmost bit should be zero).
31
32       The  size  of  the serial is restricted to 20 bytes maximum by RFC5280.
33       This function allows writing more than 20 bytes but the generated  cer‐
34       tificates in that case may be rejected by other implementations.
35

RETURNS

37       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
38       ror value.
39

REPORTING BUGS

41       Report bugs to <bugs@gnutls.org>.
42       Home page: https://www.gnutls.org
43
44

46       Copyright © 2001- Free Software Foundation, Inc., and others.
47       Copying and distribution of this file, with  or  without  modification,
48       are  permitted in any medium without royalty provided the copyright no‐
49       tice and this notice are preserved.
50

SEE ALSO

52       The full documentation for gnutls is maintained as  a  Texinfo  manual.
53       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
54       visit
55
56       https://www.gnutls.org/manual/
57
58gnutls                               3.7.2       gnutls_x509_crt_set_serial(3)
Impressum