source: postlfs/security/gnupg2.xml@ 439d67f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 439d67f was 439d67f, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

Add new package npth-1.2. Tag gcc5.
Update to gnupg-2.1.3. Tag gcc5.
MIT Kerberos V5-1.13.1: comment out authentication.

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

  • Property mode set to 100644
File size: 14.6 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 gnupg2-download-http " ">
8 <!ENTITY gnupg2-download-ftp "ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-&gnupg2-version;.tar.bz2">
9 <!ENTITY gnupg2-md5sum "e2c6b4d3194f5595bfc43050b580ce7e">
10 <!ENTITY gnupg2-size "4.7 MB">
11 <!ENTITY gnupg2-buildsize "102 MB (including html documentation)">
12 <!ENTITY gnupg2-time "0.5 SBU (additional 0.1 SBU for the tests)">
13]>
14
15<sect1 id="gnupg2" xreflabel="GnuPG-&gnupg2-version;">
16 <?dbhtml filename="gnupg.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>GnuPG-&gnupg2-version;</title>
24
25 <indexterm zone="gnupg2">
26 <primary sortas="a-GnuPG">GnuPG</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GnuPG</title>
31
32 <para>The <application>GnuPG</application> package is GNU's tool for
33 secure communication and data storage. It can be used to encrypt data and
34 to create digital signatures. It includes an advanced key management
35 facility and is compliant with the proposed OpenPGP Internet standard as
36 described in RFC2440 and the S/MIME standard as described by several RFCs.
37 GnuPG 2 is the stable version of GnuPG integrating support for OpenPGP and
38 S/MIME.</para>
39
40 &lfs77_checked; &gcc5_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>Download (HTTP): <ulink url="&gnupg2-download-http;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download (FTP): <ulink url="&gnupg2-download-ftp;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download MD5 sum: &gnupg2-md5sum;</para>
52 </listitem>
53 <listitem>
54 <para>Download size: &gnupg2-size;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated disk space required: &gnupg2-buildsize;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated build time: &gnupg2-time;</para>
61 </listitem>
62 </itemizedlist>
63
64 <bridgehead renderas="sect3">GnuPG 2 Dependencies</bridgehead>
65
66 <bridgehead renderas="sect4">Required</bridgehead>
67 <para role="required">
68 <xref linkend="libassuan"/>,
69 <xref linkend="libgcrypt"/>,
70 <xref linkend="libksba"/>, and
71 <xref linkend="npth"/>
72 </para>
73
74 <bridgehead renderas="sect4">Recommended</bridgehead>
75 <para role="recommended">
76 <xref linkend="pinentry"/> (Run-time requirement for most of
77 the package's functionality)
78 </para>
79
80 <bridgehead renderas="sect4">Optional</bridgehead>
81 <para role="optional">
82 <xref linkend="openldap"/>,
83 <xref linkend="libusb-compat"/>,
84 <xref linkend="curl"/>,
85 <ulink url="http://www.chiark.greenend.org.uk/~ian/adns/">GNU
86 adns</ulink>, an
87 <xref linkend="server-mail"/>, and
88 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>
89 )</para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/gnupg2"/></para>
93
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of GnuPG</title>
98
99 <para>Install <application>GnuPG</application> by running the following
100 commands:</para>
101
102<screen><userinput>./configure --prefix=/usr \
103 --enable-symcryptrun \
104 --docdir=/usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
105make &amp;&amp;
106
107makeinfo --html --no-split -o doc/gnupg_nochunks.html doc/gnupg.texi &amp;&amp;
108makeinfo --plaintext -o doc/gnupg.txt doc/gnupg.texi</userinput></screen>
109
110 <para>If you have <xref linkend="texlive"/>
111 installed and you wish to create documentation in alternate formats,
112 issue the following commands:</para>
113
114<screen><userinput>make -C doc pdf ps html</userinput></screen>
115
116 <para>To test the results, issue: <command>make check</command>.</para>
117
118 <para>Note that if you have already installed
119 <application>GnuPG</application>, the instructions below will overwrite
120 <filename>/usr/share/man/man1/gpg-zip.1</filename>. Now, as the
121 <systemitem class="username">root</systemitem> user:</para>
122
123<screen role="root"><userinput>make install &amp;&amp;
124
125install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
126install -v -m644 doc/gnupg_nochunks.html \
127 /usr/share/doc/gnupg-&gnupg2-version;/html/gnupg.html &amp;&amp;
128install -v -m644 doc/*.texi doc/gnupg.txt \
129 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
130
131 <para>We recommend the creation of symlinks for compatibility with the first
132 version of GnuPG, because some programs or scripts need them. Issue, as
133 <systemitem class="username">root</systemitem> user:</para>
134
135<screen role="root"><userinput>for f in gpg gpgv
136do
137 ln -svf ${f}2.1 /usr/share/man/man1/$f.1 &amp;&amp;
138 ln -svf ${f}2 /usr/bin/$f
139done
140unset f</userinput></screen>
141
142 <para>If you created alternate formats of the documentation, install it
143 using the following command as the
144 <systemitem class="username">root</systemitem> user:</para>
145
146<screen role="root"><userinput>install -v -m644 doc/gnupg.html/* \
147 /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
148install -v -m644 doc/gnupg.{pdf,dvi,ps} \
149 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para><parameter>--docdir=/usr/share/doc/gnupg-&gnupg2-version;</parameter>:
157 This switch changes the default docdir to <filename
158 class="directory">/usr/share/doc/gnupg-&gnupg2-version;</filename>.</para>
159
160 <para><parameter>--enable-symcryptrun</parameter>: This switch enables
161 building the symcryptrun program.</para>
162
163 </sect2>
164
165 <sect2 role="content">
166 <title>Contents</title>
167
168 <segmentedlist>
169 <segtitle>Installed Programs</segtitle>
170 <segtitle>Installed Libraries</segtitle>
171 <segtitle>Installed Directories</segtitle>
172
173 <seglistitem>
174 <seg>addgnupghome, applygnupgdefaults, dirmngr, dirmngr-client, g13,
175 gpg-agent, gpg-connect-agent, gpg, gpg2, gpgconf, gpgkey2ssh,
176 gpgparsemail, gpgsm, gpgsm-gencert.sh, gpgtar, gpgv, gpgv2, kbxutil,
177 symcryptrun, and watchgnupg</seg>
178 <seg>None</seg>
179 <seg>/usr/share/doc/gnupg-&gnupg2-version; and
180 /usr/share/gnupg</seg>
181 </seglistitem>
182 </segmentedlist>
183
184 <variablelist>
185 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
186 <?dbfo list-presentation="list"?>
187 <?dbhtml list-presentation="table"?>
188
189 <varlistentry id="addgnupghome">
190 <term><command>addgnupghome</command></term>
191 <listitem>
192 <para>is used to create and populate user's
193 <filename class='directory'>~/.gnupg</filename> directories</para>
194 <indexterm zone="gnupg2 addgnupghome">
195 <primary sortas="b-addgnupghome">addgnupghome</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="applygnupgdefaults">
201 <term><command>applygnupgdefaults</command></term>
202 <listitem>
203 <para>is a wrapper script used to run <command>gpgconf</command>
204 with the <parameter>--apply-defaults</parameter> parameter on all
205 user's GnuPG home directories.</para>
206 <indexterm zone="gnupg2 applygnupgdefaults">
207 <primary sortas="b-applygnupgdefaults">applygnupgdefaults</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="dirmngr">
213 <term><command>dirmngr</command></term>
214 <listitem>
215 <para> is a tool that takes care of accessing the OpenPGP keyservers.
216 </para>
217 <indexterm zone="gnupg2 dirmngr">
218 <primary sortas="b-dirmngr">dirmngr</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="dirmngr-client">
224 <term><command>dirmngr-client</command></term>
225 <listitem>
226 <para> is a tool to contact a running dirmngr and test whether a
227 certificate has been revoked. </para>
228 <indexterm zone="gnupg2 dirmngr-client">
229 <primary sortas="b-dirmngr-client">dirmngr-client</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="g13">
235 <term><command>g13</command></term>
236 <listitem>
237 <para>is a tool to create, mount or unmount an encrypted file system
238 container.</para>
239 <indexterm zone="gnupg2 g13">
240 <primary sortas="b-g13">g13</primary>
241 </indexterm>
242 </listitem>
243 </varlistentry>
244
245 <varlistentry id="gpg-agent">
246 <term><command>gpg-agent</command></term>
247 <listitem>
248 <para>is a daemon used to manage secret (private) keys independently
249 from any protocol. It is used as a backend for <command>gpg2</command>
250 and <command>gpgsm</command> as well as for a couple of other
251 utilities.</para>
252 <indexterm zone="gnupg2 gpg-agent">
253 <primary sortas="b-gpg-agent">gpg-agent</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257
258 <varlistentry id="gpg-connect-agent">
259 <term><command>gpg-connect-agent</command></term>
260 <listitem>
261 <para>is a utility used to communicate with a running
262 <command>gpg-agent</command>.</para>
263 <indexterm zone="gnupg2 gpg-connect-agent">
264 <primary sortas="b-gpg-connect-agent">gpg-connect-agent</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="gpg">
270 <term><command>gpg</command></term>
271 <listitem>
272 <para>(optional) is a symlink to <command>gpg2</command> for
273 compatibility with the first version of GnuPG.</para>
274 <indexterm zone="gnupg2 gpg">
275 <primary sortas="b-gpg">gpg</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="gpg2">
281 <term><command>gpg2</command></term>
282 <listitem>
283 <para>is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a
284 tool used to provide digital encryption and signing services using
285 the OpenPGP standard.</para>
286 <indexterm zone="gnupg2 gpg2">
287 <primary sortas="b-gpg2">gpg2</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="gpgconf">
293 <term><command>gpgconf</command></term>
294 <listitem>
295 <para>is a utility used to automatically and reasonably safely
296 query and modify configuration files in the
297 <filename class='directory'>~/.gnupg</filename> home directory. It is
298 designed not to be invoked manually by the user, but automatically by
299 graphical user interfaces.</para>
300 <indexterm zone="gnupg2 gpgconf">
301 <primary sortas="b-gpgconf">gpgconf</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="gpgparsemail">
307 <term><command>gpgparsemail</command></term>
308 <listitem>
309 <para>is a utility currently only useful for debugging. Run it with
310 <parameter>--help</parameter> for usage information.</para>
311 <indexterm zone="gnupg2 gpgparsemail">
312 <primary sortas="b-gpgparsemail">gpgparsemail</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="gpgsm">
318 <term><command>gpgsm</command></term>
319 <listitem>
320 <para>is a tool similar to <command>gpg2</command> used to provide
321 digital encryption and signing services on X.509 certificates and the
322 CMS protocol. It is mainly used as a backend for S/MIME mail
323 processing.</para>
324 <indexterm zone="gnupg2 gpgsm">
325 <primary sortas="b-gpgsm">gpgsm</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="gpgtar">
331 <term><command>gpgtar</command></term>
332 <listitem>
333 <para> is a tool to encrypt or sign files into an archive.</para>
334 <indexterm zone="gnupg2 gpgtar">
335 <primary sortas="b-gpgtar">gpgtar</primary>
336 </indexterm>
337 </listitem>
338 </varlistentry>
339
340 <varlistentry id="gpgsm-gencert.sh">
341 <term><command>gpgsm-gencert.sh</command></term>
342 <listitem>
343 <para>is a simple tool used to interactively generate a certificate
344 request which will be printed to stdout.</para>
345 <indexterm zone="gnupg2 gpgsm-gencert.sh">
346 <primary sortas="b-gpgsm-gencert.sh">gpgsm-gencert.sh</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="gpgv">
352 <term><command>gpgv</command></term>
353 <listitem>
354 <para>(optional) is a symlink to <command>gpgv2</command> for
355 compatibility with the first version of GnuPG.</para>
356 <indexterm zone="gnupg2 gpgv">
357 <primary sortas="b-gpgv">gpgv</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="gpgv2">
363 <term><command>gpgv2</command></term>
364 <listitem>
365 <para>is a verify only version of <command>gpg2</command>.</para>
366 <indexterm zone="gnupg2 gpgv2">
367 <primary sortas="b-gpgv2">gpgv2</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="kbxutil">
373 <term><command>kbxutil</command></term>
374 <listitem>
375 <para>is used to list, export and import Keybox data.</para>
376 <indexterm zone="gnupg2 kbxutil">
377 <primary sortas="b-kbxutil">kbxutil</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="symcryptrun">
383 <term><command>symcryptrun</command></term>
384 <listitem>
385 <para>is a simple symmetric encryption tool.</para>
386 <indexterm zone="gnupg2 symcryptrun">
387 <primary sortas="b-symcryptrun">symcryptrun</primary>
388 </indexterm>
389 </listitem>
390 </varlistentry>
391
392 <varlistentry id="watchgnupg">
393 <term><command>watchgnupg</command></term>
394 <listitem>
395 <para>is used to listen to a Unix Domain socket created by any of
396 the GnuPG tools.</para>
397 <indexterm zone="gnupg2 watchgnupg">
398 <primary sortas="b-watchgnupg">watchgnupg</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 </variablelist>
404
405 </sect2>
406
407</sect1>
Note: See TracBrowser for help on using the repository browser.