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