ASN1C(1)			ASN.1 Compiler			      ASN1C(1)

NAME

       asn1c - ASN.1 Compiler

SYNOPSIS

       asn1c [-E [-F] | -P | -R]
	     [-Sdir] [-X]
	     [-Wdebug-...] [-foption] [-gen-option] [-print-option]
	     infile...

DESCRIPTION

       asn1c  compiles	ASN.1  specifications  into  a	set of target language
       (C/C++) encoders and decoders for BER,  DER,  XER  and  other  encoding
       standards.

OPTIONS

       Overall Options
	      -E -F -P -R -S directory -X

       Warning Options
	      -Werror -Wdebug-lexer -Wdebug-fixer -Wdebug-compiler

       Language Options
	      -fall-defs-global   -fbless-SIZE	 -fcompound-names  -findirect-
	      choice   -fknown-extern-type=<name>   -fnative-types   -fno-con-
	      straints -fno-include-deps -funnamed-unions -fskeletons-copy

       Codecs Generation Options
	      -gen-PER

       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

       -fall-defs-global
	      Normally	the  compiler  hides the definitions (asn1_DEF_xxx) of
	      the inner structure elements (members of SEQUENCE, SET and other
	      types).  This  option  makes all such definitions global.  Using
	      this  option  may  pollute  the  namespace  by  making  lots  of
	      asn1_DEF_xxx  structures globally visible, but will allow you to
	      manipulate (encode and decode) the  individual  members  of  any
	      complex ASN.1 structure.

       -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.

       -fnative-types
	      Use the native machine's data types (int, double) whenever  pos-
	      sible,  instead  of  the	compound  INTEGER_t,  ENUMERATED_t and
	      REAL_t types.

       -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.

       -fskeletons-copy
	      Copy support files (skeletons) rather than symlink them.

CODECS GENERATION OPTIONS

       -gen-PER
	      Generate Packed Encoding Rules (PER) support code.

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)