| commit | 80fd3065f4868c5a9c6afe493391a45558ed8463 | [log] [tgz] |
|---|---|---|
| author | Bi-Ruei, Chiu <biruei.chiu@gmail.com> | Sun May 07 21:00:51 2017 +0800 |
| committer | Bi-Ruei, Chiu <biruei.chiu@gmail.com> | Sun May 07 22:20:30 2017 +0800 |
| tree | 9fc270cb66040f96a172437010156e88c3f566c7 | |
| parent | 4021e4ba623b2885a8c859379bc858644c2e1d34 [diff] |
Merge PR99 and its fixes to support parsing Information Object and Information Object Set This is a collection of works : 1. Based on @zhanglei002's pull request 99. 2. A fix by @AuthenticEshkinKot and merged by @mouse07410 at commit 2c8d366bbe1fc4e4c041e9b0eb9779f8a42d754b of https://github.com/mouse07410/asn1c to support parsing of Information Object and Information Object Set 3. A fix by @Uri Blumenthal in asn1fix_derefv.c at : commit ec0ade4f87c807e763e3f35fc5466adb6dda3473 of https://github.com/mouse07410/asn1c to solve crash on asn1p_value_free(). 4. My pull request 18 to @mouse07410's https://github.com/mouse07410/asn1c to solve problems found during parsing ASN.1 modules of S1AP, RANAP and J2735-201603. 5. My pull request 22 to @mouse07410's https://github.com/mouse07410/asn1c to solve issue 147 and to solve the problem during parsing ASN.1 module of NBAP. 6. My pull request 23 to @mouse07410's https://github.com/mouse07410/asn1c to fix memory leakage introduced in aforementioned commits. Most code changes are the same as pull request 153 to this repository. 7. A fix of my bug in item 6 which result asn1c crash, fixed by @mouse07410.
- libasn1compiler/asn1c_C.c[diff]
- libasn1compiler/asn1c_misc.c[diff]
- libasn1compiler/asn1c_misc.h[diff]
- libasn1compiler/asn1c_save.c[diff]
- libasn1fix/asn1fix.c[diff]
- libasn1fix/asn1fix_constraint.c[diff]
- libasn1fix/asn1fix_cws.c[diff]
- libasn1fix/asn1fix_cws.h[diff]
- libasn1fix/asn1fix_derefv.c[diff]
- libasn1fix/asn1fix_param.c[diff]
- libasn1fix/asn1fix_retrieve.c[diff]
- libasn1fix/asn1fix_value.c[diff]
- libasn1parser/asn1p_class.c[diff]
- libasn1parser/asn1p_class.h[diff]
- libasn1parser/asn1p_constr.c[diff]
- libasn1parser/asn1p_constr.h[diff]
- libasn1parser/asn1p_expr.h[diff]
- libasn1parser/asn1p_l.c[diff]
- libasn1parser/asn1p_ref.c[diff]
- libasn1parser/asn1p_ref.h[diff]
- libasn1parser/asn1p_value.c[diff]
- libasn1parser/asn1p_y.c[diff]
- libasn1parser/asn1p_y.y[diff]
- libasn1parser/asn1parser.h[diff]
- asn1c/
- doc/
- examples/
- libasn1compiler/
- libasn1fix/
- libasn1parser/
- libasn1print/
- m4/
- skeletons/
- tests/
- .clang-format
- .gitignore
- .travis.yml
- AUTHORS
- BUGS
- ChangeLog
- config.sub
- configure.ac
- depcomp
- FAQ
- INSTALL.md
- LICENSE
- Makefile.am
- README.md
- REQUIREMENTS.md
- stamp-h.in
- TODO
About
ASN.1 to C compiler takes the ASN.1 module files (example) and generates the C++ compatible C source code. That code can be used to serialize the native C structures into compact and unambiguous BER/XER/PER-based data files, and deserialize the files back.
Various ASN.1 based formats are widely used in the industry, such as to encode the X.509 certificates employed in the HTTPS handshake, to exchange control data between mobile phones and cellular networks, to car-to-car communication in intelligent transportation networks.
The ASN.1 standard is large and complex and no open source compiler supports it in its entirety. The asn1c is arguably the most evolved open source ASN.1 compiler.
Build and Install
If you haven't installed the asn1c yet, read the INSTALL.md file for a short installation guide.
Documentation
For the list of asn1c command line options, see asn1c -h or man asn1c.
The comprehensive documentation on this compiler is in doc/asn1c-usage.pdf.
Please also read the FAQ file.
An excellent book on ASN.1 is written by Olivier Dubuisson: "ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0.
Quick start
(also check out doc/asn1c-quick.pdf)
After installing the compiler (see INSTALL.md), you may use the asn1c command to compile the ASN.1 specification:
asn1c <module.asn1> # Compile module
If several specifications contain interdependencies, all of them must be specified at the same time:
asn1c <module1.asn1> <module2.asn1> ... # Compile interdependent modules
The asn1c source tarball contains the examples/ directory with several ASN.1 modules and a script to extract the ASN.1 modules from RFC documents. Refer to the examples/README file in that directory.
To compile the X.509 PKI module:
./asn1c/asn1c -P ./examples/rfc3280-*.asn1 # Compile-n-print
In this example, the -P option is to print the compiled text on the standard output. The default behavior is that asn1c compiler creates multiple .c and .h files for every ASN.1 type found inside the specified ASN.1 modules.
The compiler's -E and -EF options are used for testing the parser and the semantic fixer, respectively. These options will instruct the compiler to dump out the parsed (and fixed) ASN.1 specification as it was "understood" by the compiler. It might be useful for checking whether a particular syntactic construction is properly supported by the compiler.
asn1c -EF <module-to-test.asn1> # Check semantic validity
Model of operation
The asn1c compiler works by processing the ASN.1 module specifications in several stages:
- During the first stage, the ASN.1 file is parsed. (Parsing produces an ASN.1 syntax tree for the subsequent levels)
- During the second stage, the syntax tree is "fixed". (Fixing is a process of checking the tree for semantic errors, accompanied by the tree transformation into the canonical form)
- During the third stage, the syntax tree is compiled into the target language.
There are several command-line options reserved for printing the results after each stage of operation:
<parser> => print (-E) <parser> => <fixer> => print (-E -F) <parser> => <fixer> => <compiler> => print (-P) <parser> => <fixer> => <compiler> => save-compiled [default]
-- Lev Walkin vlm@lionet.info