SysTutorials Posts

NAME gnutls_pubkey_get_verify_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_verify_algorithm(gnutls_pubkey_t key, const gnutls_datum_t * signature, gnutls_digest_algorithm_t * hash); ARGUMENTS gnutls_pubkey_t key Holds the certificate const gnutls_datum_t * signature contains the signature gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signature DESCRIPTION This function will read the certifcate and the…

NAME gnutls_pubkey_get_preferred_hash_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_preferred_hash_algorithm(gnutls_pubkey_t key, gnutls_digest_algorithm_t * hash, unsigned int * mand); ARGUMENTS gnutls_pubkey_t key Holds the certificate gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signature unsigned int * mand If non zero it means that the algorithm MUST use this hash….

NAME gnutls_pubkey_get_pk_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_pk_algorithm(gnutls_pubkey_t key, unsigned int * bits); ARGUMENTS gnutls_pubkey_t key should contain a gnutls_pubkey_t structure unsigned int * bits If set will return the number of bits of the parameters (may be NULL) DESCRIPTION This function will return the public key algorithm of a public key and…

NAME gnutls_pubkey_get_openpgp_key_id – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_openpgp_key_id(gnutls_pubkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size, unsigned int * subkey); ARGUMENTS gnutls_pubkey_t key Holds the public key unsigned int flags should be 0 or GNUTLS_PUBKEY_GET_OPENPGP_FINGERPRINT unsigned char * output_data will contain the key ID size_t * output_data_size holds the size…

NAME gnutls_pubkey_get_key_usage – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_key_usage(gnutls_pubkey_t key, unsigned int * usage); ARGUMENTS gnutls_pubkey_t key should contain a gnutls_pubkey_t structure unsigned int * usage If set will return the number of bits of the parameters (may be NULL) DESCRIPTION This function will return the key usage of the public key. RETURNS On…

NAME gnutls_pubkey_get_key_id – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_key_id(gnutls_pubkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size); ARGUMENTS gnutls_pubkey_t key Holds the public key unsigned int flags should be 0 for now unsigned char * output_data will contain the key ID size_t * output_data_size holds the size of output_data (and will…

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…