Section 3: library functions
NAME asn1_find_structure_from_oid – API function SYNOPSIS #include <libtasn1.h> const char * asn1_find_structure_from_oid(asn1_node definitions, const char * oidValue); ARGUMENTS asn1_node definitions ASN1 definitions const char * oidValue value of the OID to search (e.g. "1.2.3.4"). DESCRIPTION Search the structure that is defined just after an OID definition. RETURNS NULL when oidValue not found, otherwise the pointer…
NAME asn1_find_node – API function SYNOPSIS #include <libtasn1.h> asn1_node asn1_find_node(asn1_node pointer, const char * name); ARGUMENTS asn1_node pointer NODE_ASN element pointer. const char * name null terminated string with the element’s name to find. DESCRIPTION Searches for an element called name starting from pointer . The name is composed by differents identifiers separated by dots….
NAME asn1_expand_octet_string – API function SYNOPSIS #include <libtasn1.h> int asn1_expand_octet_string(asn1_node definitions, asn1_node * element, const char * octetName, const char * objectName); ARGUMENTS asn1_node definitions ASN1 definitions asn1_node * element pointer to an ASN1 structure const char * octetName name of the OCTECT STRING field to expand. const char * objectName name of the OBJECT…
NAME asn1_expand_any_defined_by – API function SYNOPSIS #include <libtasn1.h> int asn1_expand_any_defined_by(asn1_node definitions, asn1_node * element); ARGUMENTS asn1_node definitions ASN1 definitions asn1_node * element pointer to an ASN1 structure DESCRIPTION Expands every "ANY DEFINED BY" element of a structure created from a DER decoding process (asn1_der_decoding function). The element ANY must be defined by an OBJECT IDENTIFIER….
NAME asn1_encode_simple_der – API function SYNOPSIS #include <libtasn1.h> int asn1_encode_simple_der(unsigned int etype, const unsigned char * str, unsigned int str_len, unsigned char * tl, unsigned int * tl_len); ARGUMENTS unsigned int etype The type of the string to be encoded (ASN1_ETYPE_) const unsigned char * str the string data. unsigned int str_len the string length…
NAME asn1_dup_node – API function SYNOPSIS #include <libtasn1.h> asn1_node asn1_dup_node(asn1_node src, const char * src_name); ARGUMENTS asn1_node src Source asn1 node. const char * src_name Field name in source node. DESCRIPTION Create a deep copy of a asn1_node variable. This function will return an exact copy of the provided structure. RETURNS Return NULL on failure….
asn1_der_decoding_startEnd – API function Synopsis #include <libtasn1.h> int asn1_der_decoding_startEnd(asn1_node element, const void * ider, int ider_len, const char * name_element, int * start, int * end); Arguments asn1_node element pointer to an ASN1 element const void * ider vector that contains the DER encoding. int ider_len number of bytes of * ider : ider [0]…..
NAME asn1_der_decoding_element – API function SYNOPSIS #include <libtasn1.h> int asn1_der_decoding_element(asn1_node * structure, const char * elementName, const void * ider, int len, char * errorDescription); ARGUMENTS asn1_node * structure pointer to an ASN1 structure const char * elementName name of the element to fill const void * ider vector that contains the DER encoding of…
NAME asn1_der_decoding2 – API function SYNOPSIS #include <libtasn1.h> int asn1_der_decoding2(asn1_node * element, const void * ider, int * max_ider_len, unsigned int flags, char * errorDescription); ARGUMENTS asn1_node * element pointer to an ASN1 structure. const void * ider vector that contains the DER encoding. int * max_ider_len pointer to an integer giving the information about…
NAME asn1_der_decoding – API function SYNOPSIS #include <libtasn1.h> int asn1_der_decoding(asn1_node * element, const void * ider, int ider_len, char * errorDescription); ARGUMENTS asn1_node * element pointer to an ASN1 structure. const void * ider vector that contains the DER encoding. int ider_len number of bytes of * ider : ider [0].. ider [len-1]. char *…
NAME asn1_der_coding – API function SYNOPSIS #include <libtasn1.h> int asn1_der_coding(asn1_node element, const char * name, void * ider, int * len, char * ErrorDescription); ARGUMENTS asn1_node element pointer to an ASN1 element const char * name the name of the structure you want to encode (it must be inside *POINTER). void * ider vector that…
NAME asn1_delete_structure2 – API function SYNOPSIS #include <libtasn1.h> int asn1_delete_structure2(asn1_node * structure, unsigned int flags); ARGUMENTS asn1_node * structure pointer to the structure that you want to delete. unsigned int flags additional flags (see ASN1_DELETE_FLAG) DESCRIPTION Deletes the structure * structure . At the end, * structure is set to NULL. RETURNS ASN1_SUCCESS if successful,…
NAME asn1_delete_structure – API function SYNOPSIS #include <libtasn1.h> int asn1_delete_structure(asn1_node * structure); ARGUMENTS asn1_node * structure pointer to the structure that you want to delete. DESCRIPTION Deletes the structure * structure . At the end, * structure is set to NULL. RETURNS ASN1_SUCCESS if successful, ASN1_ELEMENT_NOT_FOUND if * structure was NULL. COPYRIGHT Copyright © 2006-2015…
NAME asn1_delete_element – API function SYNOPSIS #include <libtasn1.h> int asn1_delete_element(asn1_node structure, const char * element_name); ARGUMENTS asn1_node structure pointer to the structure that contains the element you want to delete. const char * element_name element’s name you want to delete. DESCRIPTION Deletes the element named * element_name inside * structure . RETURNS ASN1_SUCCESS if successful,…
NAME asn1_decode_simple_der – API function SYNOPSIS #include <libtasn1.h> int asn1_decode_simple_der(unsigned int etype, const unsigned char * der, unsigned int _der_len, const unsigned char ** str, unsigned int * str_len); ARGUMENTS unsigned int etype The type of the string to be encoded (ASN1_ETYPE_) const unsigned char * der the encoded string unsigned int _der_len the bytes…
NAME asn1_decode_simple_ber – API function SYNOPSIS #include <libtasn1.h> int asn1_decode_simple_ber(unsigned int etype, const unsigned char * der, unsigned int _der_len, unsigned char ** str, unsigned int * str_len, unsigned int * ber_len); ARGUMENTS unsigned int etype The type of the string to be encoded (ASN1_ETYPE_) const unsigned char * der the encoded string unsigned int…
NAME asn1_create_element – API function SYNOPSIS #include <libtasn1.h> int asn1_create_element(asn1_node definitions, const char * source_name, asn1_node * element); ARGUMENTS asn1_node definitions pointer to the structure returned by "parser_asn1" function const char * source_name the name of the type of the new structure (must be inside p_structure). asn1_node * element pointer to the structure created. DESCRIPTION…
NAME asn1_copy_node – API function SYNOPSIS #include <libtasn1.h> int asn1_copy_node(asn1_node dst, const char * dst_name, asn1_node src, const char * src_name); ARGUMENTS asn1_node dst Destination asn1 node. const char * dst_name Field name in destination node. asn1_node src Source asn1 node. const char * src_name Field name in source node. DESCRIPTION Create a deep copy…
NAME asn1_check_version – API function SYNOPSIS #include <libtasn1.h> const char * asn1_check_version(const char * req_version); ARGUMENTS const char * req_version Required version number, or NULL. DESCRIPTION Check that the version of the library is at minimum the requested one and return the version string; return NULL if the condition is not satisfied. If a NULL…
NAME asn1_bit_der – API function SYNOPSIS #include <libtasn1.h> void asn1_bit_der(const unsigned char * str, int bit_len, unsigned char * der, int * der_len); ARGUMENTS const unsigned char * str BIT string. int bit_len number of meaningful bits in STR. unsigned char * der string returned. int * der_len number of meaningful bytes of DER (der[0]..der[ans_len-1])….