|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_x509_crt_set_serial" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_x509_crt_set_serial \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/x509.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_x509_crt_set_serial(gnutls_x509_crt_t " cert ", const void * " serial ", size_t " serial_size ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_x509_crt_t cert" 12
|
|
Packit Service |
4684c1 |
a certificate of type \fBgnutls_x509_crt_t\fP
|
|
Packit Service |
4684c1 |
.IP "const void * serial" 12
|
|
Packit Service |
4684c1 |
The serial number
|
|
Packit Service |
4684c1 |
.IP "size_t serial_size" 12
|
|
Packit Service |
4684c1 |
Holds the size of the serial field.
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
This function will set the X.509 certificate's serial number.
|
|
Packit Service |
4684c1 |
While the serial number is an integer, it is often handled
|
|
Packit Service |
4684c1 |
as an opaque field by several CAs. For this reason this function
|
|
Packit Service |
4684c1 |
accepts any kind of data as a serial number. To be consistent
|
|
Packit Service |
4684c1 |
with the X.509/PKIX specifications the provided \fIserial\fP should be
|
|
Packit Service |
4684c1 |
a big\-endian positive number (i.e. it's leftmost bit should be zero).
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The size of the serial is restricted to 20 bytes maximum by RFC5280.
|
|
Packit Service |
4684c1 |
This function allows writing more than 20 bytes but the generated
|
|
Packit Service |
4684c1 |
certificates in that case may be rejected by other implementations.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit Service |
4684c1 |
negative error value.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|