SysTutorials Posts

NAME gnutls_dh_params_import_raw – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_import_raw(gnutls_dh_params_t dh_params, const gnutls_datum_t * prime, const gnutls_datum_t * generator); ARGUMENTS gnutls_dh_params_t dh_params Is a structure that will hold the prime numbers const gnutls_datum_t * prime holds the new prime const gnutls_datum_t * generator holds the new generator DESCRIPTION This function will replace the pair of…

NAME gnutls_dh_params_import_pkcs3 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_import_pkcs3(gnutls_dh_params_t params, const gnutls_datum_t * pkcs3_params, gnutls_x509_crt_fmt_t format); ARGUMENTS gnutls_dh_params_t params A structure where the parameters will be copied to const gnutls_datum_t * pkcs3_params should contain a PKCS3 DHParams structure PEM or DER encoded gnutls_x509_crt_fmt_t format the format of params. PEM or DER. DESCRIPTION This function…

NAME gnutls_dh_params_generate2 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_generate2(gnutls_dh_params_t dparams, unsigned int bits); ARGUMENTS gnutls_dh_params_t dparams Is the structure that the DH parameters will be stored unsigned int bits is the prime’s number of bits DESCRIPTION This function will generate a new pair of prime and generator for use in the Diffie-Hellman key exchange….

NAME gnutls_dh_params_export_raw – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_export_raw(gnutls_dh_params_t params, gnutls_datum_t * prime, gnutls_datum_t * generator, unsigned int * bits); ARGUMENTS gnutls_dh_params_t params Holds the DH parameters gnutls_datum_t * prime will hold the new prime gnutls_datum_t * generator will hold the new generator unsigned int * bits if non null will hold the secret…

NAME gnutls_dh_params_export_pkcs3 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_export_pkcs3(gnutls_dh_params_t params, gnutls_x509_crt_fmt_t format, unsigned char * params_data, size_t * params_data_size); ARGUMENTS gnutls_dh_params_t params Holds the DH parameters gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. unsigned char * params_data will contain a PKCS3 DHParams structure PEM or DER encoded size_t *…

NAME gnutls_dh_params_export2_pkcs3 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_export2_pkcs3(gnutls_dh_params_t params, gnutls_x509_crt_fmt_t format, gnutls_datum_t * out); ARGUMENTS gnutls_dh_params_t params Holds the DH parameters gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. gnutls_datum_t * out will contain a PKCS3 DHParams structure PEM or DER encoded DESCRIPTION This function will export the given…

NAME gnutls_dh_params_deinit – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_dh_params_deinit(gnutls_dh_params_t dh_params); ARGUMENTS gnutls_dh_params_t dh_params Is a structure that holds the prime numbers DESCRIPTION This function will deinitialize the DH parameters structure. 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…

NAME gnutls_dh_params_cpy – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_params_cpy(gnutls_dh_params_t dst, gnutls_dh_params_t src); ARGUMENTS gnutls_dh_params_t dst Is the destination structure, which should be initialized. gnutls_dh_params_t src Is the source structure DESCRIPTION This function will copy the DH parameters structure from source to destination. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code…

NAME gnutls_dh_get_secret_bits – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_get_secret_bits(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This function will return the bits used in the last Diffie-Hellman key exchange with the peer. Should be used for both anonymous and ephemeral Diffie-Hellman. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code…

NAME gnutls_dh_get_pubkey – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_get_pubkey(gnutls_session_t session, gnutls_datum_t * raw_key); ARGUMENTS gnutls_session_t session is a gnutls session gnutls_datum_t * raw_key will hold the public key. DESCRIPTION This function will return the peer’s public key used in the last Diffie-Hellman key exchange. This function should be used for both anonymous and ephemeral…

NAME gnutls_dh_get_prime_bits – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_get_prime_bits(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This function will return the bits of the prime used in the last Diffie-Hellman key exchange with the peer. Should be used for both anonymous and ephemeral Diffie-Hellman. Note that some ciphers, like RSA and DSA…

NAME gnutls_dh_get_peers_public_bits – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_get_peers_public_bits(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION Get the Diffie-Hellman public key bit size. Can be used for both anonymous and ephemeral Diffie-Hellman. RETURNS The public key bit size used in the last Diffie-Hellman key exchange with the peer, or a negative error…

NAME gnutls_dh_get_group – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_dh_get_group(gnutls_session_t session, gnutls_datum_t * raw_gen, gnutls_datum_t * raw_prime); ARGUMENTS gnutls_session_t session is a gnutls session gnutls_datum_t * raw_gen will hold the generator. gnutls_datum_t * raw_prime will hold the prime. DESCRIPTION This function will return the group parameters used in the last Diffie-Hellman key exchange with the…

NAME gnutls_deinit – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_deinit(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function clears all buffers associated with the session . This function will also remove session data from the session database if the session was terminated abnormally. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home…

NAME gnutls_db_set_store_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_set_store_function(gnutls_session_t session, gnutls_db_store_func store_func); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_db_store_func store_func is the function DESCRIPTION Sets the function that will be used to store data in the resumed sessions database. This function must return 0 on success. The first argument to store_func will be…

NAME gnutls_db_set_retrieve_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_set_retrieve_function(gnutls_session_t session, gnutls_db_retr_func retr_func); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_db_retr_func retr_func is the function. DESCRIPTION Sets the function that will be used to retrieve data from the resumed sessions database. This function must return a gnutls_datum_t containing the data on success, or a gnutls_datum_t…

NAME gnutls_db_set_remove_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_set_remove_function(gnutls_session_t session, gnutls_db_remove_func rem_func); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_db_remove_func rem_func is the function. DESCRIPTION Sets the function that will be used to remove data from the resumed sessions database. This function must return 0 on success. The first argument to rem_func will be…

NAME gnutls_db_set_ptr – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_set_ptr(gnutls_session_t session, void * ptr); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. void * ptr is the pointer DESCRIPTION Sets the pointer that will be provided to db store, retrieve and delete functions, as the first argument. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home…

NAME gnutls_db_set_cache_expiration – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_set_cache_expiration(gnutls_session_t session, int seconds); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. int seconds is the number of seconds. DESCRIPTION Set the expiration time for resumed sessions. The default is 3600 (one hour) at the time of this writing. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>….

NAME gnutls_db_remove_session – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_db_remove_session(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function will remove the current session data from the session database. This will prevent future handshakes reusing these session data. This function should be called if a session was terminated abnormally, and before gnutls_deinit() is…