Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
READPST(1)		libpst Utilities - Version 0.6		    READPST(1)

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

SYNOPSIS
       readpst [-C default-charset] [-D] [-M] [-S] [-V]
	       [-a attachment-extension-list] [-b] [-c format] [-d debug-file]
	       [-e] [-h] [-j jobs] [-k]	[-m] [-o output-directory] [-q]	[-r]
	       [-t output-type-codes] [-u] [-w]	[-8] 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
       -C default-charset
	   Set the character set to be used for	items with an unspecified
	   character set.

       -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. This format has no
	   from	quoting.

       -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.
	   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. This format has no	from quoting.

       -V
	   Show	program	version	and exit.

       -a attachment-extension-list
	   Set the list	of acceptable attachment extensions. Any attachment
	   that	does not have an extension on this list	will be	discarded. All
	   attachments are acceptable if the list is empty, or this option is
	   not specified.

       -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.

       -e
	   Same	as the M option, but each output file will include an
	   extension from (.eml, .ics, .vcf). This format has no from quoting.

       -h
	   Show	summary	of options and exit.

       -j jobs
	   Specifies the maximum number	of parallel jobs. Specify 0 to
	   suppress running parallel jobs. Folders may be processed in
	   parallel. Output formats that place each mail message in a separate
	   file	(-M, -S, -e) may process the contents of individual folders in
	   parallel.

       -k
	   Changes the output format to	KMail. This format uses	mboxrd from
	   quoting.

       -m
	   Same	as the e option, but write .msg	files also

       -o output-directory
	   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.

       -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. Appointments go into a file called
	   "calendar", address book entries go into a file called "contacts",
	   and journal entries go into a file called "journal".	These files
	   are then compatible with all	mbox-compatible	email clients. This
	   format uses mboxrd from quoting.

       -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, appointment,
	   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. This	format uses
	   mboxrd from quoting.

       -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.

       -8
	   Output bodies in UTF-8, rather than original	encoding, if a UTF-8
	   version is available.

FROM QUOTING
       Output formats that place each mail message in a	separate file (-M, -S,
       -e, -m) don't do	any from quoting. Output formats that place multiple
       email messages in a single file (-k, -r,	-u) now	use mboxrd from
       quoting rules. If none of those switches	are specified, the default
       output format uses mboxrd from quoting rules, since it produces
       multiple	email messages in a single file. Earlier versions used mboxo
       from quoting rules for all output formats.

AUTHOR
       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>.

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.70

readpst	0.6.70			  2016-08-29			    READPST(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FROM QUOTING | AUTHOR | COPYRIGHT | VERSION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=readpst&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help