Blame doc/functions/gnutls_certificate_set_x509_key_mem
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_certificate_set_x509_key_mem} (gnutls_certificate_credentials_t @var{res}, const gnutls_datum_t * @var{cert}, const gnutls_datum_t * @var{key}, gnutls_x509_crt_fmt_t @var{type})
|
|
Packit Service |
4684c1 |
@var{res}: is a @code{gnutls_certificate_credentials_t} type.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{cert}: contains a certificate list (path) for the specified private key
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{key}: is the private key, or @code{NULL}
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{type}: is PEM or DER
|
|
Packit Service |
4684c1 |
|
|
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 @code{key} may be @code{NULL} if you are using a sign callback, see
|
|
Packit Service |
4684c1 |
@code{gnutls_sign_callback_set()} .
|
|
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 @code{GNUTLS_CERTIFICATE_API_V2} is set using @code{gnutls_certificate_set_flags()}
|
|
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 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} On success this functions returns zero, and otherwise a negative value on error (see above for modifying that behavior).
|
|
Packit Service |
4684c1 |
@end deftypefun
|