.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "READPST" 1 "2006-02-19" "" ""
.SH NAME
readpst \- convert PST (MS Outlook Personal Folders) files to mbox format
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBreadpst\fR [\fB\-c\ \fIformat\fR\fR] [\fB\-d\ \fIdebug\-file\fR\fR] [\fB\-h\fR] [\fB\-k\fR] [\fB\-o\ \fIoutput\-directory\fR\fR] [\fB\-q\fR] [\fB\-r\fR] [\fB\-S\fR] [\fB\-V\fR] [\fB\-w\fR] [files\&.\&.\&.]
.ad
.hy

.SH "DESCRIPTION"

.PP
This manual page briefly documents the \fBreadpst\fR command\&.

.PP
 \fBreadpst\fR 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\&.

.SH "OPTIONS"

.TP
\-c \fIformat\fR
Set the Contact output mode\&. Use \-cv for vcard format or \-cl for an email list\&.

.TP
\-d \fIdebug\-file\fR
Specify name of debug log file\&. Defaults to "readpst\&.log"\&. The log file isn't an ascii file, it is a binary file readable by \fBreadpstlog\fR\&.

.TP
\-h
Show summary of options\&.

.TP
\-k
Changes the output format to KMail\&.

.TP
\-o \fIoutput\-directory\fR
Specifies the output directory\&. The directory must already exist, and is entered after the PST file is opened, but before any processing of files commences\&.

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

.TP
\-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 compatible with all mbox\-compatible email clients\&.

.TP
\-S
Output messages into seperate 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 000000000 increasing in intervals of 1 (ie 000000000, 000000001, 0000000002)\&. Any attachments are saved alongside each email as 000000000\-attach0, or with the name of the attachment if one is present\&.

.TP
\-V
Show version of program\&. Subsequent options are then ignored\&.

.TP
\-w
Overwrite any previous output files\&. Beware: When used with the \-S switch, this will remove all files from the target folder before writing\&. This is to keep the count of emails and attachments correct\&.

.SH "SEE ALSO"

.PP
 \fBreadpstlog\fR() 

.SH "AUTHOR"

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

.SH "COPYRIGHT"

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

.PP
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\&.

.PP
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\&.

.SH "CVS VERSION"

.PP
$Id$