Blame doc/functions/gnutls_credentials_set

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_credentials_set} (gnutls_session_t @var{session}, gnutls_credentials_type_t @var{type}, void * @var{cred})
Packit Service 4684c1
@var{session}: is a @code{gnutls_session_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{type}: is the type of the credentials
Packit Service 4684c1
Packit Service 4684c1
@var{cred}: the credentials to set
Packit Service 4684c1
Packit Service 4684c1
Sets the needed credentials for the specified type.  E.g. username,
Packit Service 4684c1
password - or public and private keys etc.  The  @code{cred} parameter is
Packit Service 4684c1
a structure that depends on the specified type and on the current
Packit Service 4684c1
session (client or server).
Packit Service 4684c1
Packit Service 4684c1
In order to minimize memory usage, and share credentials between
Packit Service 4684c1
several threads gnutls keeps a pointer to cred, and not the whole
Packit Service 4684c1
cred structure.  Thus you will have to keep the structure allocated
Packit Service 4684c1
until you call @code{gnutls_deinit()} .
Packit Service 4684c1
Packit Service 4684c1
For @code{GNUTLS_CRD_ANON} ,  @code{cred} should be
Packit Service 4684c1
@code{gnutls_anon_client_credentials_t}  in case of a client.  In case of
Packit Service 4684c1
a server it should be @code{gnutls_anon_server_credentials_t} .
Packit Service 4684c1
Packit Service 4684c1
For @code{GNUTLS_CRD_SRP} ,  @code{cred} should be @code{gnutls_srp_client_credentials_t} 
Packit Service 4684c1
in case of a client, and @code{gnutls_srp_server_credentials_t} , in case
Packit Service 4684c1
of a server.
Packit Service 4684c1
Packit Service 4684c1
For @code{GNUTLS_CRD_CERTIFICATE} ,  @code{cred} should be
Packit Service 4684c1
@code{gnutls_certificate_credentials_t} .
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
Packit Service 4684c1
otherwise a negative error code is returned.
Packit Service 4684c1
@end deftypefun