|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_certificate_set_x509_key_mem2" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_certificate_set_x509_key_mem2 \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/gnutls.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_certificate_set_x509_key_mem2(gnutls_certificate_credentials_t " res ", const gnutls_datum_t * " cert ", const gnutls_datum_t * " key ", gnutls_x509_crt_fmt_t " type ", const char * " pass ", unsigned int " flags ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_certificate_credentials_t res" 12
|
|
Packit Service |
4684c1 |
is a \fBgnutls_certificate_credentials_t\fP type.
|
|
Packit Service |
4684c1 |
.IP "const gnutls_datum_t * cert" 12
|
|
Packit Service |
4684c1 |
contains a certificate list (path) for the specified private key
|
|
Packit Service |
4684c1 |
.IP "const gnutls_datum_t * key" 12
|
|
Packit Service |
4684c1 |
is the private key, or \fBNULL\fP
|
|
Packit Service |
4684c1 |
.IP "gnutls_x509_crt_fmt_t type" 12
|
|
Packit Service |
4684c1 |
is PEM or DER
|
|
Packit Service |
4684c1 |
.IP "const char * pass" 12
|
|
Packit Service |
4684c1 |
is the key's password
|
|
Packit Service |
4684c1 |
.IP "unsigned int flags" 12
|
|
Packit Service |
4684c1 |
an ORed sequence of gnutls_pkcs_encrypt_flags_t
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
This function sets a certificate/private key pair in the
|
|
Packit Service |
4684c1 |
gnutls_certificate_credentials_t type. This function may be called
|
|
Packit Service |
4684c1 |
more than once, in case multiple keys/certificates exist for the
|
|
Packit Service |
4684c1 |
server.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Note that the keyUsage (2.5.29.15) PKIX extension in X.509 certificates
|
|
Packit Service |
4684c1 |
is supported. This means that certificates intended for signing cannot
|
|
Packit Service |
4684c1 |
be used for ciphersuites that require encryption.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If the certificate and the private key are given in PEM encoding
|
|
Packit Service |
4684c1 |
then the strings that hold their values must be null terminated.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The \fIkey\fP may be \fBNULL\fP if you are using a sign callback, see
|
|
Packit Service |
4684c1 |
\fBgnutls_sign_callback_set()\fP.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Note that, this function by default returns zero on success and a negative value on error.
|
|
Packit Service |
4684c1 |
Since 3.5.6, when the flag \fBGNUTLS_CERTIFICATE_API_V2\fP is set using \fBgnutls_certificate_set_flags()\fP
|
|
Packit Service |
4684c1 |
it returns an index (greater or equal to zero). That index can be used to other functions to refer to the added key\-pair.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success this functions returns zero, and otherwise a negative value on error (see above for modifying that behavior).
|
|
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
|