gnutls_credentials_set3
Api function
Usage
#include <gnutls/gnutls.h>
int gnutls_credentials_set(gnutls_session_t session, gnutls_credentials_type_t type, void * cred);
Arguments
gnutls_session_t session
|
is a |
|---|---|
gnutls_credentials_type_t type
|
is the type of the credentials |
void * cred
|
the credentials to set |
Overview
Sets the needed credentials for the specified type. E.g. username, password - or public and private keys etc. The cred parameter is a structure that depends on the specified type and on the current session (client or server). Only a single cred may be set for each different type , subsequent calls with the same type will replace the previously set credentials.
In order to minimize memory usage, and share credentials between several threads gnutls keeps a pointer to cred , and not the whole cred structure. Thus you will have to keep the structure allocated until you call gnutls_deinit(), or a future call of gnutls_credentials_set() with the same type replaces the cred structure.
For GNUTLS_CRD_ANON, cred should be gnutls_anon_client_credentials_t in case of a client. In case of a server it should be gnutls_anon_server_credentials_t.
For GNUTLS_CRD_SRP, cred should be gnutls_srp_client_credentials_t in case of a client, and gnutls_srp_server_credentials_t, in case of a server.
For GNUTLS_CRD_CERTIFICATE, cred should be gnutls_certificate_credentials_t.
Returns
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned.
Releases
10 releases since Debian 4.0 (Etch); the text changed 9 times.