.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "email-print-mime-structure 1" .TH email-print-mime-structure 1 "Debian Project" "perl v5.38.2" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME email\-print\-mime\-structure \- display a tree\-like view of the MIME structure of an e\-mail .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBemail-print-mime-structure\fR <\fBmessage.eml\fR .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBemail-print-mime-structure\fR reads a MIME message from stdin and produces a treelike representation to stdout. .PP If the user wants the parts numbered, they can feed the output through something like "cat \-n". .SH OPTIONS .IX Header "OPTIONS" .IP \fB\-\-pgpkey=\fR\fIKEYFILE\fR 4 .IX Item "--pgpkey=KEYFILE" \&\fIKEYFILE\fR 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 key. .Sp OpenPGP secret keys listed in \fB\-\-pgpkey=\fR are used ephemerally, and do not interact with any local GnuPG keyring. .IP \fB\-\-cmskey=\fR\fIKEYFILE\fR 4 .IX Item "--cmskey=KEYFILE" \&\fIKEYFILE\fR should name a PEM\- or DER-encoded X.509 private key that is not password-protected. If an S/MIME\-encrypted message that uses CMS 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 such key. .Sp X.509 private keys listed in \fB\-\-cmskey=\fR are used ephemerally, and do not interact with any local GnuPG keyring. .IP \fB\-\-use\-gpg\-agent\fR 4 .IX Item "--use-gpg-agent" If this flag is present, and \fBemail-print-mime-structure\fR encounters a PGP/MIME\- or S/MIME\-encrypted part, it will try to decrypt the part using the secret keys found in the local installation of GnuPG. .Sp If \fB\-\-use\-gpg\-agent\fR is supplied along with either \&\fB\-\-pgpkey=\fR\fIKEYFILE\fR or \fB\-\-cmskey=\fR\fIKEYFILE\fR arguments, the \&\fIKEYFILE\fR arguments will be tried before falling back to GnuPG. .Sp If \fBemail-print-mime-structure\fR has been asked to decrypt parts with either \fB\-\-pgpkey=\fR\fIKEYFILE\fR or with \fB\-\-use\-gpg\-agent\fR, and it is unable to decrypt an encrypted part, it will emit a warning to stderr. .IP \fB\-\-no\-use\-gpg\-agent\fR 4 .IX Item "--no-use-gpg-agent" Don't try to decrypt PGP/MIME\- or S/MIME\-encrypted parts using secret keys found in the local installation of GnuPG. This is the default. .IP "\fB\-\-help\fR, \fB\-h\fR" 4 .IX Item "--help, -h" Show usage instructions. .SH EXAMPLE .IX Header "EXAMPLE" .Vb 4 \& $ email\-print\-mime\-structure