notmuch/doc
Daniel Kahn Gillmor 6a9626a2fd cli/reindex: destroy stashed session keys when --decrypt=false
There are some situations where the user wants to get rid of the
cleartext index of a message.  For example, if they're indexing
encrypted messages normally, but suddenly they run across a message
that they really don't want any trace of in their index.

In that case, the natural thing to do is:

   notmuch reindex --decrypt=false id:whatever@example.biz

But of course, clearing the cleartext index without clearing the
stashed session key is just silly.  So we do the expected thing and
also destroy any stashed session keys while we're destroying the index
of the cleartext.

Note that stashed session keys are stored in the xapian database, but
xapian does not currently allow safe deletion (see
https://trac.xapian.org/ticket/742).

As a workaround, after removing session keys and cleartext material
from the database, the user probably should do something like "notmuch
compact" to try to purge whatever recoverable data is left in the
xapian freelist.  This problem really needs to be addressed within
xapian, though, if we want it fixed right.
2017-12-08 08:08:47 -04:00
..
man1 cli/reindex: destroy stashed session keys when --decrypt=false 2017-12-08 08:08:47 -04:00
man5 doc: make SEE ALSO references one-per-line 2017-10-18 22:36:39 -03:00
man7 cli/show, reply: document use of stashed session keys in notmuch-properties 2017-12-08 08:08:46 -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