4.1 ASN.1 schema functions

asn1_parser2tree

Function: int asn1_parser2tree (const char * file, asn1_node * definitions, char * error_desc)

file: specify the path and the name of file that contains ASN.1 declarations.

definitions: return the pointer to the structure created from "file" ASN.1 declarations.

error_desc: return the error description or an empty string if success.

Function used to start the parse algorithm. Creates the structures needed to manage the definitions included in file file.

Returns: ASN1_SUCCESS if the file has a correct syntax and every identifier is known, ASN1_ELEMENT_NOT_EMPTY if definitions not NULL , ASN1_FILE_NOT_FOUND if an error occurred while opening file , ASN1_SYNTAX_ERROR if the syntax is not correct, ASN1_IDENTIFIER_NOT_FOUND if in the file there is an identifier that is not defined, ASN1_NAME_TOO_LONG if in the file there is an identifier with more than ASN1_MAX_NAME_SIZE characters.

asn1_parser2array

Function: int asn1_parser2array (const char * inputFileName, const char * outputFileName, const char * vectorName, char * error_desc)

inputFileName: specify the path and the name of file that contains ASN.1 declarations.

outputFileName: specify the path and the name of file that will contain the C vector definition.

vectorName: specify the name of the C vector.

error_desc: return the error description or an empty string if success.

Function that generates a C structure from an ASN1 file. Creates a file containing a C vector to use to manage the definitions included in inputFileName file. If inputFileName is "/aa/bb/xx.yy" and outputFileName is NULL , the file created is "/aa/bb/xx_asn1_tab.c". If vectorName is NULL the vector name will be "xx_asn1_tab".

Returns: ASN1_SUCCESS if the file has a correct syntax and every identifier is known, ASN1_FILE_NOT_FOUND if an error occurred while opening inputFileName , ASN1_SYNTAX_ERROR if the syntax is not correct, ASN1_IDENTIFIER_NOT_FOUND if in the file there is an identifier that is not defined, ASN1_NAME_TOO_LONG if in the file there is an identifier with more than ASN1_MAX_NAME_SIZE characters.