2016-08-02 11:03:03 +00:00
|
|
|
|
2016-08-02 11:06:36 +00:00
|
|
|
## Compiling From Sources
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
### Configure
|
|
|
|
|
|
2017-05-05 10:34:57 +00:00
|
|
|
See [REQUIREMENTS.md](REQUIREMENTS.md) for the complete list of dependencies.
|
|
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
Configure with the default settings:
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
test -f configure || autoreconf -iv
|
|
|
|
|
./configure
|
|
|
|
|
make
|
|
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
Configure with non-standard settings:
|
2016-08-02 11:03:03 +00:00
|
|
|
|
2017-10-19 11:18:12 +00:00
|
|
|
asn1c-specific ./configure options include:
|
|
|
|
|
|
|
|
|
|
Option | Description
|
|
|
|
|
------------------------ | ---------------------------------------------------
|
|
|
|
|
--enable-ASN_DEBUG | produce debug log during `make check` testing
|
|
|
|
|
--enable-code-coverage | whether to enable code coverage support
|
|
|
|
|
--enable-Werror | abort compilation after any C compiler warning
|
|
|
|
|
--enable-test-Werror | abort compiling tests after any C compiler warning
|
|
|
|
|
--enable-test-32bit | enable tests for 32-bit compatibility
|
|
|
|
|
--disable-test-ubsan | disable Undefined Behavior Sanitizer for tests
|
|
|
|
|
--disable-test-asan | disable Address Sanitizer for tests
|
|
|
|
|
--enable-test-fuzzer | enable LLVM LibFuzzer for randomized testing
|
2016-08-02 11:05:48 +00:00
|
|
|
|
2016-08-02 11:03:03 +00:00
|
|
|
invoke `./configure --help` for details.
|
|
|
|
|
|
|
|
|
|
### Build
|
|
|
|
|
|
|
|
|
|
Build the libraries and the compiler:
|
|
|
|
|
|
|
|
|
|
make
|
|
|
|
|
|
|
|
|
|
Ensure asn1c is still behaving well after compiling on your platform:
|
|
|
|
|
|
|
|
|
|
make check
|
|
|
|
|
|
|
|
|
|
### Install
|
|
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
Install the compiler into a standard location:
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
make install
|
|
|
|
|
# Use ./configure --prefix to override install location.
|
|
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
Display the `asn1c` manual page:
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
man asn1c
|
|
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
## Quick Usage Guide
|
2016-08-02 11:03:03 +00:00
|
|
|
|
2016-08-02 11:05:48 +00:00
|
|
|
For a usage guide and more information please refer to:
|
2016-08-02 11:03:03 +00:00
|
|
|
|
2016-08-02 11:07:51 +00:00
|
|
|
* the [README.md](README.md) file
|
2016-08-02 11:03:03 +00:00
|
|
|
* the asn1c manual page `man asn1c`
|
2016-08-02 11:05:48 +00:00
|
|
|
* the included quick start PDF [doc/asn1c-quick.pdf](doc/asn1c-quick.pdf)
|
|
|
|
|
* the comprehensive usage documentation [doc/asn1c-usage.pdf](doc/asn1c-usage.pdf)
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
In case of any difficulties with installing the compiler, consider using
|
2016-08-02 11:07:40 +00:00
|
|
|
the Online ASN.1 Compiler at http://lionet.info/asn1c.
|
2016-08-02 11:03:03 +00:00
|
|
|
|
|
|
|
|
--
|
|
|
|
|
Lev Walkin
|
|
|
|
|
vlm@lionet.info
|
