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
b11b2209
Commit
b11b2209
authored
Oct 12, 2014
by
Lev Walkin
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs updated; use markdown
parent
118df6e8
Changes
4
Hide whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
29 additions
and
31 deletions
+29
-31
Makefile.am
Makefile.am
+1
-1
README.md
README.md
+25
-27
asn1c.spec.in
asn1c.spec.in
+1
-1
doc/Makefile.am
doc/Makefile.am
+2
-2
No files found.
Makefile.am
View file @
b11b2209
...
@@ -9,7 +9,7 @@ SUBDIRS = \
...
@@ -9,7 +9,7 @@ SUBDIRS = \
docsdir
=
$(datadir)
/doc/asn1c
docsdir
=
$(datadir)
/doc/asn1c
docs_DATA
=
README FAQ COPYING ChangeLog BUGS TODO
docs_DATA
=
README
.md
FAQ COPYING ChangeLog BUGS TODO
EXTRA_DIST
=
asn1c.spec.in FAQ BUGS MANIFEST tests/
EXTRA_DIST
=
asn1c.spec.in FAQ BUGS MANIFEST tests/
CLEANFILES
=
asn1c.spec
CLEANFILES
=
asn1c.spec
README
→
README
.md
View file @
b11b2209
WHAT TO READ?
# WHAT TO READ?
=============
If you haven't installed the asn1c yet, read the INSTALL file for
If you haven't installed the asn1c yet, read the INSTALL file for
a
a
short installation guide.
short installation guide.
For the list of asn1c command line options, see
`asn1c -h`
or
`man asn1c`
.
For the list of asn1c command line options, see
`asn1c -h`
or
`man asn1c`
.
For more complete documentation on this compiler and on using the
The comprehensive documentation on this compiler is in asn1c-usage.pdf.
results of compilation phase, please look into asn1c-quick.pdf and
asn1c-usage.{pdf,html}.
If you are building the compiler from the sources, the PDFs reside
If you are building the compiler from the sources, these documents reside
in the ./doc directory. Normally the file is installed together with the
in the ./doc directory, otherwise they lie nearby the README file you're
README.md file you're reading right now.
reading right now.
Please also read the FAQ file.
Please also read the FAQ file.
An excellent book on ASN.1 is written by Olivier Dubuisson:
An excellent book on ASN.1 is written by Olivier Dubuisson:
"ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0.
"ASN.1 Communication between heterogeneous systems", ISBN:0-12-6333361-0.
QUICK START (also check out asn1c-quick.pdf)
# QUICK START
============================================
(also check out ./doc/asn1c-quick.pdf)
After building [and installing] the compiler (see INSTALL), you may use
After building [and installing] the compiler (see INSTALL), you may use
the asn1c command to compile the ASN.1 specification:
the asn1c command to compile the ASN.1 specification:
asn1c <module.asn1>
# Compile module
asn1c <module.asn1>
# Compile module
If several specifications contain interdependencies, all of them must be
If several specifications contain interdependencies, all of them must be
specified:
specified:
asn1c <module1.asn1> <module2.asn1> ...
# Compile interdependent modules
asn1c <module1.asn1> <module2.asn1> ...
# Compile interdependent modules
If you are building the asn1c from the sources, the ./examples directory
If you are building the asn1c from the sources, the ./examples directory
contains several ASN.1 modules and a script to extract the ASN.1 modules
contains several ASN.1 modules and a script to extract the ASN.1 modules
from RFC documents. Refer to the README file in that directory.
from RFC documents. Refer to the README file in that directory.
To compile the X.509 PKI module:
To compile the X.509 PKI module:
./asn1c/asn1c -P ./examples/rfc3280-*.asn1
# Compile-n-print
./asn1c/asn1c -P ./examples/rfc3280-*.asn1
# Compile-n-print
In this example, -P option is used to instruct the compiler to print the
In this example, -P option is used to instruct the compiler to print the
compiled text on the standard output instead of creating multiple .c
compiled text on the standard output instead of creating multiple .c
...
@@ -50,28 +49,27 @@ to dump out the parsed (and fixed) ASN.1 specification as it was
...
@@ -50,28 +49,27 @@ to dump out the parsed (and fixed) ASN.1 specification as it was
whether a particular syntactic construction is properly supported
whether a particular syntactic construction is properly supported
by the compiler.
by the compiler.
asn1c -EF <module-to-test.asn1>
# Check semantic validity
asn1c -EF <module-to-test.asn1>
# Check semantic validity
# MODEL OF OPERATION
MODEL OF OPERATION
==================
The asn1c compiler works by processing the ASN.1 module specification
The asn1c compiler works by processing the ASN.1 module specification
s
in several stages:
in several stages:
1.
In the first stage, the ASN.1 file is parsed.
1.
In the first stage, the ASN.1 file is parsed.
(Parsing produces an ASN.1 syntax tree for the subsequent levels)
(Parsing produces an ASN.1 syntax tree for the subsequent levels)
2.
In the second stage, the syntax tree is "fixed".
2.
In the second stage, the syntax tree is "fixed".
(Fixing is a process of checking the tree for semantic errors,
(Fixing is a process of checking the tree for semantic errors,
accompanied by the tree transformation into the canonical form)
accompanied by the tree transformation into the canonical form)
3.
In the third stage, the syntax tree is compiled into the target language.
3.
In the third stage, the syntax tree is compiled into the target language.
There are several command-line options reserved for printing the results
There are several command-line options reserved for printing the results
after each stage of operation:
after each stage of operation:
<parser> => print
(-E)
<parser> => print
(-E)
<parser> => <fixer> => print
(-E -F)
<parser> => <fixer> => print
(-E -F)
<parser> => <fixer> => <compiler> => print
(-P)
<parser> => <fixer> => <compiler> => print
(-P)
<parser> => <fixer> => <compiler> => save-compiled
[default]
<parser> => <fixer> => <compiler> => save-compiled
[default]
--
--
...
...
asn1c.spec.in
View file @
b11b2209
...
@@ -37,7 +37,7 @@ rm -rf $RPM_BUILD_ROOT
...
@@ -37,7 +37,7 @@ rm -rf $RPM_BUILD_ROOT
rm -rf $RPM_BUILD_ROOT
rm -rf $RPM_BUILD_ROOT
%files
%files
%doc README FAQ COPYING ChangeLog BUGS TODO
%doc README
.md
FAQ COPYING ChangeLog BUGS TODO
%doc doc/asn1c-usage.pdf doc/asn1c-usage.html
%doc doc/asn1c-usage.pdf doc/asn1c-usage.html
%attr(755,root,root) %{_bindir}
%attr(755,root,root) %{_bindir}
%attr(644,root,root) %{_datadir}/asn1c
%attr(644,root,root) %{_datadir}/asn1c
...
...
doc/Makefile.am
View file @
b11b2209
...
@@ -3,7 +3,7 @@ SUBDIRS = docsrc
...
@@ -3,7 +3,7 @@ SUBDIRS = docsrc
docsdir
=
$(datadir)
/doc/asn1c
docsdir
=
$(datadir)
/doc/asn1c
docs_DATA
=
$(srcdir)
/
*
.pdf
docs_DATA
=
$(srcdir)
/
asn1c-
*
.pdf
EXTRA_DIST
=
$(srcdir)
/
*
.pdf
EXTRA_DIST
=
$(srcdir)
/
asn1c-
*
.pdf
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