


READPST(1)                                             READPST(1)


NAME
       readpst  -  convert PST (MS Outlook Personal Folders) files to mbox and
       other formats

SYNOPSIS
       readpst [-D] [-M] [-S] [-V] [-b] [-c format] [-d debug-file] [-e] [-h]
               [-j jobs] [-k] [-o output-directory] [-q] [-r]
               [-t output-type-codes] [-u] [-w] pstfile


DESCRIPTION
       readpst is a program that can read an Outlook  PST  (Personal  Folders)
       file  and  convert it into an mbox file, a format suitable for KMail, a
       recursive mbox structure, or separate emails.


OPTIONS
       -D     Include deleted items in the output.


       -M     Output messages in MH (rfc822) format as  separate  files.  This
              will  create folders as named in the PST file, and will put each
              email together with any attachments into  its  own  file.  These
              files will be numbered from 1 to n with no leading zeros.


       -S     Output messages into separate files. This will create folders as
              named in the PST file, and will put each email in its own  file.
              These  files will be numbered from 1 to n with no leading zeros.
              So the email contents for message $m are saved in a  file  named
              $m.  Attachments  will  also  be saved in the same folder as the
              email message. The attachments  for  message  $m  are  saved  as
              $m-$name where $name is (the original name of the attachment, or
              'attach$n' if the attachment had no name), where $n  is  another
              sequential index with no leading zeros.


       -V     Show program version and exit.


       -b     Do  not  save  the  attachments  for the RTF format of the email
              body.


       -c format
              Set the Contact output mode. Use -cv for vcard format or -cl for
              an email list.


       -d debug-file
              Specify  name  of  debug  log file. The log file is now an ascii
              file, instead of the binary file used in previous versions.





                            2009-09-14                          1





READPST(1)                                             READPST(1)


       -e     Same as the M option, but each output file will include  an  ex-
              tension from (.eml, .ics, .vcf).


       -h     Show summary of options and exit.


       -j jobs
              Specifies the maximum number of parallel jobs. Specify 0 to sup-
              press running parallel jobs.


       -k     Changes the output format to KMail.


       -o output-directory
              Specifies the output directory. The directory must  already  ex-
              ist, and is entered after the PST file is opened, but before any
              processing of files commences.


       -q     Changes to silent mode. No feedback is printed  to  the  screen,
              except for error messages.


       -r     Changes the output format to Recursive. This will create folders
              as named in the PST file, and will put  all  emails  in  a  file
              called  "mbox" inside each folder. These files are then compati-
              ble with all mbox-compatible email clients.


       -t output-type-codes
              Specifies the item types that are processed. The argument  is  a
              sequence  of  single letters from (e,a,j,c) for (email, appoint-
              ment, journal, contact) types. The default  is  to  process  all
              item types.


       -u     Sets  Thunderbird mode, a submode of recursive mode. This causes
              two extra .type and .size meta files to be created.


       -w     Overwrite any previous output files. Beware: When used with  the
              -S switch, this will remove all files from the target folder be-
              fore writing. This is to keep the count of  emails  and  attach-
              ments correct.


AUTHOR
       This  manual  page  was originally written by Dave Smith <dave.s@earth-
       corp.com>, and updated by Joe Nahmias <joe@nahmias.net> for the  Debian
       GNU/Linux  system  (but may be used by others). It was subsequently up-
       dated by Brad Hards <bradh@frogmouth.net>, and converted to xml  format
       by Carl Byington <carl@five-ten-sg.com>.



                            2009-09-14                          2





READPST(1)                                             READPST(1)


COPYRIGHT
       Copyright  (C)  2002 by David Smith <dave.s@earthcorp.com>. XML version
       Copyright (C) 2008 by 510 Software Group <carl@five-ten-sg.com>.


       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2, or  (at  your  option)  any
       later version.


       You should have received a copy of the GNU General Public License along
       with this program; see the file COPYING. If not, please  write  to  the
       Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.


VERSION
       0.6.45







































                            2009-09-14                          3


