asn1c (Lev Walkin) extended with features required by MAP/TCAP
Go to file
Johannes Lode 9925dbbda8 Improve test coverage by using stderr output in test evaluation of parser and AST testing. 2021-04-17 15:08:07 -07:00
asn1-tools fix the rest of type conversions for printing 2019-01-27 13:24:45 -08:00
asn1c moved unber and enber into asn1-tools 2019-01-21 17:00:36 -08:00
doc Update asn1c-usage.tex 2020-07-06 23:45:12 -07:00
examples Fix usage cmd in README of examples/sample.source.LDAP3 2019-09-27 21:53:26 -07:00
libasn1common add stdarg 2019-02-10 01:13:48 -08:00
libasn1compiler Remove compiler warning about misleading indention. 2021-04-17 15:08:07 -07:00
libasn1fix fix library dependency management 2017-11-21 07:18:17 +00:00
libasn1parser libs fix 2017-11-20 23:10:30 -08:00
libasn1print removed gcc-7 warnings 2017-10-19 03:07:27 -07:00
m4 add options to readme 2017-10-19 04:18:12 -07:00
skeletons docs: fix simple typo, occured -> occurred 2021-04-17 15:02:10 -07:00
tests Improve test coverage by using stderr output in test evaluation of parser and AST testing. 2021-04-17 15:08:07 -07:00
.clang-format clang-format config with my preferred style 2016-01-23 09:00:58 -08:00
.gitignore [unber] fix buffer overrun in the BER introspection and debugging tool (unber) 2019-01-21 23:46:19 -08:00
.travis.yml allow fully default flags for distcheck 2017-10-19 03:45:21 -07:00
AUTHORS Added contributor 2020-07-06 23:50:32 -07:00
BUGS BIT STRING identifiers is not a problem 2005-02-28 15:35:27 +00:00
ChangeLog Fix XER decoder of INTEGER, Issue #344. 2019-08-10 20:09:25 -07:00
FAQ comments added to highlight transfer syntax compatibility 2017-09-12 11:07:06 -07:00
INSTALL.md add options to readme 2017-10-19 04:18:12 -07:00
LICENSE copyright info 2017-03-26 03:16:05 -07:00
Makefile.am moved unber and enber into asn1-tools 2019-01-21 17:00:36 -08:00
README.md lang fixes 2017-09-06 10:56:57 -07:00
REQUIREMENTS.md recommend 64-bit 2017-10-02 01:27:09 -07:00
configure.ac moved unber and enber into asn1-tools 2019-01-21 17:00:36 -08:00

README.md

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/OER/PER/XER-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 perform car-to-car communication in intelligent transportation networks.

The ASN.1 family of standards 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.

ASN.1 Transfer Syntaxes

ASN.1 encodings interoperability table

The ASN.1 family of standards define a number of ways to encode data, including byte-oriented (e.g., BER), bit-oriented (e.g., PER), and textual (e.g., XER). Some encoding variants (e.g., DER) are just stricter variants of the more general encodings (e.g., BER).

The interoperability table below specifies which API functions can be used to exchange data in a compatible manner. If you need to produce data conforming to the standard specified in the column 1, use the API function in the column 2. If you need to process data conforming to the standard(s) specified in the column 3, use the API function specified in column 4. See the doc/asn1c-usage.pdf for details.

Encoding API function Understood by API function
BER der_encode() BER ber_decode()
DER der_encode() DER, BER ber_decode()
CER not supported CER, BER ber_decode()
BASIC-OER oer_encode() *-OER oer_decode()
CANONICAL-OER oer_encode() *-OER oer_decode()
BASIC-UPER uper_encode() *-UPER uper_decode()
CANONICAL-UPER uper_encode() *-UPER uper_decode()
*-APER not supported *-APER not supported
BASIC-XER xer_encode(XER_F_BASIC) *-XER xer_decode()
CANONICAL-XER xer_encode(XER_F_CANONICAL) *-XER xer_decode()

*) Asterisk means both BASIC and CANONICAL variants.

Build and Install

If you haven't installed the asn1c yet, read the INSTALL.md file for a short installation guide.

Build Status

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:

  1. During the first stage, the ASN.1 file is parsed. (Parsing produces an ASN.1 syntax tree for the subsequent levels)
  2. 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)
  3. 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