Section 3: library functions
NAME gnutls_pubkey_export_rsa_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export_rsa_raw(gnutls_pubkey_t key, gnutls_datum_t * m, gnutls_datum_t * e); ARGUMENTS gnutls_pubkey_t key Holds the certificate gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponent DESCRIPTION This function will export the RSA public key’s parameters found in the given structure. The new…
NAME gnutls_pubkey_export_ecc_x962 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export_ecc_x962(gnutls_pubkey_t key, gnutls_datum_t * parameters, gnutls_datum_t * ecpoint); ARGUMENTS gnutls_pubkey_t key Holds the public key gnutls_datum_t * parameters DER encoding of an ANSI X9.62 parameters gnutls_datum_t * ecpoint DER encoding of ANSI X9.62 ECPoint DESCRIPTION This function will export the ECC public key’s parameters found in…
NAME gnutls_pubkey_export_ecc_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export_ecc_raw(gnutls_pubkey_t key, gnutls_ecc_curve_t * curve, gnutls_datum_t * x, gnutls_datum_t * y); ARGUMENTS gnutls_pubkey_t key Holds the public key gnutls_ecc_curve_t * curve will hold the curve gnutls_datum_t * x will hold x gnutls_datum_t * y will hold y DESCRIPTION This function will export the ECC public key’s…
NAME gnutls_pubkey_export_dsa_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export_dsa_raw(gnutls_pubkey_t key, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y); ARGUMENTS gnutls_pubkey_t key Holds the public key gnutls_datum_t * p will hold the p gnutls_datum_t * q will hold the q gnutls_datum_t * g will hold the g gnutls_datum_t * y will…
NAME gnutls_pubkey_export2 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export2(gnutls_pubkey_t key, gnutls_x509_crt_fmt_t format, gnutls_datum_t * out); ARGUMENTS gnutls_pubkey_t key Holds the certificate gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. gnutls_datum_t * out will contain a certificate PEM or DER encoded DESCRIPTION This function will export the public key to DER…
NAME gnutls_pubkey_export – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_export(gnutls_pubkey_t key, gnutls_x509_crt_fmt_t format, void * output_data, size_t * output_data_size); ARGUMENTS gnutls_pubkey_t key Holds the certificate gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. void * output_data will contain a certificate PEM or DER encoded size_t * output_data_size holds the size of…
NAME gnutls_pubkey_encrypt_data – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_encrypt_data(gnutls_pubkey_t key, unsigned int flags, const gnutls_datum_t * plaintext, gnutls_datum_t * ciphertext); ARGUMENTS gnutls_pubkey_t key Holds the public key unsigned int flags should be 0 for now const gnutls_datum_t * plaintext The data to be encrypted gnutls_datum_t * ciphertext contains the encrypted data DESCRIPTION This function…
NAME gnutls_pubkey_deinit – API function SYNOPSIS #include <gnutls/abstract.h> void gnutls_pubkey_deinit(gnutls_pubkey_t key); ARGUMENTS gnutls_pubkey_t key The structure to be deinitialized DESCRIPTION This function will deinitialize a public key structure. SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file,…
NAME gnutls_psk_set_server_params_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_set_server_params_function(gnutls_psk_server_credentials_t res, gnutls_params_function * func); ARGUMENTS gnutls_psk_server_credentials_t res is a gnutls_certificate_credentials_t structure gnutls_params_function * func is the function to be called DESCRIPTION This function will set a callback in order for the server to get the Diffie-Hellman parameters for PSK authentication. The callback should return GNUTLS_E_SUCCESS…
NAME gnutls_psk_set_server_dh_params – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_set_server_dh_params(gnutls_psk_server_credentials_t res, gnutls_dh_params_t dh_params); ARGUMENTS gnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure gnutls_dh_params_t dh_params is a structure that holds Diffie-Hellman parameters. DESCRIPTION This function will set the Diffie-Hellman parameters for an anonymous server to use. These parameters will be used in Diffie-Hellman exchange with PSK cipher suites….
NAME gnutls_psk_set_server_credentials_hint – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_set_server_credentials_hint(gnutls_psk_server_credentials_t res, const char * hint); ARGUMENTS gnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure. const char * hint is the PSK identity hint string DESCRIPTION This function sets the identity hint, in a gnutls_psk_server_credentials_t structure. This hint is sent to the client to help it chose a…
NAME gnutls_psk_set_server_credentials_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_set_server_credentials_function(gnutls_psk_server_credentials_t cred, gnutls_psk_server_credentials_function * func); ARGUMENTS gnutls_psk_server_credentials_t cred is a gnutls_psk_server_credentials_t structure. gnutls_psk_server_credentials_function * func is the callback function DESCRIPTION This function can be used to set a callback to retrieve the user’s PSK credentials. The callback’s function form is: int (*callback)(gnutls_session_t, const char* username, gnutls_datum_t*…
NAME gnutls_psk_set_server_credentials_file – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_set_server_credentials_file(gnutls_psk_server_credentials_t res, const char * password_file); ARGUMENTS gnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure. const char * password_file is the PSK password file (passwd.psk) DESCRIPTION This function sets the password file, in a gnutls_psk_server_credentials_t structure. This password file holds usernames and keys and will be used for…
NAME gnutls_psk_set_params_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_set_params_function(gnutls_psk_server_credentials_t res, gnutls_params_function * func); ARGUMENTS gnutls_psk_server_credentials_t res is a gnutls_psk_server_credentials_t structure gnutls_params_function * func is the function to be called DESCRIPTION This function will set a callback in order for the server to get the Diffie-Hellman or RSA parameters for PSK authentication. The callback should…
NAME gnutls_psk_set_client_credentials_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_set_client_credentials_function(gnutls_psk_client_credentials_t cred, gnutls_psk_client_credentials_function * func); ARGUMENTS gnutls_psk_client_credentials_t cred is a gnutls_psk_server_credentials_t structure. gnutls_psk_client_credentials_function * func is the callback function DESCRIPTION This function can be used to set a callback to retrieve the username and password for client PSK authentication. The callback’s function form is: int (*callback)(gnutls_session_t,…
NAME gnutls_psk_set_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_set_client_credentials(gnutls_psk_client_credentials_t res, const char * username, const gnutls_datum_t * key, gnutls_psk_key_flags flags); ARGUMENTS gnutls_psk_client_credentials_t res is a gnutls_psk_client_credentials_t structure. const char * username is the user’s zero-terminated userid const gnutls_datum_t * key is the user’s key gnutls_psk_key_flags flags indicate the format of the key, either GNUTLS_PSK_KEY_RAW…
NAME gnutls_psk_server_get_username – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_psk_server_get_username(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This should only be called in case of PSK authentication and in case of a server. RETURNS the username of the peer, or NULL in case of an error. REPORTING BUGS Report bugs to…
NAME gnutls_psk_netconf_derive_key – derive PSK Netconf key from password SYNOPSIS #include <gnutls/gnutls.h> int gnutls_psk_netconf_derive_key(const char * password, const char * psk_identity, const char * psk_identity_hint, gnutls_datum_t * output_key); ARGUMENTS const char * password zero terminated string containing password. const char * psk_identity zero terminated string with PSK identity. const char * psk_identity_hint zero terminated string…
NAME gnutls_psk_free_server_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_free_server_credentials(gnutls_psk_server_credentials_t sc); ARGUMENTS gnutls_psk_server_credentials_t sc is a gnutls_psk_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…
NAME gnutls_psk_free_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_psk_free_client_credentials(gnutls_psk_client_credentials_t sc); ARGUMENTS gnutls_psk_client_credentials_t sc is a gnutls_psk_client_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…