source: postlfs/security/gnupg2.xml@ 5363d29

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5363d29 was 5363d29, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Updated to gnupg-2.0.19.
Tag 7.2 libksba, libassuan, pth

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

  • Property mode set to 100644
File size: 13.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 "6a8589381ca1b0c1a921e9955f42b016">
10 <!ENTITY gnupg2-size "4.0 MB">
11 <!ENTITY gnupg2-buildsize "67 MB">
12 <!ENTITY gnupg2-time "1.2 SBU">
13]>
14
15<sect1 id="gnupg2" xreflabel="GnuPG-&gnupg2-version;">
16 <?dbhtml filename="gnupg2.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-2">GnuPG 2</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to GnuPG 2</title>
31
32 <para>The <application>GnuPG 2</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. It does not conflict with an installed <xref linkend="gnupg"/>
39 OpenPGP-only version.</para>
40
41 &lfs72_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>Download (HTTP): <ulink url="&gnupg2-download-http;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download (FTP): <ulink url="&gnupg2-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download MD5 sum: &gnupg2-md5sum;</para>
53 </listitem>
54 <listitem>
55 <para>Download size: &gnupg2-size;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated disk space required: &gnupg2-buildsize;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated build time: &gnupg2-time;</para>
62 </listitem>
63 </itemizedlist>
64
65 <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
66 <itemizedlist spacing='compact'>
67 <listitem>
68 <para>Required Patch: <ulink
69 url="&patch-root;/gnupg2-&gnupg2-version;-curl_LDAP-1.patch"/>
70 </para>
71 </listitem>
72 </itemizedlist> -->
73
74 <bridgehead renderas="sect3">GnuPG Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required"><xref linkend="pth"/>,
78 <xref linkend="libassuan"/>,
79 <xref linkend="libgcrypt"/>, and
80 <xref linkend="libksba"/></para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended"><xref linkend="pinentry"/> (Run-time requirement for most of
84 the package's functionality)</para>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional"><xref linkend="openldap"/>,
88 <xref linkend="libusb-compat"/>,
89 <xref linkend="curl"/>,
90 <ulink url="http://www.chiark.greenend.org.uk/~ian/adns/">GNU
91 adns</ulink>, and an
92 <xref linkend="server-mail"/></para>
93
94 <para condition="html" role="usernotes">User Notes:
95 <ulink url="&blfs-wiki;/gnupg2"/></para>
96
97 </sect2>
98
99 <sect2 role="installation">
100 <title>Installation of GnuPG 2</title>
101
102 <para>Install <application>GnuPG 2</application> by running the following
103 commands:</para>
104
105<screen><userinput>./configure --prefix=/usr \
106 --libexecdir=/usr/lib/gnupg2 \
107 --docdir=/usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
108make
109
110makeinfo --html --no-split -o doc/gnupg_nochunks.html doc/gnupg.texi &amp;&amp;
111makeinfo --plaintext -o doc/gnupg.txt doc/gnupg.texi</userinput></screen>
112
113 <para>If you have <!--<xref linkend="tetex"/> or--> <xref linkend="texlive"/>
114 installed and you wish to create documentation in alternate formats,
115 issue the following commands:</para>
116
117<screen><userinput>make -C doc pdf ps html</userinput></screen>
118
119 <para>To test the results, issue: <command>make check</command>.</para>
120
121 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
122
123 <!-- Removing this from the commands as it doesn't appear
124 necessary any longer. See the gnupg.texi file (or some
125 TeX derivative) for additional information.
126
127 chmod -v 4755 /usr/bin/gpg &amp;&amp;
128 -->
129
130<screen role="root"><userinput>make install
131
132install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
133install -v -m644 doc/gnupg_nochunks.html \
134 /usr/share/doc/gnupg-&gnupg2-version;/gnupg.html &amp;&amp;
135install -v -m644 doc/*.texi doc/gnupg.txt \
136 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
137
138<!-- Documentation is installed by default -->
139
140<!-- <screen role="root"><userinput>make install &amp;&amp;
141
142install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
143ln -sv ../../gnupg/FAQ /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
144ln -sv ../../gnupg/faq.html /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
145
146install -v -m644 doc/{DETAILS,KEYSERVER,OpenPGP,TRANSLATE} \
147 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen> -->
148
149 <para>If you created alternate formats of the documentation, install it
150 using the following command as the
151 <systemitem class="username">root</systemitem> user:</para>
152
153<screen role="root"><userinput>install -v -m644 doc/gnupg.html/* \
154 /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
155install -v -m644 doc/gnupg.{pdf,dvi,ps} \
156 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
157
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para><parameter>--libexecdir=/usr/lib/gnupg2</parameter>: This switch
164 creates a <filename class="directory">gnupg</filename> directory in
165 <filename class="directory">/usr/lib</filename> instead of
166 <filename class="directory">/usr/libexec</filename>.</para>
167
168 <para><parameter>--docdir=/usr/share/doc/gnupg-&gnupg2-version;</parameter>:
169 This switch changes the default docdir to <filename
170 class="directory">/usr/share/doc/gnupg-&gnupg2-version;</filename>.</para>
171
172 <para><parameter>--enable-symcryptrun</parameter>: This switch enables
173 building the symcryptrun program.</para>
174
175 <!-- See above why this is no longer included
176 <para><command>chmod -v 4755 /usr/bin/gpg</command>:
177 <command>gpg</command> is installed setuid
178 <systemitem class='username'>root</systemitem> to avoid swapping
179 out sensitive data.</para>
180 -->
181
182 </sect2>
183
184 <sect2 role="content">
185 <title>Contents</title>
186
187 <segmentedlist>
188 <segtitle>Installed Programs</segtitle>
189 <segtitle>Installed Libraries</segtitle>
190 <segtitle>Installed Directories</segtitle>
191
192 <seglistitem>
193 <seg>addgnupghome, applygnupgdefaults, gpg-agent, gpg-connect-agent,
194 gpg2, gpgconf, gpgkey2ssh, gpgparsemail, gpgsm, gpgsm-gencert.sh,
195 gpgv2, kbxutil, scdaemon, symcryptrun, and watchgnupg</seg>
196 <seg>None</seg>
197 <seg>/usr/lib/gnupg2, /usr/share/gnupg and
198 /usr/share/doc/gnupg-&gnupg2-version;</seg>
199 </seglistitem>
200 </segmentedlist>
201
202 <variablelist>
203 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
204 <?dbfo list-presentation="list"?>
205 <?dbhtml list-presentation="table"?>
206
207 <varlistentry id="addgnupghome">
208 <term><command>addgnupghome</command></term>
209 <listitem>
210 <para>is used to create and populate user's
211 <filename class='directory'>~/.gnupg</filename> directories</para>
212 <indexterm zone="gnupg2 addgnupghome">
213 <primary sortas="b-addgnupghome">addgnupghome</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="applygnupgdefaults">
219 <term><command>applygnupgdefaults</command></term>
220 <listitem>
221 <para>is a wrapper script used to run <command>gpgconf</command>
222 with the <parameter>--apply-defaults</parameter> parameter on all
223 user's GnuPG home directories.</para>
224 <indexterm zone="gnupg2 applygnupgdefaults">
225 <primary sortas="b-applygnupgdefaults">applygnupgdefaults</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="gpg-agent">
231 <term><command>gpg-agent</command></term>
232 <listitem>
233 <para>is a daemon used to manage secret (private) keys independently
234 from any protocol. It is used as a backend for <command>gpg</command>
235 and <command>gpgsm</command> as well as for a couple of other
236 utilities.</para>
237 <indexterm zone="gnupg2 gpg-agent">
238 <primary sortas="b-gpg-agent">gpg-agent</primary>
239 </indexterm>
240 </listitem>
241 </varlistentry>
242
243 <varlistentry id="gpg-connect-agent">
244 <term><command>gpg-connect-agent</command></term>
245 <listitem>
246 <para>is a utility used to communicate with a running
247 <command>gpg-agent</command>.</para>
248 <indexterm zone="gnupg2 gpg-connect-agent">
249 <primary sortas="b-gpg-connect-agent">gpg-connect-agent</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="gpg2">
255 <term><command>gpg2</command></term>
256 <listitem>
257 <para>is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a
258 tool used to provide digital encryption and signing services using
259 the OpenPGP standard.</para>
260 <indexterm zone="gnupg2 gpg2">
261 <primary sortas="b-gpg2">gpg2</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="gpgconf">
267 <term><command>gpgconf</command></term>
268 <listitem>
269 <para>is a utility used to automatically and reasonable safely
270 query and modify configuration files in the
271 <filename class='directory'>~/.gnupg</filename> home directory. It is
272 designed not to be invoked manually by the user, but automatically by
273 graphical user interfaces.</para>
274 <indexterm zone="gnupg2 gpgconf">
275 <primary sortas="b-gpgconf">gpgconf</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="gpgparsemail">
281 <term><command>gpgparsemail</command></term>
282 <listitem>
283 <para>is a utility currently only useful for debugging. Run it with
284 <parameter>--help</parameter> for usage information.</para>
285 <indexterm zone="gnupg2 gpgparsemail">
286 <primary sortas="b-gpgparsemail">gpgparsemail</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="gpgsm">
292 <term><command>gpgsm</command></term>
293 <listitem>
294 <para>is a tool similar to <command>gpg</command> used to provide
295 digital encryption and signing services on X.509 certificates and the
296 CMS protocol. It is mainly used as a backend for S/MIME mail
297 processing.</para>
298 <indexterm zone="gnupg2 gpgsm">
299 <primary sortas="b-gpgsm">gpgsm</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="gpgsm-gencert.sh">
305 <term><command>gpgsm-gencert.sh</command></term>
306 <listitem>
307 <para>is a simple tool used to interactively generate a certificate
308 request which will be printed to stdout.</para>
309 <indexterm zone="gnupg2 gpgsm-gencert.sh">
310 <primary sortas="b-gpgsm-gencert.sh">gpgsm-gencert.sh</primary>
311 </indexterm>
312 </listitem>
313 </varlistentry>
314
315 <varlistentry id="gpgv2">
316 <term><command>gpgv2</command></term>
317 <listitem>
318 <para>is a verify only version of <command>gpg2</command>.</para>
319 <indexterm zone="gnupg2 gpgv2">
320 <primary sortas="b-gpgv2">gpgv2</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="kbxutil">
326 <term><command>kbxutil</command></term>
327 <listitem>
328 <para>is used to list, export and import Keybox data.</para>
329 <indexterm zone="gnupg2 kbxutil">
330 <primary sortas="b-kbxutil">kbxutil</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="scdaemon">
336 <term><command>scdaemon</command></term>
337 <listitem>
338 <para>is a daemon used to manage smartcards. It is usually invoked by
339 <command>gpg-agent</command> and in general not used directly.</para>
340 <indexterm zone="gnupg2 scdaemon">
341 <primary sortas="b-scdaemon">scdaemon</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="symcryptrun">
347 <term><command>symcryptrun</command></term>
348 <listitem>
349 <para>is a simple symmetric encryption tool.</para>
350 <indexterm zone="gnupg2 symcryptrun">
351 <primary sortas="b-symcryptrun">symcryptrun</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="watchgnupg">
357 <term><command>watchgnupg</command></term>
358 <listitem>
359 <para>is used to listen to a Unix Domain socket created by any of
360 the GnuPG tools.</para>
361 <indexterm zone="gnupg2 watchgnupg">
362 <primary sortas="b-watchgnupg">watchgnupg</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 </variablelist>
368
369 </sect2>
370
371</sect1>
Note: See TracBrowser for help on using the repository browser.