|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_x509_crt_list_import" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_x509_crt_list_import \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/x509.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.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 |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "gnutls_x509_crt_t * certs" 12
|
|
Packit |
aea12f |
Indicates where the parsed list will be copied to. Must not be initialized.
|
|
Packit |
aea12f |
.IP "unsigned int * cert_max" 12
|
|
Packit |
aea12f |
Initially must hold the maximum number of certs. It will be updated with the number of certs available.
|
|
Packit |
aea12f |
.IP "const gnutls_datum_t * data" 12
|
|
Packit |
aea12f |
The PEM encoded certificate.
|
|
Packit |
aea12f |
.IP "gnutls_x509_crt_fmt_t format" 12
|
|
Packit |
aea12f |
One of DER or PEM.
|
|
Packit |
aea12f |
.IP "unsigned int flags" 12
|
|
Packit |
aea12f |
must be (0) or an OR'd sequence of gnutls_certificate_import_flags.
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This function will convert the given PEM encoded certificate list
|
|
Packit |
aea12f |
to the native gnutls_x509_crt_t format. The output will be stored
|
|
Packit |
aea12f |
in \fIcerts\fP . They will be automatically initialized.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
The flag \fBGNUTLS_X509_CRT_LIST_IMPORT_FAIL_IF_EXCEED\fP will cause
|
|
Packit |
aea12f |
import to fail if the certificates in the provided buffer are more
|
|
Packit |
aea12f |
than the available structures. The \fBGNUTLS_X509_CRT_LIST_FAIL_IF_UNSORTED\fP
|
|
Packit |
aea12f |
flag will cause the function to fail if the provided list is not
|
|
Packit |
aea12f |
sorted from subject to issuer.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
If the Certificate is PEM encoded it should have a header of "X509
|
|
Packit |
aea12f |
CERTIFICATE", or "CERTIFICATE".
|
|
Packit |
aea12f |
.SH "RETURNS"
|
|
Packit |
aea12f |
the number of certificates read or a negative error value.
|
|
Packit |
aea12f |
.SH "REPORTING BUGS"
|
|
Packit |
aea12f |
Report bugs to <bugs@gnutls.org>.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Home page: https://www.gnutls.org
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
.SH COPYRIGHT
|
|
Packit Service |
991b93 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Copying and distribution of this file, with or without modification,
|
|
Packit |
aea12f |
are permitted in any medium without royalty provided the copyright
|
|
Packit |
aea12f |
notice and this notice are preserved.
|
|
Packit |
aea12f |
.SH "SEE ALSO"
|
|
Packit |
aea12f |
The full documentation for
|
|
Packit |
aea12f |
.B gnutls
|
|
Packit |
aea12f |
is maintained as a Texinfo manual.
|
|
Packit |
aea12f |
If the /usr/share/doc/gnutls/
|
|
Packit |
aea12f |
directory does not contain the HTML form visit
|
|
Packit |
aea12f |
.B
|
|
Packit |
aea12f |
.IP https://www.gnutls.org/manual/
|
|
Packit |
aea12f |
.PP
|