comparison xml/libpst.in @ 57:de3753c3160a

add archive directory with history of alioth versions that have been merged here
author Carl Byington <carl@five-ten-sg.com>
date Sat, 02 Feb 2008 12:54:07 -0800
parents 0cdbd066f65a
children a8b772313ff4
comparison
equal deleted inserted replaced
56:b504411ad213 57:de3753c3160a
1 <reference> 1 <reference>
2 <title>@PACKAGE@ Utilities - Version @VERSION@</title> 2 <title>@PACKAGE@ Utilities - Version @VERSION@</title>
3 <partintro> 3 <partintro>
4 <title>Packages</title> 4 <title>Packages</title>
5 5
6 <para>This is a fork of the libpst project at SourceForge. Another fork 6 <para>This is a fork of the libpst project at SourceForge. Another fork
7 is located at <ulink 7 is located at <ulink
8 url="http://alioth.debian.org/projects/libpst/">http://alioth.debian.org/projects/libpst/</ulink> 8 url="http://alioth.debian.org/projects/libpst/">http://alioth.debian.org/projects/libpst/</ulink>
9 </para> 9 </para>
10 10
11 <para>The various source and binary packages are available at <ulink 11 <para>The various source and binary packages are available at <ulink
12 url="http://www.five-ten-sg.com/@PACKAGE@/packages/">http://www.five-ten-sg.com/@PACKAGE@/packages/</ulink> 12 url="http://www.five-ten-sg.com/@PACKAGE@/packages/">http://www.five-ten-sg.com/@PACKAGE@/packages/</ulink>.
13 The most recent documentation is available at <ulink 13 The most recent documentation is available at <ulink
14 url="http://www.five-ten-sg.com/@PACKAGE@/">http://www.five-ten-sg.com/@PACKAGE@/</ulink> 14 url="http://www.five-ten-sg.com/@PACKAGE@/">http://www.five-ten-sg.com/@PACKAGE@/</ulink>.
15 </para> 15 </para>
16 16
17 <para>A Mercurial source code repository for this project is available at <ulink 17 <para>A <ulink
18 url="http://hg.five-ten-sg.com/@PACKAGE@/">http://hg.five-ten-sg.com/@PACKAGE@/</ulink>. 18 url="http://www.selenic.com/mercurial/wiki/">Mercurial</ulink> source
19 </para> 19 code repository for this project is available at <ulink
20 20 url="http://hg.five-ten-sg.com/@PACKAGE@/">http://hg.five-ten-sg.com/@PACKAGE@/</ulink>.
21 <para>This version can now convert both 32 bit Outlook files (pre 2003), and the 21 </para>
22 64 bit Outlook 2003 pst files. 22
23 </para> 23 <para>This version can now convert both 32 bit Outlook files (pre 2003), and the
24 64 bit Outlook 2003 pst files.
25 </para>
24 26
25 </partintro> 27 </partintro>
26 28
27 29
28 <refentry id="readpst.1"> 30 <refentry id="readpst.1">
273 275
274 <refsect1 id='lspst.description.1'> 276 <refsect1 id='lspst.description.1'>
275 <title>Description</title> 277 <title>Description</title>
276 <para><command>lspst</command> is a program that can read an Outlook 278 <para><command>lspst</command> is a program that can read an Outlook
277 PST (Personal Folders) file and produce a simple listing of the 279 PST (Personal Folders) file and produce a simple listing of the
278 data (contacts, email subjects, etc). 280 data (contacts, email subjects, etc).
279 </para> 281 </para>
280 </refsect1> 282 </refsect1>
281 283
282 <refsect1 id='lspst.also.1'> 284 <refsect1 id='lspst.also.1'>
283 <title>See Also</title> 285 <title>See Also</title>
645 <refsect1 id='pst.file.overview.5'> 647 <refsect1 id='pst.file.overview.5'>
646 <title>Overview</title> 648 <title>Overview</title>
647 <para> 649 <para>
648 Each item in a .pst file is identified by two id values ID1 and ID2. 650 Each item in a .pst file is identified by two id values ID1 and ID2.
649 There are two separate b-trees indexed by these ID1 and ID2 values. 651 There are two separate b-trees indexed by these ID1 and ID2 values.
650 Starting with Outlook 2003, the file format changed from one with 32 652 Starting with Outlook 2003, the file format changed from one with 32
651 bit pointers, to one with 64 bit pointers. We describe both formats 653 bit pointers, to one with 64 bit pointers. We describe both formats
652 here. 654 here.
653 </para> 655 </para>
654 </refsect1> 656 </refsect1>
655 657
656 <refsect1 id='pst.file.header.32.5'> 658 <refsect1 id='pst.file.header.32.5'>
657 <title>32 bit File Header</title> 659 <title>32 bit File Header</title>
702 00bc offsetIndex2 [4 bytes] 0x0c7e00 in this case 704 00bc offsetIndex2 [4 bytes] 0x0c7e00 in this case
703 ]]></literallayout> 705 ]]></literallayout>
704 <para> 706 <para>
705 We only support index types 0x0e and 0x17, and encryption types 707 We only support index types 0x0e and 0x17, and encryption types
706 0x00 and 0x01. Index type 0x0e is the older 32 bit Outlook format. 708 0x00 and 0x01. Index type 0x0e is the older 32 bit Outlook format.
707 Index type 0x17 is the newer 64 bit Outlook format. Encryption 709 Index type 0x17 is the newer 64 bit Outlook format. Encryption
708 type 0x00 is no encryption, and type 0x01 is the only other supported 710 type 0x00 is no encryption, and type 0x01 is the only other supported
709 encryption type. 711 encryption type.
710 </para> 712 </para>
711 <para> 713 <para>
712 offsetIndex1 is the file offset of the root of the 714 offsetIndex1 is the file offset of the root of the
713 index1 b-tree, which contains (ID1, offset, size, unknown) tuples 715 index1 b-tree, which contains (ID1, offset, size, unknown) tuples
714 for each item in the file. backPointer1 is the value that should 716 for each item in the file. backPointer1 is the value that should
1342 0020 3f 80 00 00 00 00 00 00 98 00 00 00 00 00 00 00 1344 0020 3f 80 00 00 00 00 00 00 98 00 00 00 00 00 00 00
1343 0030 00 00 00 00 00 00 00 00 1345 0030 00 00 00 00 00 00 00 00
1344 1346
1345 0000 signature [2 bytes] 0x0002 constant 1347 0000 signature [2 bytes] 0x0002 constant
1346 0002 count [2 bytes] 0x0002 in this case 1348 0002 count [2 bytes] 0x0002 in this case
1347 0004 unknown [4 bytes] 0 possibly constant 1349 0004 unknown [4 bytes] 0 possibly constant
1348 repeating 1350 repeating
1349 0008 id2 [4 bytes] 0x000692 in this case 1351 0008 id2 [4 bytes] 0x000692 in this case
1350 000c unknown1 [2 bytes] 0 may be a count or size 1352 000c unknown1 [2 bytes] 0 may be a count or size
1351 000e unknown2 [2 bytes] 0 may be a count or size 1353 000e unknown2 [2 bytes] 0 may be a count or size
1352 0010 id [8 bytes] 0x0000a8 in this case 1354 0010 id [8 bytes] 0x0000a8 in this case