path: root/email-print-mime-structure.1.pod
diff options
authorDaniel Kahn Gillmor <>2019-11-02 01:28:24 -0400
committerSean Whitton <>2019-11-02 08:44:19 -0700
commit67a847605769d5e255168a65d780594383569b75 (patch)
treeffdc4362c00917605de5baf23f033be46eda3ef2 /email-print-mime-structure.1.pod
parenta858e19c0eb6c2a12d832b3dd256ef64c72f0fc1 (diff)
email-print-mime-structure: add decryption capability
Add simple decryption capability for email-print-mime-structure, so that it can do stuff like this: $ email-print-mime-structure --pgpkey alice@openpgp.example.sec.asc < msg.eml └┬╴multipart/encrypted 2190 bytes ├─╴application/pgp-encrypted 11 bytes └─╴application/octet-stream 1613 bytes ↧ (decrypts to) └─╴text/plain 425 bytes $ At the moment, it only works with keys that can be found in the filesystem, and when the pgpy module is installed. Possible future work: - try using gpg to do the decryption from whatever gpg's system capabilities are I've added python3-pgpy to the list of Recommends, since it is not a hard dependency. Signed-off-by: Daniel Kahn Gillmor <>
Diffstat (limited to 'email-print-mime-structure.1.pod')
1 files changed, 8 insertions, 0 deletions
diff --git a/email-print-mime-structure.1.pod b/email-print-mime-structure.1.pod
index 03a8e29..209c725 100644
--- a/email-print-mime-structure.1.pod
+++ b/email-print-mime-structure.1.pod
@@ -21,6 +21,14 @@ something like "cat -n".
=over 4
+=item B<--pgpkey=>I<KEYFILE>
+I<KEYFILE> should name an OpenPGP transferable secret key that is not
+password-protected. If a PGP/MIME-encrypted message is found on
+standard input, this key will be tried for decryption. May be used
+multiple times if you want to try decrypting with more than one secret
=item B<--help>, B<-h>
Show usage instructions.