NAME
ripMIME - email attachment / decomposition tool.  

SYNTAX
ripMIME -i <mime file> -d <directory> [-p prefix] [-e [header file]] [-vVh] 
        [--version][--no_nameless][--unique_names [--prefix|--postfix|--infix]]
        [--paranoid] [--mailbox] [--debug][--no-tnef] [--no-quotedprintable] 
        [--no-uudecode][--no-ole]  

DESCRIPTION
ripMIME is a command line tool used to aid in the extraction of email borne 
attachments to files which can be processed using other UNIX tools. 
ripMIME supports both the RFC MIME standards as well as being able to behave 
according to various MUA 'features' which are often used as exploitation holes.

OPTIONS
-i
    Input MIME encoded file (use '-' to input from STDIN)
-d
    Output directory 
-p
    Specify prefix filename to be used on files without a filename 
    (default 'text') 
-e [headers file name]
    Dump headers from mailpack (default '_headers_') 
-v
    Turn on verbosity 
-q
    Run quietly, do no report non-fatal errors

--verbose-contenttype
    Turn on verbosity of file content type 
--verbose-oldstyle
    Uses the v1.2.x style or filename reporting 
--stdout
    All reporting goes to stdout (Default) 
--stderr
    All reporting goes to stderr 
--syslog
    All reporting goes to syslog 
--no-paranoid
    [ Deprecated ] Turns off strict ascii-alnum filenaming 
--paranoid
    Converts all filenames to strict 7-bit compliance 
--name-by-type
    Saves a given attachment by its content-type if it has no other name 
--no-nameless
    Do not save nameless attachments 
--overwrite
    Overwrite files if they have the same name on extraction 
--unique-names
    Dont overwrite existing files (This is the default behaviour) 
--prefix
    rename by putting unique code at the front of the filename 
--postfix
    rename by putting unique code at the end of the filename 
--infix
    rename by putting unique code in the middle of the filename 
--mailbox
    Process mailbox file 
--debug
    Produces detailed information about the whole decoding process

    Attachment type decoding switches 

--no-tnef
    Turn off TNEF/winmail.dat decoding 
--no-ole
    Turn off OLE decoding 
--no-uudecode
    Turns off the facility of detecting UUencoded attachments in emails 
--no-quotedprintable
    Turns off the facility of decoding QuotedPrintable data 
--no-doublecr
    Turns off saving of double-CR embedded data 
--no-mht
    Turns off MHT (a Microsoft mailpack attachment format ) decoding 
-V --version
    Give version information 
-h
    This message (help) 

 
EXAMPLES
To unpack an email in a file 'mailpack' to the directory /tmp with verbose 
output of the files unpacked;

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

