Imported Upstream version 4.8upstream/4.8submit/upstream/20160613.071414

Change-Id: I25e57ece28b9ebb637a2b7356f57e11b7f2eb807
Signed-off-by: sangsu <sangsu.choi@samsung.com>

1 files changed, 55 insertions, 0 deletions

diff --git a/doc/texi/ASN1.c.texi b/doc/texi/ASN1.c.texi
new file mode 100644
index 0000000..5b6b08a
--- /dev/null
+++ b/doc/texi/ASN1.c.texi
@@ -0,0 +1,55 @@
+@subheading asn1_parser2tree
+@anchor{asn1_parser2tree}
+@deftypefun {int} {asn1_parser2tree} (const char * @var{file}, asn1_node * @var{definitions}, char * @var{error_desc})
+@var{file}: specify the path and the name of file that contains
+ASN.1 declarations.
+
+@var{definitions}: return the pointer to the structure created from
+"file" ASN.1 declarations.
+
+@var{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  @code{file} file.
+
+@strong{Returns:} @code{ASN1_SUCCESS}  if the file has a correct syntax and every
+identifier is known, @code{ASN1_ELEMENT_NOT_EMPTY}  if  @code{definitions} not
+@code{NULL} , @code{ASN1_FILE_NOT_FOUND}  if an error occured while
+opening  @code{file} , @code{ASN1_SYNTAX_ERROR}  if the syntax is not
+correct, @code{ASN1_IDENTIFIER_NOT_FOUND}  if in the file there is an
+identifier that is not defined, @code{ASN1_NAME_TOO_LONG}  if in the
+file there is an identifier whith more than @code{ASN1_MAX_NAME_SIZE} 
+characters.
+@end deftypefun
+
+@subheading asn1_parser2array
+@anchor{asn1_parser2array}
+@deftypefun {int} {asn1_parser2array} (const char * @var{inputFileName}, const char * @var{outputFileName}, const char * @var{vectorName}, char * @var{error_desc})
+@var{inputFileName}: specify the path and the name of file that
+contains ASN.1 declarations.
+
+@var{outputFileName}: specify the path and the name of file that will
+contain the C vector definition.
+
+@var{vectorName}: specify the name of the C vector.
+
+@var{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  @code{inputFileName} file. If  @code{inputFileName} is
+"/aa/bb/xx.yy" and  @code{outputFileName} is @code{NULL} , the file created is
+"/aa/bb/xx_asn1_tab.c".  If  @code{vectorName} is @code{NULL}  the vector name
+will be "xx_asn1_tab".
+
+@strong{Returns:} @code{ASN1_SUCCESS}  if the file has a correct syntax and every
+identifier is known, @code{ASN1_FILE_NOT_FOUND}  if an error occured
+while opening  @code{inputFileName} , @code{ASN1_SYNTAX_ERROR}  if the syntax is
+not correct, @code{ASN1_IDENTIFIER_NOT_FOUND}  if in the file there is
+an identifier that is not defined, @code{ASN1_NAME_TOO_LONG}  if in the
+file there is an identifier whith more than @code{ASN1_MAX_NAME_SIZE} 
+characters.
+@end deftypefun
+