Commit f16d60b7 authored by Lev Walkin's avatar Lev Walkin

added reference to FAQ

parent e057ca34
...@@ -6,22 +6,23 @@ For quick installation tips read INSTALL. ...@@ -6,22 +6,23 @@ For quick installation tips read INSTALL.
For more complete documentation on this compiler and on using the For more complete documentation on this compiler and on using the
results of compilation please look into ./doc directory. results of compilation please look into ./doc directory.
Please also read the FAQ file.
An excellent book on ASN.1 is written by Olivier Dubuisson: An excellent book on ASN.1 is written by Olivier Dubuisson:
"ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0. "ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0.
QUICK START QUICK START
=========== ===========
After building [and installing] the compiler (see INSTALL), you may use After building [and installing] the compiler (see INSTALL), you may use
the asn1c command to compile the ASN.1 specification: the asn1c command to compile the ASN.1 specification:
asn1c <spec.asn1> asn1c <module.asn1>
If several specifications contain interdependencies, all of them must be If several specifications contain interdependencies, all of them must be
specified: specified:
asn1c <spec1.asn1> <spec2.asn1> ... asn1c <module1.asn1> <module2.asn1> ...
The ./examples directory contains several ASN.1 modules and a script to The ./examples directory contains several ASN.1 modules and a script to
extract ASN.1 modules from RFC documents. To compile X.509 PKI module: extract ASN.1 modules from RFC documents. To compile X.509 PKI module:
...@@ -30,8 +31,8 @@ extract ASN.1 modules from RFC documents. To compile X.509 PKI module: ...@@ -30,8 +31,8 @@ extract ASN.1 modules from RFC documents. To compile X.509 PKI module:
In this example, -P option is used to instruct the compiler to print the In this example, -P option is used to instruct the compiler to print the
compiled text on the standard output instead of creating multiple .c compiled text on the standard output instead of creating multiple .c
and .h files for every ASN.1 type found inside the specified files. and .h files for every ASN.1 type found inside the specified ASN.1 modules.
This is useful for debugging and tests automation. This is useful for debugging and test automation.
The compiler -E and -EF options are used for testing the parser and The compiler -E and -EF options are used for testing the parser and
the semantic fixer, respectively. These options will instruct the compiler the semantic fixer, respectively. These options will instruct the compiler
...@@ -40,7 +41,7 @@ to dump out the parsed (and fixed) ASN.1 specification as it was ...@@ -40,7 +41,7 @@ to dump out the parsed (and fixed) ASN.1 specification as it was
whether a particular syntactic construction is properly supported whether a particular syntactic construction is properly supported
by the compiler. by the compiler.
asn1c -EF <spec-to-test.asn1> asn1c -EF <module-to-test.asn1>
MODEL OF OPERATION MODEL OF OPERATION
...@@ -49,10 +50,10 @@ MODEL OF OPERATION ...@@ -49,10 +50,10 @@ MODEL OF OPERATION
The asn1c compiler works by processing the ASN.1 module specification The asn1c compiler works by processing the ASN.1 module specification
in several stages: in several stages:
1. In the first stage, the ASN.1 file is parsed. 1. In the first stage, the ASN.1 file is parsed.
(Parsing produces an ASN.1 syntax tree for the subsequent levels.) (Parsing produces an ASN.1 syntax tree for the subsequent levels)
2. In the second stage, the syntax tree is "fixed". 2. In the second stage, the syntax tree is "fixed".
(Fixing is done by checking the tree for semantic errors (Fixing is a process of checking the tree for semantic errors,
and by transforming the tree into the canonical representation.) accompanied by the tree transformation into the canonical form)
3. In the third stage, the syntax tree is compiled into the target language. 3. In the third stage, the syntax tree is compiled into the target language.
There are several command-line options reserved for printing the results There are several command-line options reserved for printing the results
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment