Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
A
asn1c
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Libraries
asn1c
Commits
f47d068a
Commit
f47d068a
authored
Mar 05, 2005
by
Lev Walkin
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
new content
parent
866cff1a
Changes
3
Hide whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
158 additions
and
53 deletions
+158
-53
doc/asn1c-usage.html
doc/asn1c-usage.html
+59
-50
doc/asn1c-usage.lyx
doc/asn1c-usage.lyx
+99
-3
doc/asn1c-usage.pdf
doc/asn1c-usage.pdf
+0
-0
No files found.
doc/asn1c-usage.html
View file @
f47d068a
...
...
@@ -177,7 +177,7 @@ standardized encoding rules (BER, DER, XER).
<P>
For example, suppose the following ASN.1 module is given
<A
NAME=
"tex2html1"
HREF=
"#foot8
18
"
><SUP>
1.1
</SUP></A>
:
HREF=
"#foot8
43
"
><SUP>
1.1
</SUP></A>
:
<P>
...
...
@@ -195,7 +195,7 @@ END
</BLOCKQUOTE>
The compiler would read this ASN.1 definition and produce the following
C type
<A
NAME=
"tex2html2"
HREF=
"#foot8
19
"
><SUP>
1.2
</SUP></A>
:
HREF=
"#foot8
44
"
><SUP>
1.2
</SUP></A>
:
<P>
...
...
@@ -219,8 +219,8 @@ Quick start with asn1c</A>
<P>
After building and installing the compiler, the
<I>
asn1c
</I><A
NAME=
"tex2html3"
HREF=
"#foot8
20
"
><SUP>
1.3
</SUP></A>
command may be used to compile the ASN.1 module
<A
NAME=
"tex2html4"
HREF=
"#foot8
21
"
><SUP>
1.4
</SUP></A>
:
HREF=
"#foot8
45
"
><SUP>
1.3
</SUP></A>
command may be used to compile the ASN.1 module
<A
NAME=
"tex2html4"
HREF=
"#foot8
46
"
><SUP>
1.4
</SUP></A>
:
<P>
...
...
@@ -328,7 +328,7 @@ the compiler's behavior.
<P>
<BR><P></P>
<DIV
ALIGN=
"CENTER"
><A
NAME=
"8
26
"
></A>
<DIV
ALIGN=
"CENTER"
><A
NAME=
"8
51
"
></A>
<TABLE>
<CAPTION><STRONG><A
NAME=
Table1
>
Table 1:
</A></STRONG>
The list of asn1c command line options
</CAPTION>
...
...
@@ -336,92 +336,101 @@ The list of asn1c command line options</CAPTION>
<COLGROUP><COL
ALIGN=
LEFT
><COLGROUP><COL
ALIGN=
JUSTIFY
WIDTH=
"3in"
>
<TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<B>
Overall Options
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
Description
</B></TD></TR>
<B>
<FONT
SIZE=
"-1"
>
Overall Options
</FONT>
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
<FONT
SIZE=
"-1"
>
Description
</FONT>
</B></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-E
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-E
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Stop after the parsing stage and print the reconstructed ASN.1
specification code to the standard output.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-F
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-F
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
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.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-P
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-P
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Dump the compiled output to the standard output instead of
cre- ating the target language files on disk.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-R
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-R
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Restrict the compiler to generate only the ASN.1 tables, omit-
ting the usual support code.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-S
<I>
<
directory
>
</I></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-S
</FONT>
<I><FONT
SIZE=
"-1"
>
<
directory
>
</FONT>
</I></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Use the specified directory with ASN.1 skeleton files.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-X
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
Generate the XML DTD for the specified ASN.1 modules.
</TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-X
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Generate the XML DTD for the specified ASN.1 modules.
</FONT>
</TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
Warning Options
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
Description
</B></TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
<FONT
SIZE=
"-1"
>
Warning Options
</FONT>
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
<FONT
SIZE=
"-1"
>
Description
</FONT>
</B></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-Werror
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-Werror
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Treat warnings as errors; abort if any warning is produced.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-Wdebug-lexer
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-Wdebug-lexer
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Enable lexer debugging during the ASN.1 parsing stage.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-Wdebug-fixer
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-Wdebug-fixer
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Enable ASN.1 syntax tree fixer debugging during the
fixing stage.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-Wdebug-compiler
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-Wdebug-compiler
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Enable debugging during the actual compile time.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
Language Options
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
Description
</B></TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
<FONT
SIZE=
"-1"
>
Language Options
</FONT>
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
<FONT
SIZE=
"-1"
>
Description
</FONT>
</B></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-fall-defs-global
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
Normally the compiler hides the definitions (asn_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 asn_DEF_xxx structures
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-fall-defs-global
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Normally the compiler hides the definitions (asn_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 asn_DEF_xxx structures
globally visible, but will allow you to manipulate (encode and decode)
the individual members of any complex ASN.1 structure.
</TD></TR>
the individual members of any complex ASN.1 structure.
</
FONT></
TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-fbless-SIZE
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-fbless-SIZE
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
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.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-fnative-types
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><FONT
SIZE=
"-1"
>
-fcompound-names
</FONT></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Use complex names for C structures. Using complex names prevents
name clashes in case the module reuses the same identifiers in multiple
contexts.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><FONT
SIZE=
"-1"
>
-fnative-types
</FONT></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Use the native machine's data types (int, double) whenever
possible, instead of the compound INTEGER_t, ENUMERATED_t and REAL_t
types.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-fno-constraints
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
Do not generate ASN.1 subtype constraint checking code. This may make
a shorter executable.
</TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><FONT
SIZE=
"-1"
>
-fno-constraints
</FONT></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Do not generate ASN.1 subtype constraint checking code. This
may produce a shorter executable.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><FONT
SIZE=
"-1"
>
-fno-include-deps
</FONT></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Do not generate courtesy #include lines for non-critical
dependencies.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-funnamed-unions
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-funnamed-unions
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Enable unnamed unions in the definitions of target language's
structures.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-ftypes88
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-ftypes88
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Pretend to support only ASN.1:1988 embedded types. Certain
reserved words, such as UniversalString and BMPString, become ordinary
type references and may be redefined by the specification.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
Output Options
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
Description
</B></TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
><B>
<FONT
SIZE=
"-1"
>
Output Options
</FONT>
</B></TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<B>
<FONT
SIZE=
"-1"
>
Description
</FONT>
</B></TD></TR>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-print-constraints
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
-print-constraints
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
When -EF are also specified, this option forces the compiler
to explain its internal understanding of subtype constraints.
</FONT></TD></TR>
</TBODY><TBODY>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
-print-lines
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<TR><TD
VALIGN=
BASELINE
ALIGN=
LEFT
NOWRAP
>
<FONT
SIZE=
"-1"
>
-print-lines
</FONT>
</TD><TD
VALIGN=
BASELINE
ALIGN=
LEFT
WIDTH=
"216"
>
<FONT
SIZE=
"-1"
>
Generate
"
- #line
"
comments in -E output.
</FONT></TD></TR>
</TBODY>
</TABLE>
...
...
@@ -485,7 +494,7 @@ are of interest:
<DL>
<DT><STRONG>
ber_decoder
</STRONG></DT>
<DD>
This is the generic
<I>
restartable
</I><A
NAME=
"tex2html6"
HREF=
"#foot1
56
"
><SUP>
2.1
</SUP></A>
BER decoder (Basic Encoding Rules). This decoder would create
HREF=
"#foot1
81
"
><SUP>
2.1
</SUP></A>
BER decoder (Basic Encoding Rules). This decoder would create
and/or fill the target structure for you. Please refer to Section
sub:Decoding-BER.
</DD>
...
...
@@ -719,7 +728,7 @@ DER encoder will essentially do the same thing (i.e., encode the data)
but no callbacks will be invoked (so the data goes nowhere). It may
prove useful to determine the size of the structure's encoding before
actually doing the encoding
<A
NAME=
"tex2html7"
HREF=
"#foot2
25
"
><SUP>
2.2
</SUP></A>
.
HREF=
"#foot2
50
"
><SUP>
2.2
</SUP></A>
.
<P>
Please look into der_encoder.h for the precise definition of der_encode()
...
...
@@ -1262,7 +1271,7 @@ END
main() routine shown in the Section
<A
HREF=
"#sec:A-Rectangle-Decoder"
>
A Rectangle Decoder
</A>
)
by placing the following snippet of code
<I>
before
</I>
encoding and/or
<I>
after
</I>
decoding the Rectangle type
<A
NAME=
"tex2html8"
HREF=
"#foot
898
"
><SUP>
4.1
</SUP></A>
:
HREF=
"#foot
923
"
><SUP>
4.1
</SUP></A>
:
<P>
...
...
@@ -1732,44 +1741,44 @@ ISBN:0-12-6333361-0.
<P>
<BR><HR><H4>
Footnotes
</H4>
<DL>
<DT><A
NAME=
"foot8
18
"
>
... given
</A><A
<DT><A
NAME=
"foot8
43
"
>
... given
</A><A
HREF=
"asn1c-usage.html#tex2html1"
><SUP>
1.1
</SUP></A></DT>
<DD>
Please look into Part par:ASN.1-Basics for a quick reference
on how to understand the ASN.1 notation.
</DD>
<DT><A
NAME=
"foot8
19
"
>
... type
</A><A
<DT><A
NAME=
"foot8
44
"
>
... type
</A><A
HREF=
"asn1c-usage.html#tex2html2"
><SUP>
1.2
</SUP></A></DT>
<DD><I>
-fnative-types
</I>
compiler option is used to produce basic C
<I>
int
</I>
types instead of infinite width INTEGER_t structures. See
<A
HREF=
#Table1
>
Table 1
</A>
.
</DD>
<DT><A
NAME=
"foot8
20
"
>
...asn1c
</A><A
<DT><A
NAME=
"foot8
45
"
>
...asn1c
</A><A
HREF=
"asn1c-usage.html#tex2html3"
><SUP>
1.3
</SUP></A></DT>
<DD>
The 1 symbol in asn
<B>
1
</B>
c is a digit, not an ''ell'' letter.
</DD>
<DT><A
NAME=
"foot8
21
"
>
... module
</A><A
<DT><A
NAME=
"foot8
46
"
>
... module
</A><A
HREF=
"asn1c-usage.html#tex2html4"
><SUP>
1.4
</SUP></A></DT>
<DD>
This is probably
<B>
not
</B>
what you want to try out right now -
read through the rest of this chapter and check the
<A
HREF=
#Table1
>
Table 1
</A>
to find out about
<B>
-P
</B>
and
<B>
-R
</B>
options.
</DD>
<DT><A
NAME=
"foot1
56
"
>
...restartable
</A><A
<DT><A
NAME=
"foot1
81
"
>
...restartable
</A><A
HREF=
"asn1c-usage.html#tex2html6"
><SUP>
2.1
</SUP></A></DT>
<DD>
Restartable means that if the decoder encounters the end of the buffer,
it will fail, but may later be invoked again with the rest of the
buffer to continue decoding.
</DD>
<DT><A
NAME=
"foot2
25
"
>
... encoding
</A><A
<DT><A
NAME=
"foot2
50
"
>
... encoding
</A><A
HREF=
"asn1c-usage.html#tex2html7"
><SUP>
2.2
</SUP></A></DT>
<DD>
It is actually faster too: the encoder might skip over some computations
which aren't important for the size determination.
</DD>
<DT><A
NAME=
"foot
898
"
>
... type
</A><A
<DT><A
NAME=
"foot
923
"
>
... type
</A><A
HREF=
"asn1c-usage.html#tex2html8"
><SUP>
4.1
</SUP></A></DT>
<DD>
Placing the constraint checking code
<I>
before
</I>
encoding helps
to make sure you know the data is correct and within constraints before
...
...
@@ -1784,7 +1793,7 @@ the application got the valid contents before making use of it.
</DL><BR><HR>
<ADDRESS>
Lev Walkin
2005-0
2-21
2005-0
3-04
</ADDRESS>
</BODY>
</HTML>
doc/asn1c-usage.lyx
View file @
f47d068a
...
...
@@ -71,7 +71,7 @@ status Open
\backslash
lhead{This document describes
\backslash
href{http://lionet.info/asn1c}{asn1c-0.9.
9
}}
href{http://lionet.info/asn1c}{asn1c-0.9.
11
}}
\layout Standard
\backslash
...
...
@@ -459,7 +459,7 @@ collapsed false
\begin_inset Tabular
<lyxtabular version="3" rows="2
2
" columns="2">
<lyxtabular version="3" rows="2
4
" columns="2">
<features islongtable="true">
<column alignment="left" valignment="top" leftline="true" width="0">
<column alignment="block" valignment="top" leftline="true" rightline="true" width="3in">
...
...
@@ -471,6 +471,7 @@ collapsed false
\series bold
\size small
Overall Options
\end_inset
</cell>
...
...
@@ -481,6 +482,7 @@ Overall Options
\series bold
\size small
Description
\end_inset
</cell>
...
...
@@ -491,6 +493,8 @@ Description
\layout Standard
\size small
-E
\end_inset
</cell>
...
...
@@ -512,6 +516,8 @@ Stop after the parsing stage and print the reconstructed ASN.1 specification
\layout Standard
\size small
-F
\end_inset
</cell>
...
...
@@ -534,6 +540,8 @@ Used together with -E, instructs the compiler to stop after the ASN.1 syntax
\layout Standard
\size small
-P
\end_inset
</cell>
...
...
@@ -555,6 +563,8 @@ Dump the compiled output to the standard output instead of cre- ating the
\layout Standard
\size small
-R
\end_inset
</cell>
...
...
@@ -576,6 +586,8 @@ Restrict the compiler to generate only the ASN.1 tables, omit- ting the usual
\layout Standard
\size small
-S
\emph on
<directory>
...
...
@@ -598,6 +610,8 @@ Use the specified directory with ASN.1 skeleton files.
\layout Standard
\size small
-X
\end_inset
</cell>
...
...
@@ -606,6 +620,8 @@ Use the specified directory with ASN.1 skeleton files.
\layout Standard
\size small
Generate the XML DTD for the specified ASN.1 modules.
\end_inset
</cell>
...
...
@@ -618,6 +634,7 @@ Generate the XML DTD for the specified ASN.1 modules.
\series bold
\size small
Warning Options
\end_inset
</cell>
...
...
@@ -628,6 +645,7 @@ Warning Options
\series bold
\size small
Description
\end_inset
</cell>
...
...
@@ -638,6 +656,8 @@ Description
\layout Standard
\size small
-Werror
\end_inset
</cell>
...
...
@@ -658,6 +678,8 @@ Treat warnings as errors; abort if any warning is produced.
\layout Standard
\size small
-Wdebug-lexer
\end_inset
</cell>
...
...
@@ -678,6 +700,8 @@ Enable lexer debugging during the ASN.1 parsing stage.
\layout Standard
\size small
-Wdebug-fixer
\end_inset
</cell>
...
...
@@ -698,6 +722,8 @@ Enable lexer debugging during the ASN.1 parsing stage.
\layout Standard
\size small
-Wdebug-compiler
\end_inset
</cell>
...
...
@@ -720,6 +746,7 @@ Enable debugging during the actual compile time.
\series bold
\size small
Language Options
\end_inset
</cell>
...
...
@@ -730,6 +757,7 @@ Language Options
\series bold
\size small
Description
\end_inset
</cell>
...
...
@@ -740,6 +768,8 @@ Description
\layout Standard
\size small
-fall-defs-global
\end_inset
</cell>
...
...
@@ -748,6 +778,8 @@ Description
\layout Standard
\size small
Normally the compiler hides the definitions (asn_DEF_xxx) of the inner structure
elements (members of SEQUENCE, SET and other types).
This option makes all such definitions global.
...
...
@@ -763,6 +795,8 @@ Normally the compiler hides the definitions (asn_DEF_xxx) of the inner structure
\layout Standard
\size small
-fbless-SIZE
\end_inset
</cell>
...
...
@@ -786,6 +820,32 @@ Allow SIZE() constraint for INTEGER, ENUMERATED, and other types for which
\layout Standard
\size small
-fcompound-names
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\layout Standard
\size small
Use complex names for C structures.
Using complex names prevents name clashes in case the module reuses the
same identifiers in multiple contexts.
\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\layout Standard
\size small
-fnative-types
\end_inset
</cell>
...
...
@@ -808,6 +868,8 @@ Use the native machine's data types (int, double) whenever possible, instead
\layout Standard
\size small
-fno-constraints
\end_inset
</cell>
...
...
@@ -816,8 +878,10 @@ Use the native machine's data types (int, double) whenever possible, instead
\layout Standard
\size small
Do not generate ASN.1 subtype constraint checking code.
This may
mak
e a shorter executable.
This may
produc
e a shorter executable.
\end_inset
</cell>
</row>
...
...
@@ -827,6 +891,30 @@ Do not generate ASN.1 subtype constraint checking code.
\layout Standard
\size small
-fno-include-deps
\end_inset
</cell>
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text
\layout Standard
\size small
Do not generate courtesy #include lines for non-critical dependencies.
\end_inset
</cell>
</row>
<row topline="true">
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text
\layout Standard
\size small
-funnamed-unions
\end_inset
</cell>
...
...
@@ -847,6 +935,8 @@ Enable unnamed unions in the definitions of target language's structures.
\layout Standard
\size small
-ftypes88
\end_inset
</cell>
...
...
@@ -871,6 +961,7 @@ Pretend to support only ASN.1:1988 embedded types.
\series bold
\size small
Output Options
\end_inset
</cell>
...
...
@@ -881,6 +972,7 @@ Output Options
\series bold
\size small
Description
\end_inset
</cell>
...
...
@@ -891,6 +983,8 @@ Description
\layout Standard
\size small
-print-constraints
\end_inset
</cell>
...
...
@@ -912,6 +1006,8 @@ When -EF are also specified, this option forces the compiler to explain
\layout Standard
\size small
-print-lines
\end_inset
</cell>
...
...
doc/asn1c-usage.pdf
View file @
f47d068a
No preview for this file type
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment