Skip to content

altermime.1

Manvendra Bhangui edited this page Feb 25, 2024 · 5 revisions

NAME

alterMIME - MIME encoded email pack alteration tool

SYNTAX

altermime --input=<input mime pack> ( --input=- for stdin )
[--disclaimer=<disclaimer file>]
[--disclaimer-html=<HTML disclaimer file>]
[--disclaimer-b64=<BASE64 encoded dislcaimer>]
[--htmltoo]
[--force-into-b64]
[--force-for-bad-html]
[--multipart-insert]
[--remove=<remove file name (regex)>] (if filename contains a /, matches on mime-type )
[--removeall]
[--remove-by-regex=<filename regex>] (if the regex contains /, matches on mime-type)
[--replace=<filename to replace> --with=<replace with>]
[--xheader="..."
[--alter-header="..." --alter-with="..." --alter-mode=<prefix|suffix|replace>]
[--altersigned]
[--no-qmail-bounce]
[--verbose]
[--log-stdout]
[--log-stderr]
[--log-syslog]
[--debug]
[--version]

DESCRIPTION

The alterMIME program (and objects) has been written to facilitate the modification of MIME encoded email packs when such things as disclaimer additions and attachment nullification is required.

alterMIME is part of the suite of software which includes Inflex email scanner, ripMIME attachment extractor and the XaMime commercial email scanner.

OPTIONS

--input=, Sets the mailpack file to be the filename supplied, if the filename is a
single '-' (hyphen) then the mailpack is sourced via stdin and outputted via stdout.

--disclaimer=, Set the plaintext disclaimer source file.

--disclaimer-html=, Set the HTML disclaimer source file.

--disclaimer-b64=, Set the BASE64 encoded disclaimer source file (implies --force-into-b64).

--force-for-bad-html, Force adding of the HTML disclaimer even when HTML is not correctly formatted the HTML portion of the email body ( if there is no explicitly defined HTML dislcaimer, see --disclaimer-html )

--htmltoo, Sets alterMIME to insert the plaintext disclaimer into the HTML portion of the email body (if there is no explicitly defined HTML dislcaimer, see --disclaimer-html)

--disclaimer-b64=, Set the BASE64 encoded disclaimer source file (implies --force-into-b64).

--remove=, Remove any attachments which match the filename supplied, if the filename text contains a forward-slash '/', then the matching will occur based on content-type headers rather than by filename.

--removeall, Remove all attachments

--replace=, Replace attachments matching the given filename. Requires to be used with --with.

--with=, Replace the attachments specified by --replace with the file specified.

--xheader=, Insert a header line as specified into the first set of headers.

--alter-header="..." --alter-with="..." --alter-mode=(prefix|suffix|replace) Alter an existing header in the mailpack. This function modifies the value of the header, as apposed to the header name.

--altersigned, Force alterMIME to modify 'signed' emails

--no-qmail-bounce, Don't search into email bodies for attachment headers

--verbose, Describe details of the process occuring

--log-stdout, Send all output messages to stdout

--log-stderr, Send all output messages to stderr

--log-syslog, Send all output messages to syslog

--debug, Provide greater verbosity and debugging information

--version, display the alterMIME version string

EXAMPLES

To add a disclaimer to the content of mail in mailpack and output it to stdout

altermime --input=mailpack --disclaimer=/etc/indimail/disclaimer

AUTHORS

Paul L Daniels
ripMIME WWW site http://www.pldaniels.com/ripmime
ripMIME mailing list <altermime-general@pldaniels.com>
For mailpacks which do not appear to decode correctly - please email to <mailpacks-2004@pldaniels.com>

SEE ALSO

ripmime(1), inflex(1) ripole(1), opentnef(1)

Clone this wiki locally