annotate README.txt @ 4:28737b9480e4

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