Libtasn1 README -- Introduction information

This is GNU Libtasn1, a small ASN.1 library.

License

The GNU Libtasn1 C library (lib/) is released under the GNU Lesser General Public License (LGPL) version 2.1 or later; see COPYING.LESSERv2.

The command line tool (src/), self tests (tests/), examples (examples/), and other auxiliary files, are licensed under the GNU General Public License version 3.0 or later; see COPYING.

The manual (doc/) is released under the GNU Free Documentation License. (FDL) version 1.3 or later, see doc/fdl-1.3.texi.

Other files are licensed as indicated in each file. There may be exceptions to these general rules, see each file for precise information.

For any copyright year range specified as YYYY-ZZZZ in this package note that the range specifies every single year in that closed interval.

Building the library

We require several tools to build the software, including:

• Make
• Automake (use 1.11.3 or later)
• Autoconf
• Libtool
• Texinfo
• help2man
• Tar
• Gzip
• bison
• Texlive & epsf (for PDF manual)
• GTK-DOC (for API manual)
• Git
• libabigail (for abi comparison in make dist)
• Valgrind (optional)

The required software is typically distributed with your operating system, and the instructions for installing them differ. Here are some hints:

Debian/Ubuntu:

sudo apt-get install make git autoconf automake libtool bison
sudo apt-get install texinfo help2man gtk-doc-tools valgrind abigail-tools

PDF manual - Debian <= stretch:

sudo apt-get install texlive-generic-recommended texlive texlive-extra-utils

PDF manual - Debian >= buster:

sudo apt-get install texlive-plain-generic texlive texlive-extra-utils

The next step is to run autoreconf, ./configure, etc:

$ ./bootstrap

Then build the project normally:

$ ./configure
$ make check

Happy hacking!

Manual

The manual is in the doc/ directory of the release.

You can also browse the manual online at:

• https://www.gnu.org/software/libtasn1/manual/
• https://gnutls.gitlab.io/libtasn1/manual/
• https://gnutls.gitlab.io/libtasn1/manual/libtasn1.html
• https://gnutls.gitlab.io/libtasn1/manual/libtasn1.pdf
• https://gnutls.gitlab.io/libtasn1/reference/
• https://gnutls.gitlab.io/libtasn1/reference/libtasn1.pdf

Code coverage report

The coverage report is at:

• https://gnutls.gitlab.io/libtasn1/coverage

Issue trackers

• Main issue tracker
• oss-fuzz found issues

Homepage

The project homepage at the gnu site is at:

https://www.gnu.org/software/libtasn1/