Blame doc/manpages/gnutls_x509_crt_list_import.3

Packit Service 4684c1
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 4684c1
.TH "gnutls_x509_crt_list_import" 3 "3.6.14" "gnutls" "gnutls"
Packit Service 4684c1
.SH NAME
Packit Service 4684c1
gnutls_x509_crt_list_import \- 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_list_import(gnutls_x509_crt_t * " certs ", unsigned int * " cert_max ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", unsigned int " flags ");"
Packit Service 4684c1
.SH ARGUMENTS
Packit Service 4684c1
.IP "gnutls_x509_crt_t * certs" 12
Packit Service 4684c1
Indicates where the parsed list will be copied to. Must not be initialized.
Packit Service 4684c1
.IP "unsigned int * cert_max" 12
Packit Service 4684c1
Initially must hold the maximum number of certs. It will be updated with the number of certs available.
Packit Service 4684c1
.IP "const gnutls_datum_t * data" 12
Packit Service 4684c1
The PEM encoded certificate.
Packit Service 4684c1
.IP "gnutls_x509_crt_fmt_t format" 12
Packit Service 4684c1
One of DER or PEM.
Packit Service 4684c1
.IP "unsigned int flags" 12
Packit Service 4684c1
must be (0) or an OR'd sequence of gnutls_certificate_import_flags.
Packit Service 4684c1
.SH "DESCRIPTION"
Packit Service 4684c1
This function will convert the given PEM encoded certificate list
Packit Service 4684c1
to the native gnutls_x509_crt_t format. The output will be stored
Packit Service 4684c1
in  \fIcerts\fP .  They will be automatically initialized.
Packit Service 4684c1
Packit Service 4684c1
The flag \fBGNUTLS_X509_CRT_LIST_IMPORT_FAIL_IF_EXCEED\fP will cause
Packit Service 4684c1
import to fail if the certificates in the provided buffer are more
Packit Service 4684c1
than the available structures. The \fBGNUTLS_X509_CRT_LIST_FAIL_IF_UNSORTED\fP
Packit Service 4684c1
flag will cause the function to fail if the provided list is not
Packit Service 4684c1
sorted from subject to issuer.
Packit Service 4684c1
Packit Service 4684c1
If the Certificate is PEM encoded it should have a header of "X509
Packit Service 4684c1
CERTIFICATE", or "CERTIFICATE".
Packit Service 4684c1
.SH "RETURNS"
Packit Service 4684c1
the number of certificates read or a 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