Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_crt_set_serial(3)	    gnutls	 gnutls_x509_crt_set_serial(3)

NAME
       gnutls_x509_crt_set_serial - API	function

SYNOPSIS
       #include	<gnutls/x509.h>

       int gnutls_x509_crt_set_serial(gnutls_x509_crt_t	cert, const void * se-
       rial, size_t serial_size);

ARGUMENTS
       gnutls_x509_crt_t cert
		   a certificate of type gnutls_x509_crt_t

       const void * serial
		   The serial number

       size_t serial_size
		   Holds the size of the serial	field.

DESCRIPTION
       This  function  will  set the X.509 certificate's serial	number.	 While
       the serial number is an integer,	it is often handled as an opaque field
       by several CAs. For this	reason this function accepts any kind of  data
       as a serial number. To be consistent with the X.509/PKIX	specifications
       the  provided   serial should be	a big-endian positive number (i.e. its
       leftmost	bit should be zero).

       The size	of the serial is restricted to 20 bytes	 maximum  by  RFC5280.
       This  function allows writing more than 20 bytes	but the	generated cer-
       tificates in that case may be rejected by other implementations.

RETURNS
       On success, GNUTLS_E_SUCCESS (0)	is returned, otherwise a negative  er-
       ror value.

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
       Copying	and  distribution  of this file, with or without modification,
       are permitted in	any medium without royalty provided the	copyright  no-
       tice and	this notice are	preserved.

SEE ALSO
       The  full  documentation	 for gnutls is maintained as a Texinfo manual.
       If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9	 gnutls_x509_crt_set_serial(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_x509_crt_set_serial&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help