notmuch/doc
Daniel Kahn Gillmor a990585408 crypto: use stashed session-key properties for decryption, if available
When doing any decryption, if the notmuch database knows of any
session keys associated with the message in question, try them before
defaulting to using default symmetric crypto.

This changeset does the primary work in _notmuch_crypto_decrypt, which
grows some new parameters to handle it.

The primary advantage this patch offers is a significant speedup when
rendering large encrypted threads ("notmuch show") if session keys
happen to be cached.

Additionally, it permits message composition without access to
asymmetric secret keys ("notmuch reply"); and it permits recovering a
cleartext index when reindexing after a "notmuch restore" for those
messages that already have a session key stored.

Note that we may try multiple decryptions here (e.g. if there are
multiple session keys in the database), but we will ignore and throw
away all the GMime errors except for those that come from last
decryption attempt.  Since we don't necessarily know at the time of
the decryption that this *is* the last decryption attempt, we'll ask
for the errors each time anyway.

This does nothing if no session keys are stashed in the database,
which is fine.  Actually stashing session keys in the database will
come as a subsequent patch.
2017-12-04 21:48:31 -04:00
..
man1 cli: allow empty strings for notmuch insert --folder argument 2017-11-08 09:46:44 -05:00
man5 doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
man7 crypto: use stashed session-key properties for decryption, if available 2017-12-04 21:48:31 -04:00
.gitignore Use rooted paths in .gitignore files 2017-08-18 19:42:35 -03:00
conf.py doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00
doxygen.cfg Use https instead of http where possible 2016-06-05 08:32:17 -03:00
index.rst doc: add notmuch-properties(7) 2017-10-21 19:52:55 -03:00
INSTALL doc: remove support for rst2man 2015-01-22 08:37:25 +01:00
Makefile doc: convert sphinx based docs 2014-03-09 10:41:08 -03:00
Makefile.local build: only install known man pages 2016-11-17 08:42:23 -04:00
notmuch-emacs.rst doc: fix references in notmuch-emacs.rst 2016-11-17 08:39:04 -04:00