source: general/genlib/libgcrypt.xml@ 2a44f9e

10.0 10.1 11.0 11.1 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 2a44f9e was 2a44f9e, checked in by Douglas R. Reno <renodr@…>, 6 years ago

Update to libgcrypt-1.7.3
Update to evolution-data-server-3.20.5
Update to libgweather-3.20.2
Update to gnome-online-accounts-3.20.3

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17641 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libgcrypt-download-http " ">
8 <!ENTITY libgcrypt-download-ftp "ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-&libgcrypt-version;.tar.bz2">
9 <!ENTITY libgcrypt-md5sum "c869e542cc13a1c28d8055487bf7f5c4">
10 <!ENTITY libgcrypt-size "2.7 MB">
11 <!ENTITY libgcrypt-buildsize "48 MB (with tests and building docs)">
12 <!ENTITY libgcrypt-time "0.7 SBU (with tests and building docs)">
13]>
14
15<sect1 id="libgcrypt" xreflabel="libgcrypt-&libgcrypt-version;">
16 <?dbhtml filename="libgcrypt.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libgcrypt-&libgcrypt-version;</title>
24
25 <indexterm zone="libgcrypt">
26 <primary sortas="a-libgcrypt">libgcrypt</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libgcrypt</title>
31
32 <para>
33 The <application>libgcrypt</application> package contains a general
34 purpose crypto library based on the code used in
35 <application>GnuPG</application>. The library provides a high level
36 interface to cryptographic building blocks using an extendable and flexible
37 API.
38 </para>
39
40 &lfs79_checked;&gcc6_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&libgcrypt-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&libgcrypt-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &libgcrypt-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &libgcrypt-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &libgcrypt-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &libgcrypt-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">libgcrypt Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="libgpg-error"/>
81 </para>
82
83 <bridgehead renderas="sect4">Optional</bridgehead>
84 <para role="optional">
85 <xref linkend="libcap-pam"/> and
86 <xref linkend="pth"/>,
87 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
88 </para>
89
90 <para condition="html" role="usernotes">User Notes:
91 <ulink url="&blfs-wiki;/libgcrypt"/>
92 </para>
93 </sect2>
94
95 <sect2 role="installation">
96 <title>Installation of libgcrypt</title>
97
98 <para>
99 Install <application>libgcrypt</application> by running the
100 following commands:
101 </para>
102
103<screen><userinput>./configure --prefix=/usr &amp;&amp;
104make</userinput></screen>
105
106 <para>
107 Only <command>info</command> documentation is shipped in the package
108 tarball. If you wish to build alternate formats of the documentation,
109 (you must have <xref linkend="texlive"/> installed to build the PDF
110 and PostScript documentation), then issue the following commands:
111 </para>
112
113<screen><userinput>make -C doc pdf ps html &amp;&amp;
114makeinfo --html --no-split -o doc/gcrypt_nochunks.html doc/gcrypt.texi &amp;&amp;
115makeinfo --plaintext -o doc/gcrypt.txt doc/gcrypt.texi</userinput></screen>
116
117 <para>
118 To test the results, issue: <command>make check</command>.
119 </para>
120
121 <para>
122 Now, as the <systemitem class="username">root</systemitem> user:
123 </para>
124
125<screen role="root"><userinput>make install &amp;&amp;
126install -v -dm755 /usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
127install -v -m644 README doc/{README.apichanges,fips*,libgcrypt*} \
128 /usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
129
130 <para>
131 If you built the additional documentation, install it by issuing the
132 following commands as the <systemitem class="username">root</systemitem>
133 user:
134 </para>
135
136<screen role="root"><userinput>install -v -dm755 /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
137install -v -m644 doc/gcrypt.html/* \
138 /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
139install -v -m644 doc/gcrypt_nochunks.html \
140 /usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
141install -v -m644 doc/gcrypt.{pdf,ps,dvi,txt,texi} \
142 /usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
143
144 </sect2>
145
146 <sect2 role="commands">
147 <title>Command Explanations</title>
148
149 <para>
150 <option>--with-capabilities</option>: This option enables libcap2 support.
151 Note that this breaks <ulink
152 url="https://gitlab.com/cryptsetup/cryptsetup">Cryptsetup</ulink>.
153 </para>
154
155 </sect2>
156
157 <sect2 role="content">
158 <title>Contents</title>
159
160 <segmentedlist>
161 <segtitle>Installed Programs</segtitle>
162 <segtitle>Installed Library</segtitle>
163 <segtitle>Installed Directory</segtitle>
164
165 <seglistitem>
166 <seg>
167 dumpsexp, hmac256, libgcrypt-config, and mpicalc
168 </seg>
169 <seg>
170 libgcrypt.so
171 </seg>
172 <seg>
173 /usr/share/doc/libgcrypt-&libgcrypt-version;
174 </seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="dumpsexp">
184 <term><command>dumpsexp</command></term>
185 <listitem>
186 <para>
187 is a debug tool for S-expressions.
188 </para>
189 <indexterm zone="libgcrypt dumpsexp">
190 <primary sortas="b-dumpsexp">dumpsexp</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 <varlistentry id="hmac256">
196 <term><command>hmac256</command></term>
197 <listitem>
198 <para>
199 is a standalone HMAC-SHA-256 implementation used to compute
200 an HMAC-SHA-256 authentication code.
201 </para>
202 <indexterm zone="libgcrypt hmac256">
203 <primary sortas="b-hmac256">hmac256</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="libgcrypt-config">
209 <term><command>libgcrypt-config</command></term>
210 <listitem>
211 <para>
212 determines the compile and linker flags that should be used to
213 compile and link programs that use <filename class="libraryfile">libgcrypt</filename>.
214 </para>
215 <indexterm zone="libgcrypt libgcrypt-config">
216 <primary sortas="b-libgcrypt-config">libgcrypt-config</primary>
217 </indexterm>
218 </listitem>
219 </varlistentry>
220
221 <varlistentry id="mpicalc">
222 <term><command>mpicalc</command></term>
223 <listitem>
224 <para>
225 is a RPN (Reverse Polish Notation) calculator.
226 </para>
227 <indexterm zone="libgcrypt mpicalc">
228 <primary sortas="b-mpicalc">mpicalc</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 <varlistentry id="libgcrypt-lib">
234 <term><filename class="libraryfile">libgcrypt.so</filename></term>
235 <listitem>
236 <para>
237 contains the cryptographic API functions.
238 </para>
239 <indexterm zone="libgcrypt libgcrypt-lib">
240 <primary sortas="c-libgcrypt">libgcrypt.so</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 </variablelist>
246
247 </sect2>
248
249</sect1>
Note: See TracBrowser for help on using the repository browser.