|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_pcert_list_import_x509_file" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_pcert_list_import_x509_file \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/abstract.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "int gnutls_pcert_list_import_x509_file(gnutls_pcert_st * " pcert_list ", unsigned * " pcert_list_size ", const char * " file ", gnutls_x509_crt_fmt_t " format ", gnutls_pin_callback_t " pin_fn ", void * " pin_fn_userdata ", unsigned int " flags ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "gnutls_pcert_st * pcert_list" 12
|
|
Packit |
aea12f |
The structures to store the certificates; must not contain initialized \fBgnutls_pcert_st\fP structures.
|
|
Packit |
aea12f |
.IP "unsigned * pcert_list_size" 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 char * file" 12
|
|
Packit |
aea12f |
A file or supported URI with the certificates to load
|
|
Packit |
aea12f |
.IP "gnutls_x509_crt_fmt_t format" 12
|
|
Packit |
aea12f |
\fBGNUTLS_X509_FMT_DER\fP or \fBGNUTLS_X509_FMT_PEM\fP if a file is given
|
|
Packit |
aea12f |
.IP "gnutls_pin_callback_t pin_fn" 12
|
|
Packit |
aea12f |
a PIN callback if not globally set
|
|
Packit |
aea12f |
.IP "void * pin_fn_userdata" 12
|
|
Packit |
aea12f |
parameter for the PIN callback
|
|
Packit |
aea12f |
.IP "unsigned int flags" 12
|
|
Packit |
aea12f |
zero or flags from \fBgnutls_certificate_import_flags\fP
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This convenience function will import a certificate chain from the given
|
|
Packit |
aea12f |
file or supported URI to \fBgnutls_pcert_st\fP structures. The structures
|
|
Packit |
aea12f |
must be deinitialized afterwards using \fBgnutls_pcert_deinit()\fP.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This function will always return a sorted certificate chain.
|
|
Packit |
aea12f |
.SH "RETURNS"
|
|
Packit |
aea12f |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit |
aea12f |
negative error value; if the \fIpcert\fP list doesn't have enough space
|
|
Packit |
aea12f |
\fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP will be returned.
|
|
Packit |
aea12f |
.SH "SINCE"
|
|
Packit |
aea12f |
3.6.3
|
|
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
|