ASN1C(1) ASN.1 Compiler ASN1C(1)
NAME
asn1c - ASN.1 Compiler
SYNOPSIS
asn1c [-E [-F] | -P | -R] [-Sdir] [-X] [-Wdebug-...] [-foption] [-gen-option] [-pdu={all|auto|Type}] [-print-option] infile...
DESCRIPTION
asn1c compiles ASN.1 specifications into a set of target language (C/C++) encoders and decoders for BER, DER, PER, XER and other encoding rules.
OPTIONS
Overall Options -E -F -P -R -S directory -X Warning Options -Werror -Wdebug-lexer -Wdebug-fixer -Wdebug-compiler Language Options -fbless-SIZE -fcompound-names -findirect-choice -fknown-extern- type=<name> -fno-constraints -fno-include-deps -funnamed-unions Codecs Generation Options -gen-PER -pdu={all|auto|Type} Output Options -print-constraints -print-lines
OVERALL OPTIONS
-E Stop after the parsing stage and print the reconstructed ASN.1 specification code to the standard output. -F Used together with -E, instructs the compiler to stop after the ASN.1 syntax tree fixing stage and dump the reconstructed ASN.1 specification to the standard output. -P Dump the compiled output to the standard output instead of cre- ating the target language files on disk. -R Restrict the compiler to generate only the ASN.1 tables, omit- ting the usual support code. -S directory Use the specified directory with ASN.1 skeleton files. -X Generate an XML DTD schema for the specified ASN.1 files.
WARNING OPTIONS
-Werror Treat warnings as errors; abort if any warning is produced. -Wdebug-lexer Enable lexer debugging during the ASN.1 parsing stage. -Wdebug-fixer Enable ASN.1 syntax tree fixer debugging during the fixing stage. -Wdebug-compiler Enable debugging during the actual compile time.
LANGUAGE OPTIONS
-fbless-SIZE Allow SIZE() constraint for INTEGER, ENUMERATED, and other types for which this constraint is normally prohibited by the stan- dard. This is a violation of ASN.1 standard, and the compiler may fail to produce a meaningful code. -fcompound-names Using this option prevents name collisions in the target source code by using complex names for target language structures. (Name collisions may occur if the ASN.1 module reuses the same identifiers in multiple contexts). -findirect-choice When generating code for a CHOICE type, compile the CHOICE mem- bers as indirect pointers instead of declaring them inline. Con- sider using this option together with -fno-include-deps to pre- vent circular references. -fknown-extern-type=<name> Pretend the specified type is known. The compiler will assume the target language source files for the given type have been provided manually. -fno-constraints Do not generate ASN.1 subtype constraint checking code. This may make a shorter executable. -fno-include-deps Do not generate courtesy #include lines for non-critical type dependencies. Helps prevent namespace collisions. -funnamed-unions Enable unnamed unions in the definitions of target language's structures.
CODECS GENERATION OPTIONS
-gen-PER Generate Packed Encoding Rules (PER) support code. -pdu={all|auto|Type} Create a PDU table for specified types, or discover Protocol Data Units automatically. In case of -pdu=all, all ASN.1 types defined in all modules will form a PDU table. In case of -pdu=auto, all types not referenced by any other type will form a PDU table. If Type is an ASN.1 type identifier, it is added to a PDU table. The last form may be specified multiple times to add any number of PDUs.
OUTPUT OPTIONS
-print-constraints When -EF are also specified, this option forces the compiler to explain its internal understanding of subtype constraints. -print-lines Generate "-- #line" comments in -E output.
SEE ALSO
unber(1), enber(1)
AUTHORS
Lev Walkin <vlm@lionet.info> ASN.1 Compiler ASN1C(1)