Linux Manuals session 3

NAME gnutls_pkcs11_set_pin_function – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_set_pin_function(gnutls_pin_callback_t fn, void * userdata); ARGUMENTS gnutls_pin_callback_t fn The PIN callback, a gnutls_pin_callback_t() function. void * userdata data to be supplied to callback DESCRIPTION This function will set a callback function to be used when a PIN is required for PKCS 11 operations. See gnutls_pin_callback_t() on…

NAME gnutls_pkcs11_reinit – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_reinit( void); ARGUMENTS void DESCRIPTION This function will reinitialize the PKCS 11 subsystem in gnutls. This is required by PKCS 11 when an application uses fork(). The reinitialization function must be called on the child. Note that since GnuTLS 3.3.0, the reinitialization of the PKCS 11…

NAME gnutls_pkcs11_privkey_status – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_status(gnutls_pkcs11_privkey_t key); ARGUMENTS gnutls_pkcs11_privkey_t key Holds the key DESCRIPTION Checks the status of the private key token. RETURNS this function will return non-zero if the token holding the private key is still available (inserted), and zero otherwise. SINCE 3.1.9 REPORTING BUGS Report bugs to <bugs [at]…

NAME gnutls_pkcs11_privkey_set_pin_function – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_privkey_set_pin_function(gnutls_pkcs11_privkey_t key, gnutls_pin_callback_t fn, void * userdata); ARGUMENTS gnutls_pkcs11_privkey_t key The private key gnutls_pin_callback_t fn the callback void * userdata data associated with the callback DESCRIPTION This function will set a callback function to be used when required to access the object. This function overrides the…

NAME gnutls_pkcs11_privkey_init – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_init(gnutls_pkcs11_privkey_t * key); ARGUMENTS gnutls_pkcs11_privkey_t * key The structure to be initialized DESCRIPTION This function will initialize an private key structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…

NAME gnutls_pkcs11_privkey_import_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_import_url(gnutls_pkcs11_privkey_t pkey, const char * url, unsigned int flags); ARGUMENTS gnutls_pkcs11_privkey_t pkey The structure to store the parsed key const char * url a PKCS 11 url identifying the key unsigned int flags Or sequence of GNUTLS_PKCS11_OBJ_* flags DESCRIPTION This function will "import" a PKCS 11…

NAME gnutls_pkcs11_privkey_get_pk_algorithm – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_get_pk_algorithm(gnutls_pkcs11_privkey_t key, unsigned int * bits); ARGUMENTS gnutls_pkcs11_privkey_t key should contain a gnutls_pkcs11_privkey_t structure unsigned int * bits if bits is non null it will hold the size of the parameters’ in bits DESCRIPTION This function will return the public key algorithm of a private key….

NAME gnutls_pkcs11_privkey_get_info – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_get_info(gnutls_pkcs11_privkey_t pkey, gnutls_pkcs11_obj_info_t itype, void * output, size_t * output_size); ARGUMENTS gnutls_pkcs11_privkey_t pkey should contain a gnutls_pkcs11_privkey_t structure gnutls_pkcs11_obj_info_t itype Denotes the type of information requested void * output where output will be stored size_t * output_size contains the maximum size of the output and will…

NAME gnutls_pkcs11_privkey_generate3 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_generate3(const char * url, gnutls_pk_algorithm_t pk, unsigned int bits, const char * label, const gnutls_datum_t * cid, gnutls_x509_crt_fmt_t fmt, gnutls_datum_t * pubkey, unsigned int flags); ARGUMENTS const char * url a token URL gnutls_pk_algorithm_t pk the public key algorithm unsigned int bits the security bits const…

NAME gnutls_pkcs11_privkey_generate2 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_generate2(const char * url, gnutls_pk_algorithm_t pk, unsigned int bits, const char * label, gnutls_x509_crt_fmt_t fmt, gnutls_datum_t * pubkey, unsigned int flags); ARGUMENTS const char * url a token URL gnutls_pk_algorithm_t pk the public key algorithm unsigned int bits the security bits const char * label a…

NAME gnutls_pkcs11_privkey_generate – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_generate(const char * url, gnutls_pk_algorithm_t pk, unsigned int bits, const char * label, unsigned int flags); ARGUMENTS const char * url a token URL gnutls_pk_algorithm_t pk the public key algorithm unsigned int bits the security bits const char * label a label unsigned int flags should…

NAME gnutls_pkcs11_privkey_export_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_export_url(gnutls_pkcs11_privkey_t key, gnutls_pkcs11_url_type_t detailed, char ** url); ARGUMENTS gnutls_pkcs11_privkey_t key Holds the PKCS 11 key gnutls_pkcs11_url_type_t detailed non zero if a detailed URL is required char ** url will contain an allocated url DESCRIPTION This function will export a URL identifying the given key. RETURNS On…

NAME gnutls_pkcs11_privkey_export_pubkey – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_privkey_export_pubkey(gnutls_pkcs11_privkey_t pkey, gnutls_x509_crt_fmt_t fmt, gnutls_datum_t * data, unsigned int flags); ARGUMENTS gnutls_pkcs11_privkey_t pkey The private key gnutls_x509_crt_fmt_t fmt the format of output params. PEM or DER. gnutls_datum_t * data will hold the public key unsigned int flags should be zero DESCRIPTION This function will extract the…

NAME gnutls_pkcs11_privkey_deinit – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_privkey_deinit(gnutls_pkcs11_privkey_t key); ARGUMENTS gnutls_pkcs11_privkey_t key The structure to be initialized DESCRIPTION This function will deinitialize a private key 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 file, with or…

NAME gnutls_pkcs11_obj_set_pin_function – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_obj_set_pin_function(gnutls_pkcs11_obj_t obj, gnutls_pin_callback_t fn, void * userdata); ARGUMENTS gnutls_pkcs11_obj_t obj The object structure gnutls_pin_callback_t fn the callback void * userdata data associated with the callback DESCRIPTION This function will set a callback function to be used when required to access the object. This function overrides the…

NAME gnutls_pkcs11_obj_set_info – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_set_info(gnutls_pkcs11_obj_t obj, gnutls_pkcs11_obj_info_t itype, const void * data, size_t data_size, unsigned flags); ARGUMENTS gnutls_pkcs11_obj_t obj should contain a gnutls_pkcs11_obj_t structure gnutls_pkcs11_obj_info_t itype Denotes the type of information to be set const void * data the data to set size_t data_size the size of data unsigned flags…

NAME gnutls_pkcs11_obj_list_import_url2 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_list_import_url2(gnutls_pkcs11_obj_t ** p_list, unsigned int * n_list, const char * url, gnutls_pkcs11_obj_attr_t attrs, unsigned int flags); ARGUMENTS gnutls_pkcs11_obj_t ** p_list An uninitialized object list (may be NULL) unsigned int * n_list It will contain the size of the list. const char * url A PKCS 11…

NAME gnutls_pkcs11_obj_list_import_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_list_import_url(gnutls_pkcs11_obj_t * p_list, unsigned int * n_list, const char * url, gnutls_pkcs11_obj_attr_t attrs, unsigned int flags); ARGUMENTS gnutls_pkcs11_obj_t * p_list An uninitialized object list (may be NULL) unsigned int * n_list initially should hold the maximum size of the list. Will contain the actual size. const…

NAME gnutls_pkcs11_obj_init – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_init(gnutls_pkcs11_obj_t * obj); ARGUMENTS gnutls_pkcs11_obj_t * obj The structure to be initialized DESCRIPTION This function will initialize a pkcs11 certificate structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

NAME gnutls_pkcs11_obj_import_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_import_url(gnutls_pkcs11_obj_t obj, const char * url, unsigned int flags); ARGUMENTS gnutls_pkcs11_obj_t obj The structure to store the object const char * url a PKCS 11 url identifying the key unsigned int flags Or sequence of GNUTLS_PKCS11_OBJ_* flags DESCRIPTION This function will "import" a PKCS 11 URL…