| .de Id |
| .. |
| .Id $Id" |
| .TH ASN1C 1 "\*(Dt" "ASN.1 Compiler" "ASN.1 Compiler" |
| .SH NAME |
| asn1c \- ASN.1 Compiler |
| .SH SYNOPSIS |
| asn1c [\fB\-E\fR [\fB-F\fR] | \fB\-P\fR | \fB\-R\fR] |
| [\fB\-S\fR\fIdir\fR] |
| [\fB\-W\fR\fIdebug-\fR...] [\fB\-f\fR\fIoption\fR...] [\fB\-p\fR\fIrint-\fR...] |
| \fIinfile\fR... |
| .SH DESCRIPTION |
| asn1c compiles the ASN.1 specifications into the set of |
| target language (C/C++) encoders and decoders for BER, DER, |
| and other encoding standards. |
| .SH OPTIONS |
| .TP |
| \fIOverall Options\fR |
| \fB\-E \-F \-P \-R\fR |
| .BI "\-S " directory |
| .TP |
| \fIWarning Options\fR |
| .br |
| \fB\-Werror \-Wdebug-lexer \-Wdebug-fixer \-Wdebug-compiler\fR |
| .TP |
| \fILanguage Options\fR |
| .br |
| \fB\-fall-defs-global \-fbless-SIZE \-fnative-types \-funnamed-unions \-ftypes88\fR |
| .TP |
| \fIOutput Options\fR |
| .br |
| .B \-print-constraints \-print-lines |
| .SH OVERALL OPTIONS |
| .TP |
| .B \-E |
| Stop after the parsing stage and print the reconstructed ASN.1 |
| specification code to the standard output. |
| .TP |
| .B \-F |
| Used together with \c |
| .B \-E\c |
| , instructs the compiler to stop after the ASN.1 syntax |
| tree fixing stage and dump the reconstructed ASN.1 specification |
| to the standard output. |
| .TP |
| .B \-P |
| Dump the compiled output to the standard output instead of creating the |
| target language files on disk. |
| .TP |
| .B \-R |
| Restrict the compiler to generate only the ASN.1 tables, |
| omitting the usual support code. |
| .TP |
| \fB\-S\fR \fIdirectory\fR |
| Use the specified directory with ASN.1 skeleton files. |
| .SH WARNING OPTIONS |
| .TP |
| .B \-Werror |
| Treat warnings as errors; abort if any warning is produced. |
| .TP |
| .B \-Wdebug-lexer |
| Enable lexer debugging during the ASN.1 parsing stage. |
| .TP |
| .B \-Wdebug-fixer |
| Enable ASN.1 syntax tree fixer debugging during the fixing stage. |
| .TP |
| .B \-Wdebug-compiler |
| Enable debugging during the actual compile time. |
| .SH LANGUAGE OPTIONS |
| .TP |
| .B \-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. |
| Enabling 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. |
| .TP |
| .B \-fbless-SIZE |
| Allow SIZE() constraint for INTEGER, ENUMERATED, and other types for which this |
| constraint is normally prohibited by the standard. This is a violation of |
| an ASN.1 standard and compiler may fail to produce the meaningful code. |
| .TP |
| .B \-fnative-types |
| Use the native machine's data types (int, double) whenever possible, |
| instead of the compound ASN.1 INTEGER_t, ENUMERATED_t and REAL_t types. |
| .TP |
| .B \-funnamed-unions |
| Enable unnamed unions in the definitions of target language's structures. |
| .TP |
| .B \-ftypes88 |
| Use only ASN.1:1988 embedded types. |
| .SH OUTPUT OPTIONS |
| .TP |
| .B \-print-constraints |
| When -EF are also specified, this option forces the compiler to explain |
| its internal understanding of subtype constraints. |
| .TP |
| .B \-print-lines |
| Generate "-- #line" comments in \fB-E\fR output. |
| .SH SEE ALSO |
| .TP |
| \&\fIunber\fR\|(1) |
| .SH AUTHORS |
| Lev Walkin <vlm@lionet.info> |