Changeset b71b5c8 for postlfs/security/gnupg2-systemd.xml
- Timestamp:
- 10/26/2014 01:56:10 PM (10 years ago)
- Branches:
- krejzi/svn
- Children:
- cb9c6940
- Parents:
- 032be17
- File:
-
- 1 moved
Legend:
- Unmodified
- Added
- Removed
-
postlfs/security/gnupg2-systemd.xml
r032be17 rb71b5c8 30 30 <title>Introduction to GnuPG</title> 31 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> 32 <para> 33 The <application>GnuPG</application> package is GNU's tool for secure 34 communication and data storage. It can be used to encrypt data and to 35 create digital signatures. It includes an advanced key management 36 facility and is compliant with the proposed OpenPGP Internet standard 37 as described in RFC2440 and the S/MIME standard as described by several 38 RFCs. GnuPG 2 is the stable version of GnuPG integrating support for 39 OpenPGP and S/MIME. 40 </para> 39 41 40 42 &lfs76_checked; … … 43 45 <itemizedlist spacing="compact"> 44 46 <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> 47 <para> 48 Download (HTTP): <ulink url="&gnupg2-download-http;"/> 49 </para> 50 </listitem> 51 <listitem> 52 <para> 53 Download (FTP): <ulink url="&gnupg2-download-ftp;"/> 54 </para> 55 </listitem> 56 <listitem> 57 <para> 58 Download MD5 sum: &gnupg2-md5sum; 59 </para> 60 </listitem> 61 <listitem> 62 <para> 63 Download size: &gnupg2-size; 64 </para> 65 </listitem> 66 <listitem> 67 <para> 68 Estimated disk space required: &gnupg2-buildsize; 69 </para> 70 </listitem> 71 <listitem> 72 <para> 73 Estimated build time: &gnupg2-time; 74 </para> 61 75 </listitem> 62 76 </itemizedlist> 63 77 64 <bridgehead renderas="sect3">GnuPG 2Dependencies</bridgehead>78 <bridgehead renderas="sect3">GnuPG Dependencies</bridgehead> 65 79 66 80 <bridgehead renderas="sect4">Required</bridgehead> 67 <para role="required"><xref linkend="pth"/>, 68 <xref linkend="libassuan"/>, 69 <xref linkend="libgcrypt"/>, and 70 <xref linkend="libksba"/></para> 81 <para role="required"> 82 <xref linkend="libassuan"/>, 83 <xref linkend="libgcrypt"/>, 84 <xref linkend="libksba"/> and 85 <xref linkend="pth"/> 86 </para> 71 87 72 88 <bridgehead renderas="sect4">Recommended</bridgehead> 73 <para role="recommended"><xref linkend="pinentry"/> (Run-time requirement for most of 74 the package's functionality)</para> 89 <para role="recommended"> 90 <xref linkend="pinentry"/> (Run-time requirement for 91 most of the package's functionality) 92 </para> 75 93 76 94 <bridgehead renderas="sect4">Optional</bridgehead> 77 <para role="optional"><xref linkend="openldap"/>, 78 <xref linkend="libusb-compat"/>, 79 <xref linkend="curl"/>, 80 <ulink url="http://www.chiark.greenend.org.uk/~ian/adns/">GNU 81 adns</ulink>, and an 82 <xref linkend="server-mail"/></para> 95 <para role="optional"> 96 <xref linkend="curl"/>, 97 <ulink url="http://www.chiark.greenend.org.uk/~ian/adns/">GNU 98 ADNS</ulink>, 99 <xref linkend="libusb-compat"/>, 100 an <xref linkend="server-mail"/> and 101 <xref linkend="openldap"/> 102 </para> 83 103 84 104 <para condition="html" role="usernotes">User Notes: 85 <ulink url="&blfs-wiki;/gnupg2"/></para>86 105 <ulink url="&blfs-wiki;/gnupg2"/> 106 </para> 87 107 </sect2> 88 108 … … 90 110 <title>Installation of GnuPG</title> 91 111 92 <para>Install <application>GnuPG</application> by running the following 93 commands:</para> 94 95 <screen><userinput>./configure --prefix=/usr \ 112 <para> 113 Install <application>GnuPG</application> by running the following 114 commands: 115 </para> 116 117 <screen><userinput>./configure --prefix=/usr \ 118 --sysconfdir=/etc \ 96 119 --enable-symcryptrun \ 97 120 --docdir=/usr/share/doc/gnupg-&gnupg2-version; && … … 101 124 makeinfo --plaintext -o doc/gnupg.txt doc/gnupg.texi</userinput></screen> 102 125 103 <para>If you have <xref linkend="texlive"/> 104 installed and you wish to create documentation in alternate formats, 105 issue the following commands:</para> 126 <para> 127 If you have <xref linkend="texlive"/> installed and you wish 128 to create documentation in alternate formats, issue the 129 following commands: 130 </para> 106 131 107 132 <screen><userinput>make -C doc pdf ps html</userinput></screen> 108 133 109 <para>To test the results, issue: <command>make check</command>.</para> 110 111 <para>Note that if you have already installed 112 <application>GnuPG</application>, the instructions below will overwrite 113 <filename>/usr/share/man/man1/gpg-zip.1</filename>. Now, as the 114 <systemitem class="username">root</systemitem> user:</para> 115 116 <screen role="root"><userinput>make install && 117 118 install -v -m755 -d /usr/share/doc/gnupg-&gnupg2-version;/html && 119 install -v -m644 doc/gnupg_nochunks.html \ 120 /usr/share/doc/gnupg-&gnupg2-version;/gnupg.html && 121 install -v -m644 doc/*.texi doc/gnupg.txt \ 122 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen> 123 124 <para>We recommend the creation of symlinks for compatibility with the first 125 version of GnuPG, because some programs or scripts need them. Issue, as 126 <systemitem class="username">root</systemitem> user:</para> 127 128 <screen role="root"><userinput>for f in gpg gpgv 129 do 130 ln -svf ${f}2.1 /usr/share/man/man1/$f.1 && 131 ln -svf ${f}2 /usr/bin/$f 132 done 133 unset f</userinput></screen> 134 135 <para>If you created alternate formats of the documentation, install it 136 using the following command as the 137 <systemitem class="username">root</systemitem> user:</para> 134 <para> 135 To test the results, issue: <command>make check</command>. 136 </para> 137 138 <para> 139 Now, as the <systemitem class="username">root</systemitem> user: 140 </para> 141 142 <screen role="root"><userinput>make install && 143 144 for f in gpg gpgv ; do 145 ln -sfv ${f}2 /usr/bin/${f} && 146 ln -sfv ${f}2.1 /usr/share/man/man1/${f}.1 147 done && 148 149 install -v -dm755 /usr/share/doc/gnupg-&gnupg2-version;/html && 150 install -v -m644 doc/gnupg_nochunks.html \ 151 /usr/share/doc/gnupg-&gnupg2-version;/gnupg.html && 152 install -v -m644 doc/*.texi doc/gnupg.txt \ 153 /usr/share/doc/gnupg-&gnupg2-version;</userinput></screen> 154 155 <para> 156 If you created alternate formats of the documentation, install 157 it using the following command as the 158 <systemitem class="username">root</systemitem> user: 159 </para> 138 160 139 161 <screen role="root"><userinput>install -v -m644 doc/gnupg.html/* \ … … 147 169 <title>Command Explanations</title> 148 170 149 <para><parameter>--docdir=/usr/share/doc/gnupg-&gnupg2-version;</parameter>: 150 This switch changes the default docdir to <filename 151 class="directory">/usr/share/doc/gnupg-&gnupg2-version;</filename>.</para> 152 153 <para><parameter>--enable-symcryptrun</parameter>: This switch enables 154 building the symcryptrun program.</para> 171 <para> 172 <parameter>--enable-symcryptrun</parameter>: This switch enables 173 building the symcryptrun program. 174 </para> 175 176 <para> 177 <command>ln -sfv ...</command>: This command creates symlinks for 178 compatibility with the first version of 179 <application>GnuPG</application>. 180 </para> 155 181 156 182 </sect2> … … 165 191 166 192 <seglistitem> 167 <seg>addgnupghome, applygnupgdefaults, gnupg-pcsc-wrapper, gpg, 168 gpg-agent, gpg-check-pattern, gpg-connect-agent, gpg-preset-passphrase, 169 gpg-protect-tool, gpg2, gpg2keys_curl, gpg2keys_finger, gpg2keys_hkp, 170 gpg2keys_ldap, gpgconf, gpgkey2ssh, gpgparsemail, gpgsm, 171 gpgsm-gencert.sh, gpgv, gpgv2, kbxutil, scdaemon, symcryptrun, 172 and watchgnupg</seg> 173 <seg>None</seg> 174 <seg>/usr/share/doc/gnupg-&gnupg2-version; and 175 /usr/share/gnupg</seg> 193 <seg> 194 addgnupghome, applygnupgdefaults, gpg, gpg2, gpg-agent, 195 gpgconf, gpg-connect-agent, gpgkey2ssh, gpgparsemail, 196 gpgsm, gpgsm-gencert.sh, gpgtar, gpgv, gpgv2, kbxutil, 197 scdaemon, symcryptrun and watchgnupg 198 </seg> 199 <seg> 200 None 201 </seg> 202 <seg> 203 /usr/share/doc/gnupg-&gnupg2-version; and 204 /usr/share/gnupg 205 </seg> 176 206 </seglistitem> 177 207 </segmentedlist> … … 185 215 <term><command>addgnupghome</command></term> 186 216 <listitem> 187 <para>is used to create and populate user's 188 <filename class='directory'>~/.gnupg</filename> directories</para> 217 <para> 218 is used to create and populate user's 219 <filename class="directory">~/.gnupg</filename> directories. 220 </para> 189 221 <indexterm zone="gnupg2 addgnupghome"> 190 222 <primary sortas="b-addgnupghome">addgnupghome</primary> … … 196 228 <term><command>applygnupgdefaults</command></term> 197 229 <listitem> 198 <para>is a wrapper script used to run <command>gpgconf</command> 199 with the <parameter>--apply-defaults</parameter> parameter on all 200 user's GnuPG home directories.</para> 230 <para> 231 is a wrapper script used to run <command>gpgconf</command> 232 with the <parameter>--apply-defaults</parameter> parameter 233 on all user's GnuPG home directories. 234 </para> 201 235 <indexterm zone="gnupg2 applygnupgdefaults"> 202 236 <primary sortas="b-applygnupgdefaults">applygnupgdefaults</primary> … … 208 242 <term><command>gpg-agent</command></term> 209 243 <listitem> 210 <para>is a daemon used to manage secret (private) keys independently 211 from any protocol. It is used as a backend for <command>gpg2</command> 212 and <command>gpgsm</command> as well as for a couple of other 213 utilities.</para> 244 <para> 245 is a daemon used to manage secret (private) keys independently 246 from any protocol. It is used as a backend for 247 <command>gpg</command> and <command>gpgsm</command> as well as 248 for a couple of other utilities. 249 </para> 214 250 <indexterm zone="gnupg2 gpg-agent"> 215 251 <primary sortas="b-gpg-agent">gpg-agent</primary> … … 221 257 <term><command>gpg-connect-agent</command></term> 222 258 <listitem> 223 <para>is a utility used to communicate with a running 224 <command>gpg-agent</command>.</para> 259 <para> 260 is a utility used to communicate with a running 261 <command>gpg-agent</command>. 262 </para> 225 263 <indexterm zone="gnupg2 gpg-connect-agent"> 226 264 <primary sortas="b-gpg-connect-agent">gpg-connect-agent</primary> … … 232 270 <term><command>gpg</command></term> 233 271 <listitem> 234 <para>(optional) is a symlink to <command>gpg2</command> for 235 compatibility with the first version of GnuPG.</para> 272 <para> 273 is a symlink to <command>gpg2</command> for compatibility 274 with the first version of <application>GnuPG</application>. 275 </para> 236 276 <indexterm zone="gnupg2 gpg"> 237 277 <primary sortas="b-gpg">gpg</primary> … … 243 283 <term><command>gpg2</command></term> 244 284 <listitem> 245 <para>is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a 246 tool used to provide digital encryption and signing services using 247 the OpenPGP standard.</para> 285 <para> 286 is the OpenPGP part of the GNU Privacy Guard (GnuPG). It is a 287 tool used to provide digital encryption and signing services 288 using the OpenPGP standard. 289 </para> 248 290 <indexterm zone="gnupg2 gpg2"> 249 291 <primary sortas="b-gpg2">gpg2</primary> … … 255 297 <term><command>gpgconf</command></term> 256 298 <listitem> 257 <para>is a utility used to automatically and reasonable safely 258 query and modify configuration files in the 259 <filename class='directory'>~/.gnupg</filename> home directory. It is 260 designed not to be invoked manually by the user, but automatically by 261 graphical user interfaces.</para> 299 <para> 300 is a utility used to automatically and reasonable safely 301 query and modify configuration files in the 302 <filename class="directory">~/.gnupg</filename> home 303 directory. It is designed not to be invoked manually by 304 the user, but automatically by graphical user interfaces. 305 </para> 262 306 <indexterm zone="gnupg2 gpgconf"> 263 307 <primary sortas="b-gpgconf">gpgconf</primary> … … 269 313 <term><command>gpgparsemail</command></term> 270 314 <listitem> 271 <para>is a utility currently only useful for debugging. Run it with 272 <parameter>--help</parameter> for usage information.</para> 315 <para> 316 is a utility currently only useful for debugging. Run it with 317 <parameter>--help</parameter> for usage information. 318 </para> 273 319 <indexterm zone="gnupg2 gpgparsemail"> 274 320 <primary sortas="b-gpgparsemail">gpgparsemail</primary> … … 280 326 <term><command>gpgsm</command></term> 281 327 <listitem> 282 <para>is a tool similar to <command>gpg2</command> used to provide 283 digital encryption and signing services on X.509 certificates and the 284 CMS protocol. It is mainly used as a backend for S/MIME mail 285 processing.</para> 328 <para> 329 is a tool similar to <command>gpg</command> used to provide digital 330 encryption and signing services on X.509 certificates and the CMS 331 protocol. It is mainly used as a backend for S/MIME mail processing. 332 </para> 286 333 <indexterm zone="gnupg2 gpgsm"> 287 334 <primary sortas="b-gpgsm">gpgsm</primary> … … 293 340 <term><command>gpgsm-gencert.sh</command></term> 294 341 <listitem> 295 <para>is a simple tool used to interactively generate a certificate 296 request which will be printed to stdout.</para> 342 <para> 343 is a simple tool used to interactively generate a certificate 344 request which will be printed to stdout. 345 </para> 297 346 <indexterm zone="gnupg2 gpgsm-gencert.sh"> 298 347 <primary sortas="b-gpgsm-gencert.sh">gpgsm-gencert.sh</primary> … … 304 353 <term><command>gpgv</command></term> 305 354 <listitem> 306 <para>(optional) is a symlink to <command>gpgv2</command> for 307 compatibility with the first version of GnuPG.</para> 355 <para> 356 is a symlink to <command>gpgv2</command> for compatibility 357 with the first version of <application>GnuPG</application>. 358 </para> 308 359 <indexterm zone="gnupg2 gpgv"> 309 360 <primary sortas="b-gpgv">gpgv</primary> … … 315 366 <term><command>gpgv2</command></term> 316 367 <listitem> 317 <para>is a verify only version of <command>gpg2</command>.</para> 368 <para> 369 is a verify only version of <command>gpg2</command>. 370 </para> 318 371 <indexterm zone="gnupg2 gpgv2"> 319 372 <primary sortas="b-gpgv2">gpgv2</primary> … … 325 378 <term><command>kbxutil</command></term> 326 379 <listitem> 327 <para>is used to list, export and import Keybox data.</para> 380 <para> 381 is used to list, export and import Keybox data. 382 </para> 328 383 <indexterm zone="gnupg2 kbxutil"> 329 384 <primary sortas="b-kbxutil">kbxutil</primary> … … 335 390 <term><command>scdaemon</command></term> 336 391 <listitem> 337 <para>is a daemon used to manage smartcards. It is usually invoked by 338 <command>gpg-agent</command> and in general not used directly.</para> 392 <para> 393 is a daemon used to manage smartcards. It is usually invoked by 394 <command>gpg-agent</command> and in general not used directly. 395 </para> 339 396 <indexterm zone="gnupg2 scdaemon"> 340 397 <primary sortas="b-scdaemon">scdaemon</primary> … … 346 403 <term><command>symcryptrun</command></term> 347 404 <listitem> 348 <para>is a simple symmetric encryption tool.</para> 405 <para> 406 is a simple symmetric encryption tool. 407 </para> 349 408 <indexterm zone="gnupg2 symcryptrun"> 350 409 <primary sortas="b-symcryptrun">symcryptrun</primary> … … 356 415 <term><command>watchgnupg</command></term> 357 416 <listitem> 358 <para>is used to listen to a Unix Domain socket created by any of 359 the GnuPG tools.</para> 417 <para> 418 is used to listen to a Unix Domain socket created by any of 419 the GnuPG tools. 420 </para> 360 421 <indexterm zone="gnupg2 watchgnupg"> 361 422 <primary sortas="b-watchgnupg">watchgnupg</primary>
Note:
See TracChangeset
for help on using the changeset viewer.