Linux Manuals session 3

NAME asprintf, vasprintf – print to allocated string SYNOPSIS #define _GNU_SOURCE /* See feature_test_macros(7) */ #include <stdio.h> int asprintf(char **strp, const char *fmt, …); int vasprintf(char **strp, const char *fmt, va_list ap); DESCRIPTION The functions asprintf() and vasprintf() are analogs of sprintf(3) and vsprintf(3), except that they allocate a string large enough to hold the…

NAME asn1_write_value – API function SYNOPSIS #include <libtasn1.h> int asn1_write_value(asn1_node node_root, const char * name, const void * ivalue, int len); ARGUMENTS asn1_node node_root pointer to a structure const char * name the name of the element inside the structure that you want to set. const void * ivalue vector used to specify the value…

NAME asn1_strerror – API function SYNOPSIS #include <libtasn1.h> const char * asn1_strerror(int error); ARGUMENTS int error is an error returned by a libtasn1 function. DESCRIPTION Returns a string with a description of an error. This function is similar to strerror. The only difference is that it accepts an error (number) returned by a libtasn1 function….

NAME asn1_read_value_type – API function SYNOPSIS #include <libtasn1.h> int asn1_read_value_type(asn1_node root, const char * name, void * ivalue, int * len, unsigned int * etype); ARGUMENTS asn1_node root pointer to a structure. const char * name the name of the element inside a structure that you want to read. void * ivalue vector that will…

NAME asn1_read_value – API function SYNOPSIS #include <libtasn1.h> int asn1_read_value(asn1_node root, const char * name, void * ivalue, int * len); ARGUMENTS asn1_node root pointer to a structure. const char * name the name of the element inside a structure that you want to read. void * ivalue vector that will contain the element’s content,…

NAME asn1_read_tag – API function SYNOPSIS #include <libtasn1.h> int asn1_read_tag(asn1_node root, const char * name, int * tagValue, int * classValue); ARGUMENTS asn1_node root pointer to a structure const char * name the name of the element inside a structure. int * tagValue variable that will contain the TAG value. int * classValue variable that…

NAME asn1_read_node_value – API function SYNOPSIS #include <libtasn1.h> int asn1_read_node_value(asn1_node node, asn1_data_node_st * data); ARGUMENTS asn1_node node pointer to a node. asn1_data_node_st * data a point to a asn1_data_node_st DESCRIPTION Returns the value a data node inside a asn1_node structure. The data returned should be handled as constant values. RETURNS ASN1_SUCCESS if the node exists….

NAME asn1_print_structure – API function SYNOPSIS #include <libtasn1.h> void asn1_print_structure(FILE * out, asn1_node structure, const char * name, int mode); ARGUMENTS FILE * out pointer to the output file (e.g. stdout). asn1_node structure pointer to the structure that you want to visit. const char * name an element of the structure int mode specify how…

NAME asn1_perror – API function SYNOPSIS #include <libtasn1.h> void asn1_perror(int error); ARGUMENTS int error is an error returned by a libtasn1 function. DESCRIPTION Prints a string to stderr with a description of an error. This function is like perror(). The only difference is that it accepts an error returned by a libtasn1 function. SINCE 1.6…

NAME asn1_parser2tree – API function SYNOPSIS #include <libtasn1.h> int asn1_parser2tree(const char * file, asn1_node * definitions, char * error_desc); ARGUMENTS const char * file specify the path and the name of file that contains ASN.1 declarations. asn1_node * definitions return the pointer to the structure created from "file" ASN.1 declarations. char * error_desc return the…

NAME asn1_parser2array – API function SYNOPSIS #include <libtasn1.h> int asn1_parser2array(const char * inputFileName, const char * outputFileName, const char * vectorName, char * error_desc); ARGUMENTS const char * inputFileName specify the path and the name of file that contains ASN.1 declarations. const char * outputFileName specify the path and the name of file that will…

NAME asn1_octet_der – API function SYNOPSIS #include <libtasn1.h> void asn1_octet_der(const unsigned char * str, int str_len, unsigned char * der, int * der_len); ARGUMENTS const unsigned char * str the input data. int str_len STR length (str[0]..str[*str_len-1]). unsigned char * der encoded string returned. int * der_len number of meaningful bytes of DER (der[0]..der[der_len-1]). DESCRIPTION…

NAME asn1_number_of_elements – API function SYNOPSIS #include <libtasn1.h> int asn1_number_of_elements(asn1_node element, const char * name, int * num); ARGUMENTS asn1_node element pointer to the root of an ASN1 structure. const char * name the name of a sub-structure of ROOT. int * num pointer to an integer where the result will be stored DESCRIPTION Counts…

NAME asn1_length_der – API function SYNOPSIS #include <libtasn1.h> void asn1_length_der(unsigned long int len, unsigned char * der, int * der_len); ARGUMENTS unsigned long int len value to convert. unsigned char * der buffer to hold the returned encoding (may be NULL). int * der_len number of meaningful bytes of ANS (der[0]..der[der_len-1]). DESCRIPTION Creates the DER…

NAME asn1_get_tag_der – API function SYNOPSIS #include <libtasn1.h> int asn1_get_tag_der(const unsigned char * der, int der_len, unsigned char * cls, int * len, unsigned long * tag); ARGUMENTS const unsigned char * der DER data to decode. int der_len Length of DER data to decode. unsigned char * cls Output variable containing decoded class. int…

NAME asn1_get_octet_der – API function SYNOPSIS #include <libtasn1.h> int asn1_get_octet_der(const unsigned char * der, int der_len, int * ret_len, unsigned char * str, int str_size, int * str_len); ARGUMENTS const unsigned char * der DER data to decode containing the OCTET SEQUENCE. int der_len The length of the der data to decode. int * ret_len…

NAME asn1_get_object_id_der – API function SYNOPSIS #include <libtasn1.h> int asn1_get_object_id_der(const unsigned char * der, int der_len, int * ret_len, char * str, int str_size); ARGUMENTS const unsigned char * der DER data to decode containing the OBJECT IDENTIFIER int der_len Length of DER data to decode. int * ret_len Output variable containing the length of…

NAME asn1_get_length_der – API function SYNOPSIS #include <libtasn1.h> long asn1_get_length_der(const unsigned char * der, int der_len, int * len); ARGUMENTS const unsigned char * der DER data to decode. int der_len Length of DER data to decode. int * len Output variable containing the length of the DER length field. DESCRIPTION Extract a length field…

NAME asn1_get_length_ber – API function SYNOPSIS #include <libtasn1.h> long asn1_get_length_ber(const unsigned char * ber, int ber_len, int * len); ARGUMENTS const unsigned char * ber BER data to decode. int ber_len Length of BER data to decode. int * len Output variable containing the length of the BER length field. DESCRIPTION Extract a length field…

NAME asn1_get_bit_der – API function SYNOPSIS #include <libtasn1.h> int asn1_get_bit_der(const unsigned char * der, int der_len, int * ret_len, unsigned char * str, int str_size, int * bit_len); ARGUMENTS const unsigned char * der DER data to decode containing the BIT SEQUENCE. int der_len Length of DER data to decode. int * ret_len Output variable…