annotate README @ 1:43e8802f08c5 debian libpst_0_5_1

imported from debian 0.5.1
author carl
date Thu, 23 Dec 2004 11:17:37 -0800
parents 6b1b602514db
children 69ab1d8b3293
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
6b1b602514db Initial revision
carl
parents:
diff changeset
1 RFC reference:
6b1b602514db Initial revision
carl
parents:
diff changeset
2 RFC 1341 - base64 Mime encoding and layout of mime headers
6b1b602514db Initial revision
carl
parents:
diff changeset
3 RFC 2183 - Content-Disposition for describing email attachments
6b1b602514db Initial revision
carl
parents:
diff changeset
4 RFC 2426 - vCard definition (for saving contacts)
6b1b602514db Initial revision
carl
parents:
diff changeset
5
6b1b602514db Initial revision
carl
parents:
diff changeset
6 LibPST v0.5
6b1b602514db Initial revision
carl
parents:
diff changeset
7 ===========
6b1b602514db Initial revision
carl
parents:
diff changeset
8
6b1b602514db Initial revision
carl
parents:
diff changeset
9 It is with GREAT relief that I bring you version 0.5 of the LibPST tools!
6b1b602514db Initial revision
carl
parents:
diff changeset
10
6b1b602514db Initial revision
carl
parents:
diff changeset
11 Through great difficulties, this tool has survived and expanded to become even
6b1b602514db Initial revision
carl
parents:
diff changeset
12 better.
6b1b602514db Initial revision
carl
parents:
diff changeset
13
6b1b602514db Initial revision
carl
parents:
diff changeset
14 The changes are as follows:
6b1b602514db Initial revision
carl
parents:
diff changeset
15 * RTF support. We can now decompress RTF bodies in emails, and are saved as attachments
6b1b602514db Initial revision
carl
parents:
diff changeset
16 * Better support in reading the indexes. Fixed many bugs with them
6b1b602514db Initial revision
carl
parents:
diff changeset
17 * Improved reliability. "Now we are getting somewhere!"
6b1b602514db Initial revision
carl
parents:
diff changeset
18 * Improved compiling. Hopefully we won't be hitting too many compile errors now.
6b1b602514db Initial revision
carl
parents:
diff changeset
19
6b1b602514db Initial revision
carl
parents:
diff changeset
20 If you have any problems with this release, don't hesitate to contact me.
6b1b602514db Initial revision
carl
parents:
diff changeset
21
6b1b602514db Initial revision
carl
parents:
diff changeset
22 These changes come to you, as always, free under the GPL license!! What a wonderful
6b1b602514db Initial revision
carl
parents:
diff changeset
23 thing it is. It does mean that you can write your own program off of this library
6b1b602514db Initial revision
carl
parents:
diff changeset
24 and distribute it also for free. However, anyone with commercial interests for
6b1b602514db Initial revision
carl
parents:
diff changeset
25 developing applications they will be charging for are encouraged to get in touch
6b1b602514db Initial revision
carl
parents:
diff changeset
26 with me, as I am sure we can come to some arrangement.
6b1b602514db Initial revision
carl
parents:
diff changeset
27
6b1b602514db Initial revision
carl
parents:
diff changeset
28 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
29 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
30
6b1b602514db Initial revision
carl
parents:
diff changeset
31 LibPST v0.4.3
6b1b602514db Initial revision
carl
parents:
diff changeset
32 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
33
6b1b602514db Initial revision
carl
parents:
diff changeset
34 Bug fix release. No extra functionality
6b1b602514db Initial revision
carl
parents:
diff changeset
35
6b1b602514db Initial revision
carl
parents:
diff changeset
36 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
37 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
38
6b1b602514db Initial revision
carl
parents:
diff changeset
39 LibPST v0.4.2
6b1b602514db Initial revision
carl
parents:
diff changeset
40 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
41
6b1b602514db Initial revision
carl
parents:
diff changeset
42 The debug system has had an overhaul. The debug messages are no longer
6b1b602514db Initial revision
carl
parents:
diff changeset
43 printed to the screen when they are enabled. They are dumped to a
6b1b602514db Initial revision
carl
parents:
diff changeset
44 binary file. There is another utility called "readlog" that I have
6b1b602514db Initial revision
carl
parents:
diff changeset
45 written to handle these log files. It should make it easier to
6b1b602514db Initial revision
carl
parents:
diff changeset
46 selectively view bits of a log file. It also shows the position that
6b1b602514db Initial revision
carl
parents:
diff changeset
47 the log message was printed from.
6b1b602514db Initial revision
carl
parents:
diff changeset
48
6b1b602514db Initial revision
carl
parents:
diff changeset
49 There is a new switch in readpst. It is -d. It enables the user to
6b1b602514db Initial revision
carl
parents:
diff changeset
50 specify the log file which the binary log is written to. If the switch
6b1b602514db Initial revision
carl
parents:
diff changeset
51 isn't used, the default file of "readpst.log" is used.
6b1b602514db Initial revision
carl
parents:
diff changeset
52
6b1b602514db Initial revision
carl
parents:
diff changeset
53 The code is now Visual C++ compatible. It has compiled on Visual C++
6b1b602514db Initial revision
carl
parents:
diff changeset
54 .net Standard edition, and produces the readpst.exe file. Use the project
6b1b602514db Initial revision
carl
parents:
diff changeset
55 file included in this distribution.
6b1b602514db Initial revision
carl
parents:
diff changeset
56
6b1b602514db Initial revision
carl
parents:
diff changeset
57 There have been minor improvements elsewhere too.
6b1b602514db Initial revision
carl
parents:
diff changeset
58
6b1b602514db Initial revision
carl
parents:
diff changeset
59
6b1b602514db Initial revision
carl
parents:
diff changeset
60 LibPST v0.4.1
6b1b602514db Initial revision
carl
parents:
diff changeset
61 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
62
6b1b602514db Initial revision
carl
parents:
diff changeset
63 Fixed a couple more bugs. Is it me or do bugs just insert themselves
6b1b602514db Initial revision
carl
parents:
diff changeset
64 in random, hard to find places!
6b1b602514db Initial revision
carl
parents:
diff changeset
65
6b1b602514db Initial revision
carl
parents:
diff changeset
66 Cured a few problems with regard to emails with multiple embeded
6b1b602514db Initial revision
carl
parents:
diff changeset
67 items. They are not fully re-created using Mime-types, but are
6b1b602514db Initial revision
carl
parents:
diff changeset
68 accessible with the -S switch (which saves everything as seperate
6b1b602514db Initial revision
carl
parents:
diff changeset
69 items)
6b1b602514db Initial revision
carl
parents:
diff changeset
70
6b1b602514db Initial revision
carl
parents:
diff changeset
71 Fixed a problem reading the first index. Back sliders are now
6b1b602514db Initial revision
carl
parents:
diff changeset
72 detected. (ie when the value following the current one is smaller, not
6b1b602514db Initial revision
carl
parents:
diff changeset
73 bigger!)
6b1b602514db Initial revision
carl
parents:
diff changeset
74
6b1b602514db Initial revision
carl
parents:
diff changeset
75 Added some error messages when we try and read outside of the PST
6b1b602514db Initial revision
carl
parents:
diff changeset
76 file, this was causing a few problems before, cause the return value
6b1b602514db Initial revision
carl
parents:
diff changeset
77 wasn't always checked, so it was possible to be reading random data,
6b1b602514db Initial revision
carl
parents:
diff changeset
78 and trying to make sense of it!
6b1b602514db Initial revision
carl
parents:
diff changeset
79
6b1b602514db Initial revision
carl
parents:
diff changeset
80 Anyway, if you find any problems, don't hesitate to mail me
6b1b602514db Initial revision
carl
parents:
diff changeset
81
6b1b602514db Initial revision
carl
parents:
diff changeset
82 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
83 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
84
6b1b602514db Initial revision
carl
parents:
diff changeset
85 LibPST v0.4
6b1b602514db Initial revision
carl
parents:
diff changeset
86 ===========
6b1b602514db Initial revision
carl
parents:
diff changeset
87
6b1b602514db Initial revision
carl
parents:
diff changeset
88 Fixed a nasty bug that occasionally corrupted attachments. Another bug
6b1b602514db Initial revision
carl
parents:
diff changeset
89 with regard to reading of indexes (also occasional).
6b1b602514db Initial revision
carl
parents:
diff changeset
90
6b1b602514db Initial revision
carl
parents:
diff changeset
91 Another output method has been added which is called "Seperate". It is
6b1b602514db Initial revision
carl
parents:
diff changeset
92 activated with the -S switch. It operates in the following manor:
6b1b602514db Initial revision
carl
parents:
diff changeset
93
6b1b602514db Initial revision
carl
parents:
diff changeset
94 |--Inbox-->000000
6b1b602514db Initial revision
carl
parents:
diff changeset
95 | 000001
6b1b602514db Initial revision
carl
parents:
diff changeset
96 | 000002
6b1b602514db Initial revision
carl
parents:
diff changeset
97 |--Sentmail-->0000000
6b1b602514db Initial revision
carl
parents:
diff changeset
98 | 0000001
6b1b602514db Initial revision
carl
parents:
diff changeset
99 | 0000002
6b1b602514db Initial revision
carl
parents:
diff changeset
100
6b1b602514db Initial revision
carl
parents:
diff changeset
101 All the emails are stored in seperate files counting from 0 upwards,
6b1b602514db Initial revision
carl
parents:
diff changeset
102 in a folder named as the PST folder.
6b1b602514db Initial revision
carl
parents:
diff changeset
103
6b1b602514db Initial revision
carl
parents:
diff changeset
104 When an email has an attachment, it is saved as a seperate file. The
6b1b602514db Initial revision
carl
parents:
diff changeset
105 filename for the attachment is made up of 2 parts, the first is the
6b1b602514db Initial revision
carl
parents:
diff changeset
106 email number to which it belongs, the second is its filename.
6b1b602514db Initial revision
carl
parents:
diff changeset
107
6b1b602514db Initial revision
carl
parents:
diff changeset
108 The should now be runnable on big-endian machines, if the define.h
6b1b602514db Initial revision
carl
parents:
diff changeset
109 file is first modified. The #define LITTLE_ENDIAN must be commented
6b1b602514db Initial revision
carl
parents:
diff changeset
110 out, and the #define BIG_ENDIAN must be uncommented.
6b1b602514db Initial revision
carl
parents:
diff changeset
111
6b1b602514db Initial revision
carl
parents:
diff changeset
112 More verbose error messages have been added. Apparently people got
6b1b602514db Initial revision
carl
parents:
diff changeset
113 confused when the program stopped for no visible reason. This has now
6b1b602514db Initial revision
carl
parents:
diff changeset
114 been resolved.
6b1b602514db Initial revision
carl
parents:
diff changeset
115
6b1b602514db Initial revision
carl
parents:
diff changeset
116 Thanks for the continued support of all people involved.
6b1b602514db Initial revision
carl
parents:
diff changeset
117
6b1b602514db Initial revision
carl
parents:
diff changeset
118 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
119 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
120
6b1b602514db Initial revision
carl
parents:
diff changeset
121 Libpst v0.3.4
6b1b602514db Initial revision
carl
parents:
diff changeset
122 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
123
6b1b602514db Initial revision
carl
parents:
diff changeset
124 Several more fixes. An Infinite loop and incorrect interpreting of
6b1b602514db Initial revision
carl
parents:
diff changeset
125 item index attributes. Work has started on making the code executable
6b1b602514db Initial revision
carl
parents:
diff changeset
126 on big endian CPUs. At present it should work with Linux on these
6b1b602514db Initial revision
carl
parents:
diff changeset
127 CPUs, but I would appreciate it if you could provide feedback with
6b1b602514db Initial revision
carl
parents:
diff changeset
128 regard to it's performance. I am also working with some other people
6b1b602514db Initial revision
carl
parents:
diff changeset
129 at make it operate on Solaris.
6b1b602514db Initial revision
carl
parents:
diff changeset
130
6b1b602514db Initial revision
carl
parents:
diff changeset
131 A whole load more items are now recognized by the Item records. With
6b1b602514db Initial revision
carl
parents:
diff changeset
132 more items in Emails and Folders. I haven't got to the Contacts yet.
6b1b602514db Initial revision
carl
parents:
diff changeset
133
6b1b602514db Initial revision
carl
parents:
diff changeset
134 Anyway, this is what I would call a minor feature enhancment and
6b1b602514db Initial revision
carl
parents:
diff changeset
135 bugfix release.
6b1b602514db Initial revision
carl
parents:
diff changeset
136
6b1b602514db Initial revision
carl
parents:
diff changeset
137 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
138 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
139
6b1b602514db Initial revision
carl
parents:
diff changeset
140 LibPST v0.3.3
6b1b602514db Initial revision
carl
parents:
diff changeset
141 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
142
6b1b602514db Initial revision
carl
parents:
diff changeset
143 Fixed several items. Mainly memory leaks. Loads of them! oops..
6b1b602514db Initial revision
carl
parents:
diff changeset
144
6b1b602514db Initial revision
carl
parents:
diff changeset
145 I have added a new program, mainly of debugging, which when passed
6b1b602514db Initial revision
carl
parents:
diff changeset
146 an ID value and a pst file, will extract and decrypt that ID from
6b1b602514db Initial revision
carl
parents:
diff changeset
147 the pst file. I don't see it being a huge attraction, or of much use
6b1b602514db Initial revision
carl
parents:
diff changeset
148 to most people, but it is another example of writing an application
6b1b602514db Initial revision
carl
parents:
diff changeset
149 to use the libpst interface.
6b1b602514db Initial revision
carl
parents:
diff changeset
150
6b1b602514db Initial revision
carl
parents:
diff changeset
151 Another fix was in the reading of the item index. This has hopefully
6b1b602514db Initial revision
carl
parents:
diff changeset
152 now been corrected. The result of this bug was that not all the emails
6b1b602514db Initial revision
carl
parents:
diff changeset
153 in a folder were converted. Hopefully you should have more luck now.
6b1b602514db Initial revision
carl
parents:
diff changeset
154
6b1b602514db Initial revision
carl
parents:
diff changeset
155 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
156 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
157
6b1b602514db Initial revision
carl
parents:
diff changeset
158 LibPST v0.3.2
6b1b602514db Initial revision
carl
parents:
diff changeset
159 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
160
6b1b602514db Initial revision
carl
parents:
diff changeset
161 Quick bugfix release. There was a bug in the decryption of the basic
6b1b602514db Initial revision
carl
parents:
diff changeset
162 encryption that outlook uses. One byte, 0x6c, was incorrectly decrypted
6b1b602514db Initial revision
carl
parents:
diff changeset
163 to 0x6c instead of 0xcd. This release fixes this bug. Sorry...
6b1b602514db Initial revision
carl
parents:
diff changeset
164
6b1b602514db Initial revision
carl
parents:
diff changeset
165
6b1b602514db Initial revision
carl
parents:
diff changeset
166 LibPST v0.3.1
6b1b602514db Initial revision
carl
parents:
diff changeset
167 =============
6b1b602514db Initial revision
carl
parents:
diff changeset
168
6b1b602514db Initial revision
carl
parents:
diff changeset
169 Minor improvements. Fixed bug when linking multiple blocks together,
6b1b602514db Initial revision
carl
parents:
diff changeset
170 so now the linking blocks are not "encrypted" when trying to read
6b1b602514db Initial revision
carl
parents:
diff changeset
171 them.
6b1b602514db Initial revision
carl
parents:
diff changeset
172
6b1b602514db Initial revision
carl
parents:
diff changeset
173
6b1b602514db Initial revision
carl
parents:
diff changeset
174 LibPST v0.3
6b1b602514db Initial revision
carl
parents:
diff changeset
175 ===========
6b1b602514db Initial revision
carl
parents:
diff changeset
176
6b1b602514db Initial revision
carl
parents:
diff changeset
177 A lot of bug fixing has been done for this release. Testing has been
6b1b602514db Initial revision
carl
parents:
diff changeset
178 done on the creation of the files by readpst. Better handling of
6b1b602514db Initial revision
carl
parents:
diff changeset
179 large binaries being extracted from the PST file has been implemented.
6b1b602514db Initial revision
carl
parents:
diff changeset
180
6b1b602514db Initial revision
carl
parents:
diff changeset
181 Quite a few reports have come in about not being able to compile on
6b1b602514db Initial revision
carl
parents:
diff changeset
182 Darwin. This could be down to using macros with variable parameter
6b1b602514db Initial revision
carl
parents:
diff changeset
183 lists. This has now been changed to use C functions with variable
6b1b602514db Initial revision
carl
parents:
diff changeset
184 parameters. I hope this fixes a lot of problems.
6b1b602514db Initial revision
carl
parents:
diff changeset
185
6b1b602514db Initial revision
carl
parents:
diff changeset
186 Added support for recreating the folder structure into normal
6b1b602514db Initial revision
carl
parents:
diff changeset
187 directories. For Instance:
6b1b602514db Initial revision
carl
parents:
diff changeset
188
6b1b602514db Initial revision
carl
parents:
diff changeset
189 Personal Folders
6b1b602514db Initial revision
carl
parents:
diff changeset
190 |-Inbox
6b1b602514db Initial revision
carl
parents:
diff changeset
191 | |-Jokes
6b1b602514db Initial revision
carl
parents:
diff changeset
192 | |-Meetings
6b1b602514db Initial revision
carl
parents:
diff changeset
193 |-Send Items
6b1b602514db Initial revision
carl
parents:
diff changeset
194
6b1b602514db Initial revision
carl
parents:
diff changeset
195 each folder containing an mbox file with the correct emails for that
6b1b602514db Initial revision
carl
parents:
diff changeset
196 folder.
6b1b602514db Initial revision
carl
parents:
diff changeset
197
6b1b602514db Initial revision
carl
parents:
diff changeset
198 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
199 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
200
6b1b602514db Initial revision
carl
parents:
diff changeset
201
6b1b602514db Initial revision
carl
parents:
diff changeset
202 LibPST v0.3 beta1
6b1b602514db Initial revision
carl
parents:
diff changeset
203 =================
6b1b602514db Initial revision
carl
parents:
diff changeset
204
6b1b602514db Initial revision
carl
parents:
diff changeset
205 Again, a shed load of enhancements. More work has been done on the
6b1b602514db Initial revision
carl
parents:
diff changeset
206 mime creation. A bug has been fixed that was letting part of the
6b1b602514db Initial revision
carl
parents:
diff changeset
207 attachments that were created disappear.
6b1b602514db Initial revision
carl
parents:
diff changeset
208
6b1b602514db Initial revision
carl
parents:
diff changeset
209 A major enhancement is that "compressible encryption" support has been
6b1b602514db Initial revision
carl
parents:
diff changeset
210 added. This was an incredibly simple method to use. It is basically a
6b1b602514db Initial revision
carl
parents:
diff changeset
211 ceasar cipher. It has been noted by several users already that the PST
6b1b602514db Initial revision
carl
parents:
diff changeset
212 password that Outlook uses, serves *no purpose*. It is not used to
6b1b602514db Initial revision
carl
parents:
diff changeset
213 encrypt the PST, it is mearly stored there. This means that the
6b1b602514db Initial revision
carl
parents:
diff changeset
214 readpst application is able to convert PST files without knowing the
6b1b602514db Initial revision
carl
parents:
diff changeset
215 password. Microsoft have some explaning to do!
6b1b602514db Initial revision
carl
parents:
diff changeset
216
6b1b602514db Initial revision
carl
parents:
diff changeset
217 Output files are now not overwritten if they already exist. This means
6b1b602514db Initial revision
carl
parents:
diff changeset
218 that if you have two folders in your PST file named "fred", the first
6b1b602514db Initial revision
carl
parents:
diff changeset
219 one encountered will be named "fred" and the second one will be named
6b1b602514db Initial revision
carl
parents:
diff changeset
220 "fred00000001". As you can see, there is enough room there for many
6b1b602514db Initial revision
carl
parents:
diff changeset
221 duplicate names!
6b1b602514db Initial revision
carl
parents:
diff changeset
222
6b1b602514db Initial revision
carl
parents:
diff changeset
223 Output filenames are now restricted. Any "/" or "\" characters in the
6b1b602514db Initial revision
carl
parents:
diff changeset
224 name are replaced with "_". If you find that there are any other
6b1b602514db Initial revision
carl
parents:
diff changeset
225 characters that need to be changed, could you please make me aware!
6b1b602514db Initial revision
carl
parents:
diff changeset
226
6b1b602514db Initial revision
carl
parents:
diff changeset
227 Thanks to Berry Wizard for help with supporting the encryption.
6b1b602514db Initial revision
carl
parents:
diff changeset
228
6b1b602514db Initial revision
carl
parents:
diff changeset
229 Thanks to Auke Kok, Carolus Walraven and Yogesh Kumar Guatam for providing debugging
6b1b602514db Initial revision
carl
parents:
diff changeset
230 information and testing.
6b1b602514db Initial revision
carl
parents:
diff changeset
231
6b1b602514db Initial revision
carl
parents:
diff changeset
232 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
233 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
234
6b1b602514db Initial revision
carl
parents:
diff changeset
235
6b1b602514db Initial revision
carl
parents:
diff changeset
236 LibPST v0.2 beta1
6b1b602514db Initial revision
carl
parents:
diff changeset
237 =================
6b1b602514db Initial revision
carl
parents:
diff changeset
238
6b1b602514db Initial revision
carl
parents:
diff changeset
239 Hello once more...
6b1b602514db Initial revision
carl
parents:
diff changeset
240
6b1b602514db Initial revision
carl
parents:
diff changeset
241 Attachments are now re-created in mime format. The method is very
6b1b602514db Initial revision
carl
parents:
diff changeset
242 crude and could be prone to over generalisation. Please test this
6b1b602514db Initial revision
carl
parents:
diff changeset
243 version, and if attachments are not recreated correctly, please send
6b1b602514db Initial revision
carl
parents:
diff changeset
244 me the email (complete message source) of the original and
6b1b602514db Initial revision
carl
parents:
diff changeset
245 converted. Cheers.
6b1b602514db Initial revision
carl
parents:
diff changeset
246
6b1b602514db Initial revision
carl
parents:
diff changeset
247 I hope this will work for everyone who uses this program, but reality
6b1b602514db Initial revision
carl
parents:
diff changeset
248 can be very different!
6b1b602514db Initial revision
carl
parents:
diff changeset
249
6b1b602514db Initial revision
carl
parents:
diff changeset
250 Let us see how it goes...
6b1b602514db Initial revision
carl
parents:
diff changeset
251
6b1b602514db Initial revision
carl
parents:
diff changeset
252 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
253 <dave.s@earthcorp.com>
6b1b602514db Initial revision
carl
parents:
diff changeset
254
6b1b602514db Initial revision
carl
parents:
diff changeset
255 LibPST v0.2 alpha1
6b1b602514db Initial revision
carl
parents:
diff changeset
256 ===========
6b1b602514db Initial revision
carl
parents:
diff changeset
257
6b1b602514db Initial revision
carl
parents:
diff changeset
258 Hello!
6b1b602514db Initial revision
carl
parents:
diff changeset
259
6b1b602514db Initial revision
carl
parents:
diff changeset
260 Some improvements. The internal code has been changed so that
6b1b602514db Initial revision
carl
parents:
diff changeset
261 attachments are now processed and loaded into the structures. The
6b1b602514db Initial revision
carl
parents:
diff changeset
262 readpst program is not finished yet. It needs to convert these binary
6b1b602514db Initial revision
carl
parents:
diff changeset
263 structs into mime data. At present it just saves them to the current
6b1b602514db Initial revision
carl
parents:
diff changeset
264 directory, overwriting any previous files with the attachment name.
6b1b602514db Initial revision
carl
parents:
diff changeset
265
6b1b602514db Initial revision
carl
parents:
diff changeset
266 Improvements over previous version:
6b1b602514db Initial revision
carl
parents:
diff changeset
267 * KMail output is supported - if the "-k" flag is specified, all the
6b1b602514db Initial revision
carl
parents:
diff changeset
268 directory hierarchy is created using the KMail standard
6b1b602514db Initial revision
carl
parents:
diff changeset
269 * Lots of bugs and memory leaks fixed
6b1b602514db Initial revision
carl
parents:
diff changeset
270
6b1b602514db Initial revision
carl
parents:
diff changeset
271
6b1b602514db Initial revision
carl
parents:
diff changeset
272 Usage:
6b1b602514db Initial revision
carl
parents:
diff changeset
273
6b1b602514db Initial revision
carl
parents:
diff changeset
274 ReadPST v0.2alpha1 implementing LibPST v0.2alpha1
6b1b602514db Initial revision
carl
parents:
diff changeset
275 Usage: ./readpst [OPTIONS] {PST FILENAME}
6b1b602514db Initial revision
carl
parents:
diff changeset
276 OPTIONS:
6b1b602514db Initial revision
carl
parents:
diff changeset
277 -h - Help. This screen
6b1b602514db Initial revision
carl
parents:
diff changeset
278 -k - KMail. Output in kmail format
6b1b602514db Initial revision
carl
parents:
diff changeset
279 -o - Output Dir. Directory to write files to. CWD is changed *after* opening pst file
6b1b602514db Initial revision
carl
parents:
diff changeset
280 -V - Version. Display program version
6b1b602514db Initial revision
carl
parents:
diff changeset
281
6b1b602514db Initial revision
carl
parents:
diff changeset
282 If you want to view lots of debug output, modify a line in "define.h"
6b1b602514db Initial revision
carl
parents:
diff changeset
283 from "//#define DEBUG_ALL" to "#define DEBUG_ALL". It would then be
6b1b602514db Initial revision
carl
parents:
diff changeset
284 advisable to pipe all output to a log file:
6b1b602514db Initial revision
carl
parents:
diff changeset
285
6b1b602514db Initial revision
carl
parents:
diff changeset
286 ./readpst -o out pst_file &> logfile
6b1b602514db Initial revision
carl
parents:
diff changeset
287
6b1b602514db Initial revision
carl
parents:
diff changeset
288 Dave Smith
6b1b602514db Initial revision
carl
parents:
diff changeset
289
6b1b602514db Initial revision
carl
parents:
diff changeset
290 LibPST v0.1
6b1b602514db Initial revision
carl
parents:
diff changeset
291 ===========
6b1b602514db Initial revision
carl
parents:
diff changeset
292
6b1b602514db Initial revision
carl
parents:
diff changeset
293 Hi Folks!
6b1b602514db Initial revision
carl
parents:
diff changeset
294
6b1b602514db Initial revision
carl
parents:
diff changeset
295 This has been a long, hard slog, but I now feel that I have got
6b1b602514db Initial revision
carl
parents:
diff changeset
296 somewhere useful. The included program "main" is able to read an
6b1b602514db Initial revision
carl
parents:
diff changeset
297 Outlook PST file and dump the emails into mbox files, separating each
6b1b602514db Initial revision
carl
parents:
diff changeset
298 folder into a different mbox file. All the mbox files are stored in
6b1b602514db Initial revision
carl
parents:
diff changeset
299 the current directory and no attempt is yet made to organise these
6b1b602514db Initial revision
carl
parents:
diff changeset
300 files into a directory hierarchy. This would not be too difficult to
6b1b602514db Initial revision
carl
parents:
diff changeset
301 achieve though.
6b1b602514db Initial revision
carl
parents:
diff changeset
302
6b1b602514db Initial revision
carl
parents:
diff changeset
303 Email attachments are not yet handled, neither are Contacts.
6b1b602514db Initial revision
carl
parents:
diff changeset
304
6b1b602514db Initial revision
carl
parents:
diff changeset
305 There is no pretty interface yet, but you can convert a PST file in
6b1b602514db Initial revision
carl
parents:
diff changeset
306 the following manner
6b1b602514db Initial revision
carl
parents:
diff changeset
307
6b1b602514db Initial revision
carl
parents:
diff changeset
308 ./main {path to PST file}
6b1b602514db Initial revision
carl
parents:
diff changeset
309
6b1b602514db Initial revision
carl
parents:
diff changeset
310 This is very much a work in progress, but I thought I should release
6b1b602514db Initial revision
carl
parents:
diff changeset
311 this code so that people can lose their conception that outlook files
6b1b602514db Initial revision
carl
parents:
diff changeset
312 will never be converted to Linux.
6b1b602514db Initial revision
carl
parents:
diff changeset
313
6b1b602514db Initial revision
carl
parents:
diff changeset
314 I am intending that the code I am writing will be developed into
6b1b602514db Initial revision
carl
parents:
diff changeset
315 greater applications to provide USEFUL tools for accessing and
6b1b602514db Initial revision
carl
parents:
diff changeset
316 converting PST files into a variety of formats.
6b1b602514db Initial revision
carl
parents:
diff changeset
317
6b1b602514db Initial revision
carl
parents:
diff changeset
318 One point I feel I should make is that Outlook, by default, creates
6b1b602514db Initial revision
carl
parents:
diff changeset
319 "Compressible Encryption" PST files. I have not, as yet, attempted to
6b1b602514db Initial revision
carl
parents:
diff changeset
320 write any decryption routines, so you will not be able to convert
6b1b602514db Initial revision
carl
parents:
diff changeset
321 these files. However, if you create a new PST file and choose not to
6b1b602514db Initial revision
carl
parents:
diff changeset
322 make an encrypted one, you can copy all your emails into this new one
6b1b602514db Initial revision
carl
parents:
diff changeset
323 and then convert the unencrypted one.
6b1b602514db Initial revision
carl
parents:
diff changeset
324
6b1b602514db Initial revision
carl
parents:
diff changeset
325 I hope you enjoy,
6b1b602514db Initial revision
carl
parents:
diff changeset
326
6b1b602514db Initial revision
carl
parents:
diff changeset
327 Dave Smith