mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-03 06:27:16 +08:00
a5a5f0f785
Important: Added a section about stability. Also fixed a build failure with last commit (missing ending para tag).
310 lines
8.4 KiB
XML
310 lines
8.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY libtasn1-download-http "&gnu-http;/libtasn1/libtasn1-&libtasn1-version;.tar.gz">
|
|
<!ENTITY libtasn1-download-ftp " ">
|
|
]>
|
|
|
|
<sect1 id="libtasn1" xreflabel="libtasn1-&libtasn1-version;">
|
|
<?dbhtml filename="libtasn1.html"?>
|
|
|
|
|
|
<title>libtasn1-&libtasn1-version;</title>
|
|
|
|
<indexterm zone="libtasn1">
|
|
<primary sortas="a-libtasn1">libtasn1</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to libtasn1</title>
|
|
|
|
<para>
|
|
<application>libtasn1</application> is a highly portable C library
|
|
that encodes and decodes DER/BER data following an ASN.1 schema.
|
|
</para>
|
|
|
|
|
|
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&libtasn1-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&libtasn1-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of libtasn1</title>
|
|
|
|
<para>
|
|
Install <application>libtasn1</application> by running the
|
|
following commands:
|
|
</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr --disable-static &&
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
To test the results, issue: <command>make check</command>.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem>
|
|
user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
|
|
<para>
|
|
If you did not pass the <option>--enable-gtk-doc</option> option
|
|
to the <command>configure</command> script, you can install the API
|
|
documentation using the following command as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make -C doc/reference install-data-local</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>32-bit Installation of libtasn1</title>
|
|
|
|
<para>
|
|
Clean the directory by running the following command:
|
|
</para>
|
|
|
|
<screen><userinput>make distclean</userinput></screen>
|
|
|
|
<para>
|
|
Install <application>lib32-libtasn1</application>
|
|
by running the following commands:
|
|
</para>
|
|
|
|
<screen><userinput>CC="gcc -m32" CXX="g++ -m32" \
|
|
PKG_CONFIG_PATH=/usr/lib32/pkgconfig \
|
|
./configure --prefix=/usr \
|
|
--libdir=/usr/lib32 \
|
|
--host=i686-pc-linux-gnu \
|
|
--disable-static &&
|
|
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
Now as the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
<screen role="root"><userinput>make DESTDIR=$PWD/DESTDIR install
|
|
cp -vr DESTDIR/usr/lib32/* /usr/lib32
|
|
rm -rf DESTDIR
|
|
ldconfig</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="possible">
|
|
<title>Possible Parameters</title>
|
|
|
|
<para>
|
|
<option>--{en,dis}able-silent-rules</option>: This option changes
|
|
verbosity in the build output.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--{en,dis}able-dependency-tracking</option>: This option
|
|
changes whether to accept slow dependency extractors.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-largefile</option>: This option disables support
|
|
for large files.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-year2038</option>: This option disables support
|
|
for timestamps beyond the year 2038.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-doc</option>: This option disables building
|
|
documentation.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--{en,dis}able-shared</option>: This option toggles
|
|
building shared libraries (enabled by default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--{en,dis}able-static</option>: This option toggles
|
|
building static libraries (enabled by default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-fast-install</option>: This option optimizes for
|
|
a faster installation (enabled by default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-libtool-lock</option>: This option <quote>avoids
|
|
locking</quote> which can break building this package with multiple jobs.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-gtk-doc</option>: This option enables the use of
|
|
<command>gtk-doc</command> to build documentation (it is broken and
|
|
disabled by default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-gtk-doc-html</option>: This option builds HTML
|
|
documentation (enabled by default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-gtk-doc-pdf</option>: Same as <option>
|
|
--enable-gtk-doc-html</option> but builds as a PDF (disabled by
|
|
default).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-cross-guesses={conservative,risky}</option>: This
|
|
option changes the policy for cross-compilation guesses. It is
|
|
recommended to leave this alone unless you know what you're doing.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-ld-version-script</option>: This option enables
|
|
the linker version script (enabled by default if available).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-valgrind-tests</option>: This option disables
|
|
running tests with <application>Valgrind</application>.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-code-coverage</option>: This option enables
|
|
code coverage support.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--disable-gcc-warnings</option>: This option disables GCC
|
|
warnings.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--enable-fuzzing</option>: This option turns on fuzzing
|
|
for the building process.
|
|
</para>
|
|
|
|
<para>
|
|
<option>--with-aix-soname={aix,svr4,both}</option>: This option
|
|
changes the soname variant (default is aix).
|
|
</para>
|
|
|
|
<para>
|
|
<option>--with-gnu-ld</option>: This option assumes that the C
|
|
compiler uses GNU ld (disabled by default but will be automatically
|
|
detected).
|
|
</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="commands">
|
|
<title>Command Explanations</title>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/static-libraries.xml"/>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Library</segtitle>
|
|
<segtitle>Installed Directory</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
asn1Coding, asn1Decoding and asn1Parser
|
|
</seg>
|
|
<seg>
|
|
libtasn1.so
|
|
</seg>
|
|
<seg>
|
|
/usr/share/gtk-doc/html/libtasn1
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="asn1Coding">
|
|
<term><command>asn1Coding</command></term>
|
|
<listitem>
|
|
<para>
|
|
is an ASN.1 DER encoder
|
|
</para>
|
|
<indexterm zone="libtasn1 asn1Coding">
|
|
<primary sortas="b-asn1Coding">asn1Coding</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="asn1Decoding">
|
|
<term><command>asn1Decoding</command></term>
|
|
<listitem>
|
|
<para>
|
|
is an ASN.1 DER decoder
|
|
</para>
|
|
<indexterm zone="libtasn1 asn1Decoding">
|
|
<primary sortas="b-asn1Decoding">asn1Decoding</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="asn1Parser">
|
|
<term><command>asn1Parser</command></term>
|
|
<listitem>
|
|
<para>
|
|
is an ASN.1 syntax tree generator for
|
|
<application>libtasn1</application>
|
|
</para>
|
|
<indexterm zone="libtasn1 asn1Parser">
|
|
<primary sortas="b-asn1Parser">asn1Parser</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libtasn1-lib">
|
|
<term><filename class="libraryfile">libtasn1.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
is a library for Abstract Syntax Notation One (ASN.1) and
|
|
Distinguish Encoding Rules (DER) manipulation
|
|
</para>
|
|
<indexterm zone="libtasn1 libtasn1-lib">
|
|
<primary sortas="c-libtasn1">libtasn1.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|