2003-01-09 13:24:01 +00:00
|
|
|
\input texinfo @c -*-texinfo-*-
|
|
|
|
@c %**start of header
|
|
|
|
@setfilename gnupg.info
|
2015-06-09 21:29:15 +02:00
|
|
|
@include defs.inc
|
2005-01-13 18:00:46 +00:00
|
|
|
@settitle Using the GNU Privacy Guard
|
2005-09-06 18:42:13 +00: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 18:42:13 +00:00
|
|
|
@macro manpage {a}
|
|
|
|
@end macro
|
|
|
|
@macro mansect {a}
|
|
|
|
@end macro
|
2011-08-12 14:40:47 +02:00
|
|
|
@macro manpause
|
2005-09-06 18:42:13 +00:00
|
|
|
@end macro
|
|
|
|
@macro mancont
|
|
|
|
@end macro
|
|
|
|
|
2005-01-13 18:00:46 +00:00
|
|
|
@c Create a separate index for command line options.
|
|
|
|
@defcodeindex op
|
|
|
|
@c Merge the standard indexes into a single one.
|
|
|
|
@syncodeindex fn cp
|
|
|
|
@syncodeindex vr cp
|
|
|
|
@syncodeindex ky cp
|
|
|
|
@syncodeindex pg cp
|
|
|
|
@syncodeindex tp cp
|
|
|
|
@c %**end of header
|
|
|
|
@copying
|
2005-09-06 18:42:13 +00:00
|
|
|
This is the @cite{The GNU Privacy Guard Manual} (version
|
2007-03-08 18:31:56 +00:00
|
|
|
@value{VERSION}, @value{UPDATED-MONTH}).
|
2005-01-13 18:00:46 +00:00
|
|
|
|
|
|
|
@iftex
|
2014-06-25 11:15:45 +02:00
|
|
|
Published by The GnuPG Project@*
|
|
|
|
@url{https://gnupg.org}@*
|
|
|
|
(or @url{http://ic6au7wa3f6naxjq.onion})
|
2005-01-13 18:00:46 +00:00
|
|
|
@end iftex
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2014-06-25 11:15:45 +02: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.@*
|
2015-11-30 11:47:23 +01:00
|
|
|
@copyright{} 2015 g10 Code GmbH.
|
2005-01-13 18:00:46 +00:00
|
|
|
|
|
|
|
@quotation
|
2003-01-09 13:24:01 +00:00
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
2004-09-29 11:04:30 +00:00
|
|
|
under the terms of the GNU General Public License as published by the
|
2007-07-04 19:49:40 +00:00
|
|
|
Free Software Foundation; either version 3 of the License, or (at your
|
2004-09-29 11:04:30 +00:00
|
|
|
option) any later version. The text of the license can be found in the
|
|
|
|
section entitled ``Copying''.
|
2005-01-13 18:00:46 +00:00
|
|
|
@end quotation
|
|
|
|
@end copying
|
2003-01-09 13:24:01 +00:00
|
|
|
|
|
|
|
|
2005-01-13 18:00:46 +00:00
|
|
|
@dircategory GNU Utilities
|
|
|
|
@direntry
|
2006-12-13 16:49:10 +00:00
|
|
|
* gpg2: (gnupg). OpenPGP encryption and signing tool.
|
2005-01-13 18:00:46 +00:00
|
|
|
* gpgsm: (gnupg). S/MIME encryption and signing tool.
|
2010-06-10 10:39:44 +00: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.
|
2005-01-13 18:00:46 +00:00
|
|
|
@end direntry
|
2003-01-09 13:24:01 +00:00
|
|
|
|
|
|
|
|
2005-01-13 18:00:46 +00:00
|
|
|
@c
|
|
|
|
@c Printing stuff taken from gcc.
|
|
|
|
@c
|
2003-01-09 13:24:01 +00: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
|
|
|
|
|
|
|
|
|
2005-01-13 18:00:46 +00:00
|
|
|
@c
|
|
|
|
@c Titlepage
|
|
|
|
@c
|
2003-01-09 13:24:01 +00:00
|
|
|
@setchapternewpage odd
|
|
|
|
@titlepage
|
|
|
|
@title Using the GNU Privacy Guard
|
|
|
|
@subtitle Version @value{VERSION}
|
2007-03-08 18:31:56 +00:00
|
|
|
@subtitle @value{UPDATED-MONTH}
|
2004-12-21 19:05:15 +00:00
|
|
|
|
2006-06-20 17:47:10 +00:00
|
|
|
@sp 3
|
2004-12-21 19:05:15 +00:00
|
|
|
|
2014-06-25 11:15:45 +02:00
|
|
|
@image{gnupg-logo,,,The GnuPG Logo}
|
2004-12-21 19:05:15 +00:00
|
|
|
|
2006-06-20 17:47:10 +00:00
|
|
|
@sp 3
|
2004-12-21 19:05:15 +00:00
|
|
|
|
2014-06-25 11:15:45 +02:00
|
|
|
@author The GnuPG Project (@url{https://gnupg.org})
|
2004-12-21 19:05:15 +00:00
|
|
|
|
2003-01-09 13:24:01 +00:00
|
|
|
@page
|
|
|
|
@vskip 0pt plus 1filll
|
2005-01-13 18:00:46 +00:00
|
|
|
@insertcopying
|
2003-01-09 13:24:01 +00:00
|
|
|
@end titlepage
|
2005-01-13 18:00:46 +00:00
|
|
|
|
2005-06-07 19:09:18 +00:00
|
|
|
@ifnothtml
|
2003-01-09 13:24:01 +00:00
|
|
|
@summarycontents
|
|
|
|
@contents
|
|
|
|
@page
|
2005-06-07 19:09:18 +00:00
|
|
|
@end ifnothtml
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2007-05-08 08:15:55 +00:00
|
|
|
@ifhtml
|
2011-08-12 14:40:47 +02:00
|
|
|
@center @image{gnupg-logo-tr,6cm,,The GnuPG Logo}
|
2007-05-08 08:15:55 +00:00
|
|
|
@end ifhtml
|
|
|
|
|
2005-01-13 18:00:46 +00:00
|
|
|
@ifnottex
|
2003-01-09 13:24:01 +00:00
|
|
|
@node Top
|
2011-08-12 14:40:47 +02:00
|
|
|
@top
|
2005-01-13 18:00:46 +00:00
|
|
|
@insertcopying
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2004-12-22 17:24:13 +00:00
|
|
|
This manual documents how to use the GNU Privacy Guard system as well as
|
2004-02-04 19:13:16 +00:00
|
|
|
the administration and the architecture.
|
2005-01-13 18:00:46 +00:00
|
|
|
@end ifnottex
|
2003-01-09 13:24:01 +00:00
|
|
|
|
|
|
|
@menu
|
2006-09-22 18:15:18 +00:00
|
|
|
* Installation:: A short installation guide.
|
|
|
|
|
2006-11-11 14:17:09 +00:00
|
|
|
* Invoking GPG-AGENT:: How to launch the secret key daemon.
|
2010-06-10 10:39:44 +00:00
|
|
|
* Invoking DIRMNGR:: How to launch the CRL and OCSP daemon.
|
2004-09-30 08:38:32 +00:00
|
|
|
* Invoking GPG:: Using the OpenPGP protocol.
|
2003-01-09 13:24:01 +00:00
|
|
|
* Invoking GPGSM:: Using the S/MIME protocol.
|
|
|
|
* Invoking SCDAEMON:: How to handle Smartcards.
|
2006-09-08 17:02:06 +00:00
|
|
|
* Specify a User ID:: How to Specify a User Id.
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2004-12-22 17:24:13 +00:00
|
|
|
* Helper Tools:: Description of small helper tools
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2007-05-08 13:59:41 +00:00
|
|
|
* Howtos:: How to do certain things.
|
2004-12-21 19:05:15 +00:00
|
|
|
* System Notes:: Notes pertaining to certain OSes.
|
2004-06-18 11:18:27 +00:00
|
|
|
* Debugging:: How to solve problems
|
2006-09-22 18:15:18 +00:00
|
|
|
|
2003-01-09 13:24:01 +00:00
|
|
|
* Copying:: GNU General Public License says
|
|
|
|
how you can copy and share GnuPG
|
|
|
|
* Contributors:: People who have contributed to GnuPG.
|
|
|
|
|
2007-05-04 12:04:26 +00:00
|
|
|
* Glossary:: Short description of terms used.
|
2003-01-09 13:24:01 +00:00
|
|
|
* Option Index:: Index to command line options.
|
|
|
|
* Index:: Index of concepts and symbol names.
|
|
|
|
@end menu
|
|
|
|
|
2005-06-07 19:09:18 +00:00
|
|
|
|
|
|
|
@ifhtml
|
|
|
|
@page
|
|
|
|
@summarycontents
|
|
|
|
@contents
|
|
|
|
@end ifhtml
|
|
|
|
|
|
|
|
|
2006-09-22 18:15:18 +00:00
|
|
|
@include instguide.texi
|
|
|
|
|
2006-11-11 14:17:09 +00:00
|
|
|
@include gpg-agent.texi
|
2010-06-10 10:39:44 +00:00
|
|
|
@include dirmngr.texi
|
2004-09-30 08:38:32 +00:00
|
|
|
@include gpg.texi
|
2003-01-09 13:24:01 +00:00
|
|
|
@include gpgsm.texi
|
|
|
|
@include scdaemon.texi
|
|
|
|
|
2006-09-08 17:02:06 +00: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
|
|
|
|
|
|
|
|
|
2004-12-22 17:24:13 +00:00
|
|
|
@include tools.texi
|
|
|
|
|
2007-05-08 13:59:41 +00:00
|
|
|
@include howtos.texi
|
|
|
|
|
2004-12-21 19:05:15 +00:00
|
|
|
@include sysnotes.texi
|
2003-01-09 13:24:01 +00:00
|
|
|
|
2004-06-18 11:18:27 +00:00
|
|
|
@include debugging.texi
|
|
|
|
|
2003-01-09 13:24:01 +00:00
|
|
|
@include gpl.texi
|
|
|
|
|
|
|
|
@include contrib.texi
|
|
|
|
|
|
|
|
@c ---------------------------------------------------------------------
|
|
|
|
@c Indexes
|
|
|
|
@c ---------------------------------------------------------------------
|
|
|
|
|
2004-06-28 07:42:33 +00:00
|
|
|
@include glossary.texi
|
|
|
|
|
2003-01-09 13:24:01 +00:00
|
|
|
@node Option Index
|
|
|
|
@unnumbered Option Index
|
|
|
|
|
|
|
|
@printindex op
|
|
|
|
|
|
|
|
@node Index
|
|
|
|
@unnumbered Index
|
|
|
|
|
|
|
|
@printindex cp
|
|
|
|
|
|
|
|
@c ---------------------------------------------------------------------
|
|
|
|
@c Epilogue
|
|
|
|
@c ---------------------------------------------------------------------
|
|
|
|
|
2010-06-10 10:39:44 +00: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 10:39:44 +00: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 10:39:44 +00:00
|
|
|
|
|
|
|
|
2003-01-09 13:24:01 +00:00
|
|
|
@bye
|
|
|
|
|
|
|
|
|