1READPST(1) READPST(1)
2
6 readpst - convert PST (MS Outlook Personal Folders) files to mbox and
7 other formats
8
10 readpst [-D] [-M] [-S] [-V] [-b] [-c format] [-d debug-file] [-e] [-h]
11 [-j jobs] [-k] [-o output-directory] [-q] [-r]
12 [-t output-type-codes] [-u] [-w] pstfile
13
16 readpst is a program that can read an Outlook PST (Personal Folders)
17 file and convert it into an mbox file, a format suitable for KMail, a
18 recursive mbox structure, or separate emails.
19
22 -D Include deleted items in the output.
23 -M Output messages in MH (rfc822) format as separate files. This
26 will create folders as named in the PST file, and will put each
27 email together with any attachments into its own file. These
28 files will be numbered from 1 to n with no leading zeros. This
29 format has no from quoting.
30 -S Output messages into separate files. This will create folders as
33 named in the PST file, and will put each email in its own file.
34 These files will be numbered from 1 to n with no leading zeros.
35 Attachments will also be saved in the same folder as the email
36 message. The attachments for message $m are saved as $m-$name
37 where $name is (the original name of the attachment, or 'at‐
38 tach$n' if the attachment had no name), where $n is another se‐
39 quential index with no leading zeros. This format has no from
40 quoting.
41 -V Show program version and exit.
44 -b Do not save the attachments for the RTF format of the email
47 body.
48 -c format
51 Set the Contact output mode. Use -cv for vcard format or -cl for
52 an email list.
53 -d debug-file
56 Specify name of debug log file. The log file is now an ascii
57 file, instead of the binary file used in previous versions.
58 -e Same as the M option, but each output file will include an ex‐
61 tension from (.eml, .ics, .vcf). This format has no from quot‐
62 ing.
63 -h Show summary of options and exit.
66 -j jobs
69 Specifies the maximum number of parallel jobs. Specify 0 to sup‐
70 press running parallel jobs.
71 -k Changes the output format to KMail. This format uses mboxrd from
74 quoting.
75 -o output-directory
78 Specifies the output directory. The directory must already ex‐
79 ist, and is entered after the PST file is opened, but before any
80 processing of files commences.
81 -q Changes to silent mode. No feedback is printed to the screen,
84 except for error messages.
85 -r Changes the output format to Recursive. This will create folders
88 as named in the PST file, and will put all emails in a file
89 called "mbox" inside each folder. These files are then compati‐
90 ble with all mbox-compatible email clients. This format uses
91 mboxrd from quoting.
92 -t output-type-codes
95 Specifies the item types that are processed. The argument is a
96 sequence of single letters from (e,a,j,c) for (email, appoint‐
97 ment, journal, contact) types. The default is to process all
98 item types.
99 -u Sets Thunderbird mode, a submode of recursive mode. This causes
102 two extra .type and .size meta files to be created. This format
103 uses mboxrd from quoting.
104 -w Overwrite any previous output files. Beware: When used with the
107 -S switch, this will remove all files from the target folder be‐
108 fore writing. This is to keep the count of emails and attach‐
109 ments correct.
110
113 Output formats that place each mail message in a separate file (-M, -S,
114 -e) don't do any from quoting. Output formats that place multiple email
115 messages in a single file (-k, -r, -u) now use mboxrd from quoting
116 rules. If none of those switches are specified, the default output for‐
117 mat uses mboxrd from quoting rules, since it produces multiple email
118 messages in a single file. Earlier versions used mboxo from quoting
119 rules for all output formats.
120
123 This manual page was originally written by Dave Smith <dave.s@earth‐
124 corp.com>, and updated by Joe Nahmias <joe@nahmias.net> for the Debian
125 GNU/Linux system (but may be used by others). It was subsequently up‐
126 dated by Brad Hards <bradh@frogmouth.net>, and converted to xml format
127 by Carl Byington <carl@five-ten-sg.com>.
128
131 Copyright (C) 2002 by David Smith <dave.s@earthcorp.com>. XML version
132 Copyright (C) 2008 by 510 Software Group <carl@five-ten-sg.com>.
133 This program is free software; you can redistribute it and/or modify it
136 under the terms of the GNU General Public License as published by the
137 Free Software Foundation; either version 2, or (at your option) any
138 later version.
139 You should have received a copy of the GNU General Public License along
142 with this program; see the file COPYING. If not, please write to the
143 Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
144
147 0.6.52
148 2009-09-14 READPST(1)