SysTutorials Posts

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…

NAME gnutls_pkcs11_obj_get_type – API function SYNOPSIS #include <gnutls/pkcs11.h> gnutls_pkcs11_obj_type_t gnutls_pkcs11_obj_get_type(gnutls_pkcs11_obj_t obj); ARGUMENTS gnutls_pkcs11_obj_t obj Holds the PKCS 11 object DESCRIPTION This function will return the type of the object being stored in the structure. RETURNS The type of the object SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…

NAME gnutls_pkcs11_obj_get_info – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_get_info(gnutls_pkcs11_obj_t obj, gnutls_pkcs11_obj_info_t itype, void * output, size_t * output_size); 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 requested void * output where output will be stored size_t * output_size contains the maximum size of the output and will…

NAME gnutls_pkcs11_obj_get_flags – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_get_flags(gnutls_pkcs11_obj_t obj, unsigned int * oflags); ARGUMENTS gnutls_pkcs11_obj_t obj The structure that holds the object unsigned int * oflags Will hold the output flags DESCRIPTION This function will return the flags of the object being stored in the structure. The oflags are the GNUTLS_PKCS11_OBJ_FLAG_MARK flags. RETURNS…

NAME gnutls_pkcs11_obj_get_exts – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_get_exts(gnutls_pkcs11_obj_t obj, gnutls_x509_ext_st ** exts, unsigned int * exts_size, unsigned int flags); ARGUMENTS gnutls_pkcs11_obj_t obj should contain a gnutls_pkcs11_obj_t type gnutls_x509_ext_st ** exts a pointer to a gnutls_x509_ext_st pointer unsigned int * exts_size will be updated with the number of exts unsigned int flags Or sequence…

NAME gnutls_pkcs11_obj_flags_get_str – API function SYNOPSIS #include <gnutls/pkcs11.h> char * gnutls_pkcs11_obj_flags_get_str(unsigned int flags); ARGUMENTS unsigned int flags holds the flags DESCRIPTION This function given an or-sequence of GNUTLS_PKCS11_OBJ_FLAG_MARK, will return an allocated string with its description. The string needs to be deallocated using gnutls_free(). RETURNS If flags is zero NULL is returned, otherwise an allocated…

NAME gnutls_pkcs11_obj_export_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_export_url(gnutls_pkcs11_obj_t obj, gnutls_pkcs11_url_type_t detailed, char ** url); ARGUMENTS gnutls_pkcs11_obj_t obj Holds the PKCS 11 certificate 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 certificate. RETURNS On…

NAME gnutls_pkcs11_obj_export3 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_export3(gnutls_pkcs11_obj_t obj, gnutls_x509_crt_fmt_t fmt, gnutls_datum_t * out); ARGUMENTS gnutls_pkcs11_obj_t obj Holds the object gnutls_x509_crt_fmt_t fmt The format of the exported data gnutls_datum_t * out will contain the object data DESCRIPTION This function will export the PKCS11 object data. It is normal for data to be inaccesible…

NAME gnutls_pkcs11_obj_export2 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_export2(gnutls_pkcs11_obj_t obj, gnutls_datum_t * out); ARGUMENTS gnutls_pkcs11_obj_t obj Holds the object gnutls_datum_t * out will contain the object data DESCRIPTION This function will export the PKCS11 object data. It is normal for data to be inaccesible and in that case GNUTLS_E_INVALID_REQUEST will be returned. The output…

NAME gnutls_pkcs11_obj_export – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_obj_export(gnutls_pkcs11_obj_t obj, void * output_data, size_t * output_data_size); ARGUMENTS gnutls_pkcs11_obj_t obj Holds the object void * output_data will contain the object data size_t * output_data_size holds the size of output_data (and will be replaced by the actual size of parameters) DESCRIPTION This function will export the…

NAME gnutls_pkcs11_obj_deinit – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_obj_deinit(gnutls_pkcs11_obj_t obj); ARGUMENTS gnutls_pkcs11_obj_t obj The structure to be initialized DESCRIPTION This function will deinitialize a certificate 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, with…

NAME gnutls_pkcs11_init – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_init(unsigned int flags, const char * deprecated_config_file); ARGUMENTS unsigned int flags An ORed sequence of GNUTLS_PKCS11_FLAG_* const char * deprecated_config_file either NULL or the location of a deprecated configuration file DESCRIPTION This function will initialize the PKCS 11 subsystem in gnutls. It will read configuration files…

NAME gnutls_pkcs11_get_raw_issuer – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_get_raw_issuer(const char * url, gnutls_x509_crt_t cert, gnutls_datum_t * issuer, gnutls_x509_crt_fmt_t fmt, unsigned int flags); ARGUMENTS const char * url A PKCS 11 url identifying a token gnutls_x509_crt_t cert is the certificate to find issuer for gnutls_datum_t * issuer Will hold the issuer if any in an…

NAME gnutls_pkcs11_get_pin_function – API function SYNOPSIS #include <gnutls/pkcs11.h> gnutls_pin_callback_t gnutls_pkcs11_get_pin_function(void ** userdata); ARGUMENTS void ** userdata data to be supplied to callback DESCRIPTION This function will return the callback function set using gnutls_pkcs11_set_pin_function(). RETURNS The function set or NULL otherwise. SINCE 3.1.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…

NAME gnutls_pkcs11_delete_url – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_delete_url(const char * object_url, unsigned int flags); ARGUMENTS const char * object_url The URL of the object to delete. unsigned int flags One of GNUTLS_PKCS11_OBJ_* flags DESCRIPTION This function will delete objects matching the given URL. Note that not all tokens support the delete operation. RETURNS…