mirror of
git://git.gnupg.org/gnupg.git
synced 2024-11-01 20:18:44 +01:00
f77913e0ff
* 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>.
219 lines
4.8 KiB
Plaintext
219 lines
4.8 KiB
Plaintext
\input texinfo @c -*-texinfo-*-
|
|
@c %**start of header
|
|
@setfilename gnupg.info
|
|
@include defs.inc
|
|
@settitle Using the GNU Privacy Guard
|
|
|
|
@c A couple of macros with no effect on texinfo
|
|
@c but used by the yat2m processor.
|
|
@macro manpage {a}
|
|
@end macro
|
|
@macro mansect {a}
|
|
@end macro
|
|
@macro manpause
|
|
@end macro
|
|
@macro mancont
|
|
@end macro
|
|
|
|
@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
|
|
This is the @cite{The GNU Privacy Guard Manual} (version
|
|
@value{VERSION}, @value{UPDATED-MONTH}).
|
|
|
|
@iftex
|
|
Published by The GnuPG Project@*
|
|
@url{https://gnupg.org}@*
|
|
(or @url{http://ic6au7wa3f6naxjq.onion})
|
|
@end iftex
|
|
|
|
@copyright{} 2002, 2004, 2005, 2006, 2007, 2010 Free Software Foundation, Inc.@*
|
|
@copyright{} 2013, 2014, 2015 Werner Koch.@*
|
|
@copyright{} 2015 g10code Gmbh.
|
|
|
|
@quotation
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU General Public License as published by the
|
|
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
|
|
|
|
|
|
@dircategory GNU Utilities
|
|
@direntry
|
|
* gpg2: (gnupg). OpenPGP encryption and signing tool.
|
|
* gpgsm: (gnupg). S/MIME encryption and signing tool.
|
|
* 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
|
|
|
|
|
|
@c
|
|
@c Printing stuff taken from gcc.
|
|
@c
|
|
@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
|
|
@setchapternewpage odd
|
|
@titlepage
|
|
@title Using the GNU Privacy Guard
|
|
@subtitle Version @value{VERSION}
|
|
@subtitle @value{UPDATED-MONTH}
|
|
|
|
@sp 3
|
|
|
|
@image{gnupg-logo,,,The GnuPG Logo}
|
|
|
|
@sp 3
|
|
|
|
@author The GnuPG Project (@url{https://gnupg.org})
|
|
|
|
@page
|
|
@vskip 0pt plus 1filll
|
|
@insertcopying
|
|
@end titlepage
|
|
|
|
@ifnothtml
|
|
@summarycontents
|
|
@contents
|
|
@page
|
|
@end ifnothtml
|
|
|
|
@ifhtml
|
|
@center @image{gnupg-logo-tr,6cm,,The GnuPG Logo}
|
|
@end ifhtml
|
|
|
|
@ifnottex
|
|
@node Top
|
|
@top
|
|
@insertcopying
|
|
|
|
This manual documents how to use the GNU Privacy Guard system as well as
|
|
the administration and the architecture.
|
|
@end ifnottex
|
|
|
|
@menu
|
|
* Installation:: A short installation guide.
|
|
|
|
* Invoking GPG-AGENT:: How to launch the secret key daemon.
|
|
* Invoking DIRMNGR:: How to launch the CRL and OCSP daemon.
|
|
* Invoking GPG:: Using the OpenPGP protocol.
|
|
* Invoking GPGSM:: Using the S/MIME protocol.
|
|
* Invoking SCDAEMON:: How to handle Smartcards.
|
|
* Specify a User ID:: How to Specify a User Id.
|
|
|
|
* Helper Tools:: Description of small helper tools
|
|
|
|
* Howtos:: How to do certain things.
|
|
* System Notes:: Notes pertaining to certain OSes.
|
|
* Debugging:: How to solve problems
|
|
|
|
* 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.
|
|
* Option Index:: Index to command line options.
|
|
* Index:: Index of concepts and symbol names.
|
|
@end menu
|
|
|
|
|
|
@ifhtml
|
|
@page
|
|
@summarycontents
|
|
@contents
|
|
@end ifhtml
|
|
|
|
|
|
@include instguide.texi
|
|
|
|
@include gpg-agent.texi
|
|
@include dirmngr.texi
|
|
@include gpg.texi
|
|
@include gpgsm.texi
|
|
@include scdaemon.texi
|
|
|
|
@node Specify a User ID
|
|
@chapter How to Specify a User Id
|
|
@anchor{how-to-specify-a-user-id}
|
|
@include specify-user-id.texi
|
|
|
|
|
|
@include tools.texi
|
|
|
|
@include howtos.texi
|
|
|
|
@include sysnotes.texi
|
|
|
|
@include debugging.texi
|
|
|
|
@include gpl.texi
|
|
|
|
@include contrib.texi
|
|
|
|
@c ---------------------------------------------------------------------
|
|
@c Indexes
|
|
@c ---------------------------------------------------------------------
|
|
|
|
@include glossary.texi
|
|
|
|
@node Option Index
|
|
@unnumbered Option Index
|
|
|
|
@printindex op
|
|
|
|
@node Index
|
|
@unnumbered Index
|
|
|
|
@printindex cp
|
|
|
|
@c ---------------------------------------------------------------------
|
|
@c Epilogue
|
|
@c ---------------------------------------------------------------------
|
|
|
|
@c @node History
|
|
@c @unnumbered History
|
|
@c
|
|
@c Here are the notices from the old dirmngr manual:
|
|
@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
|
|
@c
|
|
|
|
|
|
@bye
|
|
|
|
|