source: postlfs/security/gnupg2.xml@ 350452c

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 350452c was 350452c, checked in by Randy McMurchy <randy@…>, 13 years ago

Changed hard-coded URLs to use the Anduin entity

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

  • Property mode set to 100644
File size: 13.2 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 "&sources-anduin-http;/g/gnupg-&gnupg2-version;.tar.bz2">
8 <!-- <!ENTITY gnupg2-download-http "http://public.ftp.planetmirror.com/pub/gnupg/gnupg-&gnupg2-version;.tar.bz2"> -->
9 <!ENTITY gnupg2-download-ftp "ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-&gnupg2-version;.tar.bz2">
10 <!ENTITY gnupg2-md5sum "fc4377ca67e1bf687eeaf22e79c0b9d1">
11 <!ENTITY gnupg2-size "3.6 MB">
12 <!ENTITY gnupg2-buildsize "65 MB">
13 <!ENTITY gnupg2-time "0.7 SBU">
14]>
15
16<sect1 id="gnupg2" xreflabel="GnuPG-&gnupg2-version;">
17 <?dbhtml filename="gnupg2.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>GnuPG-&gnupg2-version;</title>
25
26 <indexterm zone="gnupg2">
27 <primary sortas="a-GnuPG-2">GnuPG 2</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to GnuPG 2</title>
32
33 <para>The <application>GnuPG 2</application> package is GNU's tool for
34 secure communication and data storage. It can be used to encrypt data and
35 to create digital signatures. It includes an advanced key management
36 facility and is compliant with the proposed OpenPGP Internet standard as
37 described in RFC2440 and the S/MIME standard as described by several RFCs.
38 GnuPG 2 is the stable version of GnuPG integrating support for OpenPGP and
39 S/MIME. It does not conflict with an installed <xref linkend="gnupg"/>
40 OpenPGP-only version.</para>
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">Additional Downloads</bridgehead>
65 <itemizedlist spacing='compact'>
66 <listitem>
67 <para>Required Patch: <ulink
68 url="&patch-root;/gnupg2-&gnupg2-version;-curl_LDAP-1.patch"/>
69 </para>
70 </listitem>
71 </itemizedlist> -->
72
73 <bridgehead renderas="sect3">GnuPG Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required"><xref linkend="pth"/>,
77 <xref linkend="libassuan"/>,
78 <xref linkend="libgcrypt"/>, and
79 <xref linkend="libksba"/></para>
80
81 <bridgehead renderas="sect4">Optional</bridgehead>
82 <para role="optional"><xref linkend="openldap"/>,
83 <xref linkend="libusb"/>,
84 <xref linkend="curl"/>, and
85 an <xref linkend="server-mail"/></para>
86
87 <bridgehead renderas="sect4">Optional (Run-time Requirement For Most of
88 the Package's Functionality)</bridgehead>
89 <para role="optional"><xref linkend="pinentry"/></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 2</title>
98
99 <para>Install <application>GnuPG 2</application> by running the following
100 commands:</para>
101
102<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/gnupg2 &amp;&amp;
103make</userinput></screen>
104
105 <para>If you have <xref linkend="tetex"/> installed and you wish to create
106 documentation in alternate formats, issue the following commands:</para>
107
108<screen><userinput>make -C doc pdf ps html &amp;&amp;
109makeinfo --html --no-split -o doc/gnupg_nochunks.html doc/gnupg.texi &amp;&amp;
110makeinfo --plaintext -o doc/gnupg.txt doc/gnupg.texi</userinput></screen>
111
112 <para>To test the results, issue: <command>make check</command>.</para>
113
114 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
115
116 <!-- Removing this from the commands as it doesn't appear
117 necessary any longer. See the gnupg.texi file (or some
118 TeX derivative) for additional information.
119
120 chmod -v 4755 /usr/bin/gpg &amp;&amp;
121 -->
122
123<screen role="root"><userinput>make install &amp;&amp;
124
125install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
126ln -sv ../../gnupg/FAQ /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
127ln -sv ../../gnupg/faq.html /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
128
129install -v -m644 doc/{DETAILS,KEYSERVER,OpenPGP,TRANSLATE} \
130 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
131
132 <para>If you created alternate formats of the documentation, install it
133 using the following command as the
134 <systemitem class="username">root</systemitem> user:</para>
135
136<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
137install -v -m644 doc/gnupg.html/* \
138 /usr/share/doc/gnupg-&gnupg2-version;/html &amp;&amp;
139install -v -m644 doc/gnupg_nochunks.html \
140 /usr/share/doc/gnupg-&gnupg2-version;/gnupg.html &amp;&amp;
141install -v -m644 doc/*.texi \
142 /usr/share/doc/gnupg-&gnupg2-version; &amp;&amp;
143install -v -m644 doc/gnupg.{pdf,dvi,ps,txt} \
144 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen>
145
146 </sect2>
147
148 <sect2 role="commands">
149 <title>Command Explanations</title>
150
151 <para><parameter>--libexecdir=/usr/lib/gnupg2</parameter>: This switch
152 creates a <filename class="directory">gnupg</filename> directory in
153 <filename class="directory">/usr/lib</filename> instead of
154 <filename class="directory">/usr/libexec</filename>.</para>
155
156 <!-- See above why this is no longer included
157 <para><command>chmod -v 4755 /usr/bin/gpg</command>:
158 <command>gpg</command> is installed setuid
159 <systemitem class='username'>root</systemitem> to avoid swapping
160 out sensitive data.</para>
161 -->
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, gpg-agent, gpg-connect-agent,
175 gpg2, gpgconf, gpgkey2ssh, gpgparsemail, gpgsm, gpgsm-gencert.sh,
176 gpgv2, kbxutil, scdaemon, symcryptrun, and watchgnupg</seg>
177 <seg>None</seg>
178 <seg>/usr/lib/gnupg2, /usr/share/gnupg and
179 /usr/share/doc/gnupg2-&gnupg2-version;</seg>
180 </seglistitem>
181 </segmentedlist>
182
183 <variablelist>
184 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
185 <?dbfo list-presentation="list"?>
186 <?dbhtml list-presentation="table"?>
187
188 <varlistentry id="addgnupghome">
189 <term><command>addgnupghome</command></term>
190 <listitem>
191 <para>is used to create and populate user's
192 <filename class='directory'>~/.gnupg</filename> directories</para>
193 <indexterm zone="gnupg2 addgnupghome">
194 <primary sortas="b-addgnupghome">addgnupghome</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="applygnupgdefaults">
200 <term><command>applygnupgdefaults</command></term>
201 <listitem>
202 <para>is a wrapper script used to run <command>gpgconf</command>
203 with the <parameter>--apply-defaults</parameter> parameter on all
204 user's GnuPG home directories.</para>
205 <indexterm zone="gnupg2 applygnupgdefaults">
206 <primary sortas="b-applygnupgdefaults">applygnupgdefaults</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="gpg-agent">
212 <term><command>gpg-agent</command></term>
213 <listitem>
214 <para>is a daemon used to manage secret (private) keys independently
215 from any protocol. It is used as a backend for <command>gpg</command>
216 and <command>gpgsm</command> as well as for a couple of other
217 utilities.</para>
218 <indexterm zone="gnupg2 gpg-agent">
219 <primary sortas="b-gpg-agent">gpg-agent</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="gpg-connect-agent">
225 <term><command>gpg-connect-agent</command></term>
226 <listitem>
227 <para>is a utility used to communicate with a running
228 <command>gpg-agent</command>.</para>
229 <indexterm zone="gnupg2 gpg-connect-agent">
230 <primary sortas="b-gpg-connect-agent">gpg-connect-agent</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="gpg2">
236 <term><command>gpg2</command></term>
237 <listitem>
238 <para>is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a
239 tool used to provide digital encryption and signing services using
240 the OpenPGP standard.</para>
241 <indexterm zone="gnupg2 gpg2">
242 <primary sortas="b-gpg2">gpg2</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="gpgconf">
248 <term><command>gpgconf</command></term>
249 <listitem>
250 <para>is a utility used to automatically and reasonable safely
251 query and modify configuration files in the
252 <filename class='directory'>~/.gnupg</filename> home directory. It is
253 designed not to be invoked manually by the user, but automatically by
254 graphical user interfaces.</para>
255 <indexterm zone="gnupg2 gpgconf">
256 <primary sortas="b-gpgconf">gpgconf</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="gpgparsemail">
262 <term><command>gpgparsemail</command></term>
263 <listitem>
264 <para>is a utility currently only useful for debugging. Run it with
265 <parameter>--help</parameter> for usage information.</para>
266 <indexterm zone="gnupg2 gpgparsemail">
267 <primary sortas="b-gpgparsemail">gpgparsemail</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="gpgsm">
273 <term><command>gpgsm</command></term>
274 <listitem>
275 <para>is a tool similar to <command>gpg</command> used to provide
276 digital encryption and signing services on X.509 certificates and the
277 CMS protocol. It is mainly used as a backend for S/MIME mail
278 processing.</para>
279 <indexterm zone="gnupg2 gpgsm">
280 <primary sortas="b-gpgsm">gpgsm</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="gpgsm-gencert.sh">
286 <term><command>gpgsm-gencert.sh</command></term>
287 <listitem>
288 <para>is a simple tool used to interactivly generate a certificate
289 request which will be printed to stdout.</para>
290 <indexterm zone="gnupg2 gpgsm-gencert.sh">
291 <primary sortas="b-gpgsm-gencert.sh">gpgsm-gencert.sh</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="gpgv2">
297 <term><command>gpgv2</command></term>
298 <listitem>
299 <para>is a verify only version of <command>gpg2</command>.</para>
300 <indexterm zone="gnupg2 gpgv2">
301 <primary sortas="b-gpgv2">gpgv2</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="kbxutil">
307 <term><command>kbxutil</command></term>
308 <listitem>
309 <para>is used to list, export and import Keybox data.</para>
310 <indexterm zone="gnupg2 kbxutil">
311 <primary sortas="b-kbxutil">kbxutil</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="scdaemon">
317 <term><command>scdaemon</command></term>
318 <listitem>
319 <para>is a daemon used to manage smartcards. It is usually invoked by
320 <command>gpg-agent</command> and in general not used directly.</para>
321 <indexterm zone="gnupg2 scdaemon">
322 <primary sortas="b-scdaemon">scdaemon</primary>
323 </indexterm>
324 </listitem>
325 </varlistentry>
326
327 <varlistentry id="symcryptrun">
328 <term><command>symcryptrun</command></term>
329 <listitem>
330 <para>is a simple symmetric encryption tool.</para>
331 <indexterm zone="gnupg2 symcryptrun">
332 <primary sortas="b-symcryptrun">symcryptrun</primary>
333 </indexterm>
334 </listitem>
335 </varlistentry>
336
337 <varlistentry id="watchgnupg">
338 <term><command>watchgnupg</command></term>
339 <listitem>
340 <para>is used to listen to a Unix Domain socket created by any of
341 the GnuPG tools.</para>
342 <indexterm zone="gnupg2 watchgnupg">
343 <primary sortas="b-watchgnupg">watchgnupg</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 </variablelist>
349
350 </sect2>
351
352</sect1>
Note: See TracBrowser for help on using the repository browser.