Linux Manuals session 3

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…

NAME gnutls_pkcs11_deinit – API function SYNOPSIS #include <gnutls/pkcs11.h> void gnutls_pkcs11_deinit( void); ARGUMENTS void DESCRIPTION This function will deinitialize the PKCS 11 subsystem in gnutls. This function is only needed if you need to deinitialize the subsystem without calling gnutls_global_deinit(). SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright ©…

NAME gnutls_pkcs11_crt_is_known – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_crt_is_known(const char * url, gnutls_x509_crt_t cert, 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 unsigned int flags Use zero or flags from GNUTLS_PKCS11_OBJ_FLAG. DESCRIPTION This function will check whether the…

NAME gnutls_pkcs11_copy_x509_privkey2 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_copy_x509_privkey2(const char * token_url, gnutls_x509_privkey_t key, const char * label, const gnutls_datum_t * cid, unsigned int key_usage, unsigned int flags); ARGUMENTS const char * token_url A PKCS 11 URL specifying a token gnutls_x509_privkey_t key A private key const char * label A name to be used…

NAME gnutls_pkcs11_copy_x509_privkey – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_copy_x509_privkey(const char * token_url, gnutls_x509_privkey_t key, const char * label, unsigned int key_usage, unsigned int flags); ARGUMENTS const char * token_url A PKCS 11 URL specifying a token gnutls_x509_privkey_t key A private key const char * label A name to be used for the stored data…

NAME gnutls_pkcs11_copy_x509_crt2 – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_copy_x509_crt2(const char * token_url, gnutls_x509_crt_t crt, const char * label, const gnutls_datum_t * cid, unsigned int flags); ARGUMENTS const char * token_url A PKCS 11 URL specifying a token gnutls_x509_crt_t crt The certificate to copy const char * label The name to be used for the…

NAME gnutls_pkcs11_copy_x509_crt – API function SYNOPSIS #include <gnutls/pkcs11.h> int gnutls_pkcs11_copy_x509_crt(const char * token_url, gnutls_x509_crt_t crt, const char * label, unsigned int flags); ARGUMENTS const char * token_url A PKCS 11 URL specifying a token gnutls_x509_crt_t crt The certificate to copy const char * label The name to be used for the stored data unsigned int…