source: postlfs/security/gnupg2.xml@ 7b7ef4cc

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt 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 7b7ef4cc was 7b7ef4cc, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Package updates
Update to gnupg-2.2.29
Update to opencv-4.5.3

  • Property mode set to 100644
File size: 16.7 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 "&gnupg-http;/gnupg/gnupg-&gnupg2-version;.tar.bz2">
8 <!ENTITY gnupg2-download-ftp "&gnupg-ftp;/gnupg/gnupg-&gnupg2-version;.tar.bz2">
9 <!ENTITY gnupg2-md5sum "5db3334b528cf756b1e583db01319a24">
10 <!ENTITY gnupg2-size "6.9 MB">
11 <!ENTITY gnupg2-buildsize "143 MB (with all tests; add 25 MB for docs)">
12 <!ENTITY gnupg2-time "0.4 SBU (using parallelism=4; add 1.5 SBU for tests)">
13]>
14
15<sect1 id="gnupg2" xreflabel="GnuPG-&gnupg2-version;">
16 <?dbhtml filename="gnupg.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>GnuPG-&gnupg2-version;</title>
23
24 <indexterm zone="gnupg2">
25 <primary sortas="a-GnuPG">GnuPG</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to GnuPG</title>
30
31 <para>
32 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.
39 </para>
40
41 &lfs101_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&gnupg2-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&gnupg2-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &gnupg2-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &gnupg2-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &gnupg2-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &gnupg2-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">GnuPG 2 Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="libassuan"/>,
82 <xref linkend="libgcrypt"/>,
83 <xref linkend="libksba"/>, and
84 <xref linkend="npth"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="pinentry"/> (Run-time requirement for most of
90 the package's functionality)
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="curl"/>,
96 <xref linkend="fuse3"/>,
97 <xref linkend="gnutls"/>,
98 <xref linkend="imagemagick"/> (for the <command>convert</command> utility,
99 used for generating the documentation),
100 <xref linkend="libusb"/>,
101 an <xref linkend="server-mail"/>,
102 <xref linkend="openldap"/>,
103 <xref linkend="sqlite"/>,
104 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
105 <ulink url="http://mcj.sourceforge.net/">fig2dev</ulink> (for
106 generating documentation),
107 and <ulink url="http://www.chiark.greenend.org.uk/~ian/adns/">GNU
108 adns</ulink>
109 </para>
110
111 <para condition="html" role="usernotes">User Notes:
112 <ulink url="&blfs-wiki;/gnupg2"/></para>
113
114 </sect2>
115
116 <sect2 role="installation">
117 <title>Installation of GnuPG</title>
118
119 <para>
120 By default GnuPG doesn't install the deprecated gpg-zip script,
121 but it is still needed by some programs. Make GnuPG install it with:
122 </para>
123
124<screen><userinput>sed -e '/noinst_SCRIPTS = gpg-zip/c sbin_SCRIPTS += gpg-zip' \
125 -i tools/Makefile.in</userinput></screen>
126
127<!-- Seems to be resolved in 2.2.29
128 <para>
129 Fix a issue causing build failure if
130 <application>OpenLDAP</application> is not installed:
131 </para>
132
133<screen><userinput>sed -e '737a #if USE_LDAP' \
134 -e '760a #endif' \
135 -i dirmngr/dirmngr.c</userinput></screen>
136-->
137
138 <para>
139 Install <application>GnuPG</application> by running the following
140 commands:
141 </para>
142
143<screen><userinput>./configure --prefix=/usr \
144 --localstatedir=/var \
145 --docdir=/usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
146make &amp;&amp;
147
148makeinfo --html --no-split -o doc/gnupg_nochunks.html doc/gnupg.texi &amp;&amp;
149makeinfo --plaintext -o doc/gnupg.txt doc/gnupg.texi &amp;&amp;
150make -C doc html</userinput></screen>
151
152 <para>
153 If you have <xref linkend="texlive"/>
154 installed and you wish to create documentation in alternate formats,
155 issue the following commands
156 (<ulink url="http://mcj.sourceforge.net/">fig2dev</ulink> is needed for
157 the ps format):
158 </para>
159
160<screen remap="doc"><userinput>make -C doc pdf ps</userinput></screen>
161
162 <para>
163 To test the results, issue: <command>make check</command>.
164 </para>
165
166 <para>
167 Note that if you have already installed
168 <application>GnuPG</application>, the instructions below will overwrite
169 <filename>/usr/share/man/man1/gpg-zip.1</filename>. Now, as the
170 <systemitem class="username">root</systemitem> user:
171 </para>
172
173<screen role="root"><userinput>make install &amp;&amp;
174
175install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
176install -v -m644 doc/gnupg_nochunks.html \
177 /usr/share/doc/gnupg-&gnupg2-version;/html/gnupg.html &amp;&amp;
178install -v -m644 doc/*.texi doc/gnupg.txt \
179 /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
180install -v -m644 doc/gnupg.html/* \
181 /usr/share/doc/gnupg-&gnupg2-version;/html</userinput></screen>
182 <para>
183 If you created alternate formats of the documentation, install them
184 using the following command as the
185 <systemitem class="username">root</systemitem> user:
186 </para>
187
188<screen role="root"
189 remap="doc"><userinput>install -v -m644 doc/gnupg.{pdf,dvi,ps} \
190 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
191
192 </sect2>
193
194 <sect2 role="commands">
195 <title>Command Explanations</title>
196
197 <para>
198 <command>sed ... tools/Makefile.in</command>:
199 This command is needed to build the gpg-zip program.
200 </para>
201
202 <para>
203 <parameter>--docdir=/usr/share/doc/gnupg-&gnupg2-version;</parameter>:
204 This switch changes the default docdir to <filename
205 class="directory">/usr/share/doc/gnupg-&gnupg2-version;</filename>.
206 </para>
207
208<!-- Unrecognized in 2.2.26, seems to get built automatically now.
209 <para>
210 <parameter>- -enable-symcryptrun</parameter>: This switch enables
211 building the symcryptrun program.
212 </para>
213-->
214 <para>
215 <option>--enable-all-tests</option>: This switch allows more tests to be
216 run with <command>make check</command>.
217 </para>
218
219 <para>
220 <option>--enable-g13</option>: This switch enables building the
221 g13 program.
222 </para>
223
224 </sect2>
225
226 <sect2 role="content">
227 <title>Contents</title>
228
229 <segmentedlist>
230 <segtitle>Installed Programs</segtitle>
231 <segtitle>Installed Libraries</segtitle>
232 <segtitle>Installed Directories</segtitle>
233
234 <seglistitem>
235 <seg>addgnupghome, applygnupgdefaults, dirmngr, dirmngr-client, g13
236 (optional), gpg-agent, gpg-connect-agent, gpg, gpgconf, gpgparsemail,
237 gpgscm, gpgsm, gpgsplit, gpgtar, gpgv, gpg-wks-server, gpg-zip, kbxutil,
238 <!--symcryptrun,--> and watchgnupg</seg>
239 <seg>None</seg>
240 <seg>/usr/share/doc/gnupg-&gnupg2-version; and
241 /usr/share/gnupg</seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="addgnupghome">
251 <term><command>addgnupghome</command></term>
252 <listitem>
253 <para>
254 is used to create and populate a user's
255 <filename class="directory">~/.gnupg</filename> directories
256 </para>
257 <indexterm zone="gnupg2 addgnupghome">
258 <primary sortas="b-addgnupghome">addgnupghome</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="applygnupgdefaults">
264 <term><command>applygnupgdefaults</command></term>
265 <listitem>
266 <para>
267 is a wrapper script used to run <command>gpgconf</command>
268 with the <parameter>--apply-defaults</parameter> parameter on all
269 user's GnuPG home directories
270 </para>
271 <indexterm zone="gnupg2 applygnupgdefaults">
272 <primary sortas="b-applygnupgdefaults">applygnupgdefaults</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="dirmngr">
278 <term><command>dirmngr</command></term>
279 <listitem>
280 <para>
281 is a tool that takes care of accessing the OpenPGP keyservers
282 </para>
283 <indexterm zone="gnupg2 dirmngr">
284 <primary sortas="b-dirmngr">dirmngr</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="dirmngr-client">
290 <term><command>dirmngr-client</command></term>
291 <listitem>
292 <para>
293 is a tool to contact a running dirmngr and test whether a
294 certificate has been revoked
295 </para>
296 <indexterm zone="gnupg2 dirmngr-client">
297 <primary sortas="b-dirmngr-client">dirmngr-client</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
301
302 <varlistentry id="g13">
303 <term><command>g13</command></term>
304 <listitem>
305 <para>
306 is a tool to create, mount or unmount an encrypted file system
307 container (optional)
308 </para>
309 <indexterm zone="gnupg2 g13">
310 <primary sortas="b-g13">g13</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="gpg-agent">
316 <term><command>gpg-agent</command></term>
317 <listitem>
318 <para>
319 is a daemon used to manage secret (private) keys independently
320 from any protocol. It is used as a backend for
321 <command>gpg2</command> and <command>gpgsm</command> as well as
322 for a couple of other utilities
323 </para>
324 <indexterm zone="gnupg2 gpg-agent">
325 <primary sortas="b-gpg-agent">gpg-agent</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 <varlistentry id="gpg-connect-agent">
331 <term><command>gpg-connect-agent</command></term>
332 <listitem>
333 <para>
334 is a utility used to communicate with a running
335 <command>gpg-agent</command>
336 </para>
337 <indexterm zone="gnupg2 gpg-connect-agent">
338 <primary sortas="b-gpg-connect-agent">gpg-connect-agent</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="gpg">
344 <term><command>gpg</command></term>
345 <listitem>
346 <para>
347 is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a
348 tool used to provide digital encryption and signing services using
349 the OpenPGP standard
350 </para>
351 <indexterm zone="gnupg2 gpg">
352 <primary sortas="b-gpg">gpg</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="gpgconf">
358 <term><command>gpgconf</command></term>
359 <listitem>
360 <para>
361 is a utility used to automatically and reasonably safely
362 query and modify configuration files in the
363 <filename class="directory">~/.gnupg</filename> home directory. It
364 is designed not to be invoked manually by the user, but
365 automatically by graphical user interfaces
366 </para>
367 <indexterm zone="gnupg2 gpgconf">
368 <primary sortas="b-gpgconf">gpgconf</primary>
369 </indexterm>
370 </listitem>
371 </varlistentry>
372
373 <varlistentry id="gpgparsemail">
374 <term><command>gpgparsemail</command></term>
375 <listitem>
376 <para>
377 is a utility currently only useful for debugging. Run it with
378 <parameter>--help</parameter> for usage information
379 </para>
380 <indexterm zone="gnupg2 gpgparsemail">
381 <primary sortas="b-gpgparsemail">gpgparsemail</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="gpgscm">
387 <term><command>gpgscm</command></term>
388 <listitem>
389 <para>
390 executes the given scheme program or spawns an interactive shell
391 </para>
392 <indexterm zone="gnupg2 gpgscm">
393 <primary sortas="b-gpgscm">gpgscm</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
398 <varlistentry id="gpgsm">
399 <term><command>gpgsm</command></term>
400 <listitem>
401 <para>
402 is a tool similar to <command>gpg2</command> used to provide
403 digital encryption and signing services on X.509 certificates and
404 the CMS protocol. It is mainly used as a backend for S/MIME mail
405 processing
406 </para>
407 <indexterm zone="gnupg2 gpgsm">
408 <primary sortas="b-gpgsm">gpgsm</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 <varlistentry id="gpgsplit">
414 <term><command>gpgsplit</command></term>
415 <listitem>
416 <para>
417 splits an OpenPGP message into packets
418 </para>
419 <indexterm zone="gnupg2 gpgsplit">
420 <primary sortas="b-gpgsplit">gpgsplit</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="gpgtar">
426 <term><command>gpgtar</command></term>
427 <listitem>
428 <para>
429 is a tool to encrypt or sign files into an archive
430 </para>
431 <indexterm zone="gnupg2 gpgtar">
432 <primary sortas="b-gpgtar">gpgtar</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="gpgv">
438 <term><command>gpgv</command></term>
439 <listitem>
440 <para>
441 is a verify only version of <command>gpg2</command>
442 </para>
443 <indexterm zone="gnupg2 gpgv">
444 <primary sortas="b-gpgv">gpgv</primary>
445 </indexterm>
446 </listitem>
447 </varlistentry>
448
449 <varlistentry id="gpg-wks-server">
450 <term><command>gpg-wks-server</command></term>
451 <listitem>
452 <para>
453 provides a server for the
454 <application>Web Key Service</application> protocol
455 </para>
456 <indexterm zone="gnupg2 gpg-wks-server">
457 <primary sortas="b-gpg-wks-server">gpg-wks-server</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="gpg-zip">
463 <term><command>gpg-zip</command></term>
464 <listitem>
465 <para>
466 encrypts or signs files into an archive
467 </para>
468 <indexterm zone="gnupg2 gpg-zip">
469 <primary sortas="b-gpg-zip">gpg-zip</primary>
470 </indexterm>
471 </listitem>
472 </varlistentry>
473
474 <varlistentry id="kbxutil">
475 <term><command>kbxutil</command></term>
476 <listitem>
477 <para>
478 is used to list, export and import Keybox data
479 </para>
480 <indexterm zone="gnupg2 kbxutil">
481 <primary sortas="b-kbxutil">kbxutil</primary>
482 </indexterm>
483 </listitem>
484 </varlistentry>
485
486 <!--
487 <varlistentry id="symcryptrun">
488 <term><command>symcryptrun</command></term>
489 <listitem>
490 <para>
491 is a simple symmetric encryption tool.
492 </para>
493 <indexterm zone="gnupg2 symcryptrun">
494 <primary sortas="b-symcryptrun">symcryptrun</primary>
495 </indexterm>
496 </listitem>
497 </varlistentry>
498-->
499 <varlistentry id="watchgnupg">
500 <term><command>watchgnupg</command></term>
501 <listitem>
502 <para>
503 is used to listen to a Unix Domain socket created by any of
504 the GnuPG tools
505 </para>
506 <indexterm zone="gnupg2 watchgnupg">
507 <primary sortas="b-watchgnupg">watchgnupg</primary>
508 </indexterm>
509 </listitem>
510 </varlistentry>
511
512 </variablelist>
513
514 </sect2>
515
516</sect1>
Note: See TracBrowser for help on using the repository browser.