Linux Manuals session 3

gnutls_pkcs12_export – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_export(gnutls_pkcs12_t pkcs12, gnutls_x509_crt_fmt_t format, void * output_data, size_t * output_data_size); Argumentsgnutls_pkcs12_t pkcs12 Holds the pkcs12 structure gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. void * output_data will contain a structure PEM or DER encoded size_t * output_data_size holds the size of output_data (and…

gnutls_pkcs12_deinit – API function Synopsis#include <gnutls/pkcs12.h> void gnutls_pkcs12_deinit(gnutls_pkcs12_t pkcs12); Argumentsgnutls_pkcs12_t pkcs12 The structure to be initializedDescriptionThis function will deinitialize a PKCS12 structure. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are permitted in any medium without…

gnutls_pkcs12_bag_set_key_id – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_set_key_id(gnutls_pkcs12_bag_t bag, int indx, const gnutls_datum_t * id); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The bag’s element to add the id const gnutls_datum_t * id the IDDescriptionThis function will add the given key ID, to the specified, by the index, bag element. The key ID will be encoded…

gnutls_pkcs12_bag_set_friendly_name – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_set_friendly_name(gnutls_pkcs12_bag_t bag, int indx, const char * name); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The bag’s element to add the id const char * name the nameDescriptionThis function will add the given key friendly name, to the specified, by the index, bag element. The name will be encoded…

gnutls_pkcs12_bag_set_data – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_set_data(gnutls_pkcs12_bag_t bag, gnutls_pkcs12_bag_type_t type, const gnutls_datum_t * data); Argumentsgnutls_pkcs12_bag_t bag The bag gnutls_pkcs12_bag_type_t type The data’s type const gnutls_datum_t * data the data to be copied.DescriptionThis function will insert the given data of the given type into the bag. Returnsthe index of the added bag on success, or…

gnutls_pkcs12_bag_set_crt – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_set_crt(gnutls_pkcs12_bag_t bag, gnutls_x509_crt_t crt); Argumentsgnutls_pkcs12_bag_t bag The bag gnutls_x509_crt_t crt the certificate to be copied.DescriptionThis function will insert the given certificate into the bag. This is just a wrapper over gnutls_pkcs12_bag_set_data(). Returnsthe index of the added bag on success, or a negative value on failure. Reporting BugsReport bugs…

gnutls_pkcs12_bag_set_crl – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_set_crl(gnutls_pkcs12_bag_t bag, gnutls_x509_crl_t crl); Argumentsgnutls_pkcs12_bag_t bag The bag gnutls_x509_crl_t crl the CRL to be copied.DescriptionThis function will insert the given CRL into the bag. This is just a wrapper over gnutls_pkcs12_bag_set_data(). Returnsthe index of the added bag on success, or a negative error code on failure. Reporting BugsReport…

gnutls_pkcs12_bag_init – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_init(gnutls_pkcs12_bag_t * bag); Argumentsgnutls_pkcs12_bag_t * bag The structure to be initializedDescriptionThis function will initialize a PKCS12 bag structure. PKCS12 Bags usually contain private keys, lists of X.509 Certificates and X.509 Certificate revocation lists. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs to…

gnutls_pkcs12_bag_get_type – API function Synopsis#include <gnutls/pkcs12.h> gnutls_pkcs12_bag_type_t gnutls_pkcs12_bag_get_type(gnutls_pkcs12_bag_t bag, int indx); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The element of the bag to get the typeDescriptionThis function will return the bag’s type. ReturnsOne of the gnutls_pkcs12_bag_type_t enumerations. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

gnutls_pkcs12_bag_get_key_id – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_get_key_id(gnutls_pkcs12_bag_t bag, int indx, gnutls_datum_t * id); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The bag’s element to add the id gnutls_datum_t * id where the ID will be copied (to be treated as const)DescriptionThis function will return the key ID, of the specified bag element. The key ID…

gnutls_pkcs12_bag_get_friendly_name – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_get_friendly_name(gnutls_pkcs12_bag_t bag, int indx, char ** name); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The bag’s element to add the id char ** name will hold a pointer to the name (to be treated as const)DescriptionThis function will return the friendly name, of the specified bag element. The key…

gnutls_pkcs12_bag_get_data – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_get_data(gnutls_pkcs12_bag_t bag, int indx, gnutls_datum_t * data); Argumentsgnutls_pkcs12_bag_t bag The bag int indx The element of the bag to get the data from gnutls_datum_t * data where the bag’s data will be. Should be treated as constant.DescriptionThis function will return the bag’s data. The data is a constant…

gnutls_pkcs12_bag_get_count – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_get_count(gnutls_pkcs12_bag_t bag); Argumentsgnutls_pkcs12_bag_t bag The bagDescriptionThis function will return the number of the elements withing the bag. ReturnsNumber of elements in bag, or an negative error code on error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and…

gnutls_pkcs12_bag_encrypt – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_encrypt(gnutls_pkcs12_bag_t bag, const char * pass, unsigned int flags); Argumentsgnutls_pkcs12_bag_t bag The bag const char * pass The password used for encryption, must be ASCII unsigned int flags should be one of gnutls_pkcs_encrypt_flags_t elements bitwise or’dDescriptionThis function will encrypt the given bag. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned,…

gnutls_pkcs12_bag_deinit – API function Synopsis#include <gnutls/pkcs12.h> void gnutls_pkcs12_bag_deinit(gnutls_pkcs12_bag_t bag); Argumentsgnutls_pkcs12_bag_t bag The structure to be initializedDescriptionThis function will deinitialize a PKCS12 Bag structure. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are permitted in any medium…

gnutls_pkcs12_bag_decrypt – API function Synopsis#include <gnutls/pkcs12.h> int gnutls_pkcs12_bag_decrypt(gnutls_pkcs12_bag_t bag, const char * pass); Argumentsgnutls_pkcs12_bag_t bag The bag const char * pass The password used for encryption, must be ASCII.DescriptionThis function will decrypt the given encrypted bag and return 0 on success. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned. Reporting…

gnutls_pkcs11_type_get_name – API function Synopsis#include <gnutls/pkcs11.h> const char * gnutls_pkcs11_type_get_name(gnutls_pkcs11_obj_type_t type); Argumentsgnutls_pkcs11_obj_type_t type Holds the PKCS 11 object type, a gnutls_pkcs11_obj_type_t.DescriptionThis function will return a human readable description of the PKCS11 object type obj . It will return "Unknown" for unknown types. Returnshuman readable string labeling the PKCS11 object type  type . Since2.12.0 Reporting BugsReport bugs…

gnutls_pkcs11_token_set_pin – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_pkcs11_token_set_pin(const char * token_url, const char * oldpin, const char * newpin, unsigned int flags); Argumentsconst char * token_url A PKCS 11 URL specifying a token const char * oldpin old user’s PIN const char * newpin new user’s PIN unsigned int flags one of gnutls_pin_flag_t.DescriptionThis function will…

gnutls_pkcs11_token_init – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_pkcs11_token_init(const char * token_url, const char * so_pin, const char * label); Argumentsconst char * token_url A PKCS 11 URL specifying a token const char * so_pin Security Officer’s PIN const char * label A name to be used for the tokenDescriptionThis function will initialize (format) a token….

gnutls_pkcs11_token_get_url – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_pkcs11_token_get_url(unsigned int seq, gnutls_pkcs11_url_type_t detailed, char ** url); Argumentsunsigned int seq sequence number starting from 0 gnutls_pkcs11_url_type_t detailed non zero if a detailed URL is required char ** url will contain an allocated urlDescriptionThis function will return the URL for each token available in system. The url has…