gnupg/doc/gnupg.texi

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

242 lines
5.5 KiB
Plaintext
Raw Normal View History

2003-01-09 14:24:01 +01:00
\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename gnupg.info
@include defs.inc
@settitle Using the GNU Privacy Guard
2005-09-06 20:42:13 +02:00
@c A couple of macros with no effect on texinfo
2011-08-12 14:40:47 +02:00
@c but used by the yat2m processor.
2005-09-06 20:42:13 +02:00
@macro manpage {a}
@end macro
@macro mansect {a}
@end macro
2011-08-12 14:40:47 +02:00
@macro manpause
2005-09-06 20:42:13 +02:00
@end macro
@macro mancont
@end macro
@c Create a separate index for command line options.
@defcodeindex op
@c Create an index vor environment variables and files.
@defcodeindex ef
@c Merge the function index into the concept index.
@syncodeindex fn cp
@c Merge the variable index into the concept index.
@syncodeindex vr cp
@c Merge the keystroke index into the concept index.
@syncodeindex ky cp
@c Merge the program index into the concept index.
@syncodeindex pg cp
@c Merge the data type index into the concept index.
@syncodeindex tp cp
@c %**end of header
@copying
2005-09-06 20:42:13 +02:00
This is the @cite{The GNU Privacy Guard Manual} (version
2007-03-08 19:31:56 +01:00
@value{VERSION}, @value{UPDATED-MONTH}).
@iftex
Published by The GnuPG Project@*
@url{https://gnupg.org}@*
(or @url{http://ic6au7wa3f6naxjq.onion})
@end iftex
2003-01-09 14:24:01 +01:00
@copyright{} 2002, 2004, 2005, 2006, 2007, 2010 Free Software Foundation, Inc.@*
g10: Add TOFU support. * configure.ac: Check for sqlite3. (SQLITE3_CFLAGS): AC_SUBST it. (SQLITE3_LIBS): Likewise. * g10/Makefile.am (AM_CFLAGS): Add $(SQLITE3_CFLAGS). (gpg2_SOURCES): Add tofu.h and tofu.c. (gpg2_LDADD): Add $(SQLITE3_LIBS). * g10/tofu.c: New file. * g10/tofu.h: New file. * g10/options.h (trust_model): Define TM_TOFU and TM_TOFU_PGP. (tofu_db_format): Define. * g10/packet.h (PKT_signature): Add fields digest and digest_len. * g10/gpg.c: Include "tofu.h". (cmd_and_opt_values): Declare aTOFUPolicy, oTOFUDefaultPolicy, oTOFUDBFormat. (opts): Add them. (parse_trust_model): Recognize the tofu and tofu+pgp trust models. (parse_tofu_policy): New function. (parse_tofu_db_format): New function. (main): Initialize opt.tofu_default_policy and opt.tofu_db_format. Handle aTOFUPolicy, oTOFUDefaultPolicy and oTOFUDBFormat. * g10/mainproc.c (do_check_sig): If the signature is good, copy the hash to SIG->DIGEST and set SIG->DIGEST_LEN appropriately. * g10/trustdb.h (get_validity): Add arguments sig and may_ask. Update callers. (tdb_get_validity_core): Add arguments sig and may_ask. Update callers. * g10/trust.c (get_validity) Add arguments sig and may_ask. Pass them to tdb_get_validity_core. * g10/trustdb.c: Include "tofu.h". (trust_model_string): Handle TM_TOFU and TM_TOFU_PGP. (tdb_get_validity_core): Add arguments sig and may_ask. If OPT.TRUST_MODEL is TM_TOFU or TM_TOFU_PGP, compute the TOFU trust level. Combine it with the computed PGP trust level, if appropriate. * g10/keyedit.c: Include "tofu.h". (show_key_with_all_names_colon): If the trust mode is tofu or tofu+pgp, then show the trust policy. * g10/keylist.c: Include "tofu.h". (public_key_list): Also show the PGP stats if the trust model is TM_TOFU_PGP. (list_keyblock_colon): If the trust mode is tofu or tofu+pgp, then show the trust policy. * g10/pkclist.c: Include "tofu.h". * g10/gpgv.c (get_validity): Add arguments sig and may_ask. (enum tofu_policy): Define. (tofu_get_policy): New stub. (tofu_policy_str): Likewise. * g10/test-stubs.c (get_validity): Add arguments sig and may_ask. (enum tofu_policy): Define. (tofu_get_policy): New stub. (tofu_policy_str): Likewise. * doc/DETAILS: Describe the TOFU Policy field. * doc/gpg.texi: Document --tofu-set-policy, --trust-model=tofu, --trust-model=tofu+pgp, --tofu-default-policy and --tofu-db-format. * tests/openpgp/Makefile.am (TESTS): Add tofu.test. (TEST_FILES): Add tofu-keys.asc, tofu-keys-secret.asc, tofu-2183839A-1.txt, tofu-BC15C85A-1.txt and tofu-EE37CF96-1.txt. (CLEANFILES): Add tofu.db. (clean-local): Add tofu.d. * tests/openpgp/tofu.test: New file. * tests/openpgp/tofu-2183839A-1.txt: New file. * tests/openpgp/tofu-BC15C85A-1.txt: New file. * tests/openpgp/tofu-EE37CF96-1.txt: New file. * tests/openpgp/tofu-keys.asc: New file. * tests/openpgp/tofu-keys-secret.asc: New file. -- Signed-off-by: Neal H. Walfield <neal@g10code.com>.
2015-10-18 18:44:05 +02:00
@copyright{} 2013, 2014, 2015 Werner Koch.@*
@copyright{} 2015, 2016, 2017 g10 Code GmbH.
@quotation
2003-01-09 14:24:01 +01:00
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License as published by the
2007-07-04 21:49:40 +02:00
Free Software Foundation; either version 3 of the License, or (at your
option) any later version. The text of the license can be found in the
section entitled ``Copying''.
@end quotation
@end copying
2003-01-09 14:24:01 +01:00
@dircategory GNU Utilities
@direntry
* gpg2: (gnupg). OpenPGP encryption and signing tool.
* gpgsm: (gnupg). S/MIME encryption and signing tool.
2010-06-10 12:39:44 +02:00
* gpg-agent: (gnupg). The secret key daemon.
* dirmngr: (gnupg). X.509 CRL and OCSP server.
* dirmngr-client: (gnupg). X.509 CRL and OCSP client.
@end direntry
2003-01-09 14:24:01 +01:00
@c
@c Printing stuff taken from gcc.
@c
2003-01-09 14:24:01 +01:00
@macro gnupgtabopt{body}
@code{\body\}
@end macro
@macro gnupgoptlist{body}
@smallexample
\body\
@end smallexample
@end macro
@c Makeinfo handles the above macro OK, TeX needs manual line breaks;
@c they get lost at some point in handling the macro. But if @macro is
@c used here rather than @alias, it produces double line breaks.
@iftex
@alias gol = *
@end iftex
@ifnottex
@macro gol
@end macro
@end ifnottex
@c
@c Titlepage
@c
2003-01-09 14:24:01 +01:00
@setchapternewpage odd
@titlepage
@title Using the GNU Privacy Guard
@subtitle Version @value{VERSION}
2007-03-08 19:31:56 +01:00
@subtitle @value{UPDATED-MONTH}
2006-06-20 19:47:10 +02:00
@sp 3
@image{gnupg-logo,,,The GnuPG Logo}
2006-06-20 19:47:10 +02:00
@sp 3
@author The GnuPG Project (@url{https://gnupg.org})
2003-01-09 14:24:01 +01:00
@page
@vskip 0pt plus 1filll
@insertcopying
2003-01-09 14:24:01 +01:00
@end titlepage
@ifnothtml
2003-01-09 14:24:01 +01:00
@summarycontents
@contents
@page
@end ifnothtml
2003-01-09 14:24:01 +01:00
2007-05-08 10:15:55 +02:00
@ifhtml
2011-08-12 14:40:47 +02:00
@center @image{gnupg-logo-tr,6cm,,The GnuPG Logo}
2007-05-08 10:15:55 +02:00
@end ifhtml
@ifnottex
2003-01-09 14:24:01 +01:00
@node Top
2011-08-12 14:40:47 +02:00
@top
@insertcopying
2003-01-09 14:24:01 +01:00
This manual documents how to use the GNU Privacy Guard system as well as
the administration and the architecture.
@end ifnottex
2003-01-09 14:24:01 +01:00
@menu
2006-09-22 20:15:18 +02:00
* Installation:: A short installation guide.
2006-11-11 15:17:09 +01:00
* Invoking GPG-AGENT:: How to launch the secret key daemon.
2010-06-10 12:39:44 +02:00
* Invoking DIRMNGR:: How to launch the CRL and OCSP daemon.
* Invoking GPG:: Using the OpenPGP protocol.
2003-01-09 14:24:01 +01:00
* Invoking GPGSM:: Using the S/MIME protocol.
* Invoking SCDAEMON:: How to handle Smartcards.
2006-09-08 19:02:06 +02:00
* Specify a User ID:: How to Specify a User Id.
* Trust Values:: How GnuPG displays trust values.
2003-01-09 14:24:01 +01:00
* Helper Tools:: Description of small helper tools
* Web Key Service:: Tools for the Web Key Service
2003-01-09 14:24:01 +01:00
2007-05-08 15:59:41 +02:00
* Howtos:: How to do certain things.
* System Notes:: Notes pertaining to certain OSes.
* Debugging:: How to solve problems
2006-09-22 20:15:18 +02:00
2003-01-09 14:24:01 +01:00
* Copying:: GNU General Public License says
how you can copy and share GnuPG
* Contributors:: People who have contributed to GnuPG.
* Glossary:: Short description of terms used.
2003-01-09 14:24:01 +01:00
* Option Index:: Index to command line options.
* Environment Index:: Index to environment variables and files.
2003-01-09 14:24:01 +01:00
* Index:: Index of concepts and symbol names.
@end menu
@ifhtml
@page
@summarycontents
@contents
@end ifhtml
2006-09-22 20:15:18 +02:00
@include instguide.texi
2006-11-11 15:17:09 +01:00
@include gpg-agent.texi
2010-06-10 12:39:44 +02:00
@include dirmngr.texi
@include gpg.texi
2003-01-09 14:24:01 +01:00
@include gpgsm.texi
@include scdaemon.texi
2006-09-08 19:02:06 +02:00
@node Specify a User ID
@chapter How to Specify a User Id
@anchor{how-to-specify-a-user-id}
@include specify-user-id.texi
@node Trust Values
@chapter Trust Values
@anchor{trust-values}
@cindex trust values
@include trust-values.texi
2006-09-08 19:02:06 +02:00
@include tools.texi
@include wks.texi
2007-05-08 15:59:41 +02:00
@include howtos.texi
@include sysnotes.texi
2003-01-09 14:24:01 +01:00
@include debugging.texi
2003-01-09 14:24:01 +01:00
@include gpl.texi
@include contrib.texi
@c ---------------------------------------------------------------------
@c Indexes
@c ---------------------------------------------------------------------
2004-06-28 09:42:33 +02:00
@include glossary.texi
2003-01-09 14:24:01 +01:00
@node Option Index
@unnumbered Option Index
@printindex op
@node Environment Index
@unnumbered Environment Variable and File Index
@printindex ef
2003-01-09 14:24:01 +01:00
@node Index
@unnumbered Index
@printindex cp
@c ---------------------------------------------------------------------
@c Epilogue
@c ---------------------------------------------------------------------
2010-06-10 12:39:44 +02:00
@c @node History
@c @unnumbered History
2011-08-12 14:40:47 +02:00
@c
@c Here are the notices from the old dirmngr manual:
2010-06-10 12:39:44 +02:00
@c
@c @itemize
@c @item Using DirMngr, 2002, Steffen Hansen, Klar"alvdalens Datakonsult AB.
@c @item Using DirMngr, 2004, 2005, 2006, 2008 Werner Koch, g10 Code GmbH.
@c @end itemize
2011-08-12 14:40:47 +02:00
@c
2010-06-10 12:39:44 +02:00
2003-01-09 14:24:01 +01:00
@bye