1. Disclaimer
=============
This program may or may not do what you think it does. It may or may
not do what its documentation (including this file) tells you it
does. USE AT YOUR OWN RISK! The author may not be held liable for any
damage caused by running this program. Or any other damage, for that
matter. Blablabla. ;)

2. Copyright
============
This package was written and is copyright by Dmitry Sumin,
<sumin@math.msu.su>, or for fido net members
2:5020/651.4@fidonet.org.

Official home page is: http://www.math.msu.su/~sumin/msofpass.html

3. What is this?
================
This package was intended for discovering "forgotten" passwords for
files created with programs from the Microsoft Office.

Since I don't have time to support any registered users, I have
decided to release this program as *CardWare*. I don't remember who
coined that term, but its meaning is simple:

If you like the program, send me a postcard. Picture postcards from
the area where you live are preferred. On the card you may write
anything you like, e. g. how much you like the program, what a great
person I am, or whatever comes to your mind.  Be creative! :-)

My snail mail address is:

    Dmitry Sumin
    Pivchenkova str. 1-1-55,
    121108 Moscow

    Russia

    Phone +7 (095) 144-9986

Thanks.

4. Requirements
===============
 * Windows 95, Windows NT 3.x or higher
 * MS Visual C 5.0 runtime DLL (msvcrt.dll)

5. Using msofpass
=================
Well, it's simple:

  MsOfPass <in-file-name>

6. Supported programs
=====================
Program is designed to find passwords in files created with
following programs:

               Excel       Word
             5.0   7.0   6.0   7.0
           +-----+-----+-----+-----+
English    |  X  |  X  |  X  |  X  |
Russian    |  X  |  X  |  X  |  X  |
French     |  X  |  X  |  X  |  X  |
Slovenian  |  X  |  X  |  X  |  X  |
Spanish    |  X  |     |  X  |     |
Norwegian  |  X  |     |  X  |     |
German     |     |  X  |     |  X  |
Portuguese |     |  X  |     |  X  |
Dutch      |     |  X  |     |  X  |
Czech      |     |  X  |  X  |  X  |
Polish     |     |  X  |  X  |     |
Chinese    |     |     |  X  |  X  |
Italian    |     |     |  X  |     |
Finish     |     |     |  X  |     |
Danish     |     |     |     |  X  |
Swedish    |     |     |     |  X  |
           +-----+-----+-----+-----+

7. Frequently Asked Questions
=============================
Q: "When the version for Office 97 documents will be available?"
A: Alpha version of a brute force cracker is ready. It's too slow
   to be released (1000 pwd/second), I'm now working on next
   version.

Q: "When I run the program it says 'Working...failed'. What is that
   supposed to mean?"
A: File is not password protected or program used is not in the
   list of supported programs. Check the list. If information
   is vital for you and file size is less than 512KB you can
   try to send it to me, and maybe I can help you.

Q: "I can open file, but I can't change anything, or edit forms.
   Can I obtain protection passwords with this program?"
A: No. This program is intended for recovering lost
   passwords required to _open_ documents, not to _change_ them.
   You could try ex_pass available at the home page.

Q: "I found a bug, what should I do?"
A: Please report it to me, but I don't guarantee that it will be
   fixed. I will try. ;)

Q: "Where can I find the latest version of the program?"
A: Check http://www.math.msu.su/~sumin/msofpass.html

Q: "I'm running Win 3.1, Win32s, OS/2 or WABI, will your program run
   under those OSes?"
A: No. Please read 'Requirements' section.

Q: "Will your program recover passwords for MS Access files?"
A: No.

8. Adding additional localized version
======================================
To include an additional localized Word or Excel version in a future
release I need two files. Both should contain following text
(with no quotes):

'This is a test file for ms of pass. 0123456789ABCDEF.'

Word files should contain only this text, Excel files should
contain this text in A1 cell.

First file should be with no password, and the second protected with
password 'justatest' (with no quotes again).

Please ZIP files before sending them to me. If you would like to see
your name (and optionally e-mail) in documentation please send it
along with files.

9. Future versions
==================
For now I stopped development of 1.XXX version. Now I'm researching
algorithms used by Office 97 to protect data. I'm not quite
sure that Office 97 version will ever be released, but I really hope so.

10. Thanks
=========
First of all I want to thank people that inspired me and made my
life more interesting: Tatiana Gulak, Nick Grachev, Nikita Kuznetsov,
Eva Tulpan and Katja Semihatova. Thank you, guys.

Thanks to all of you who sent me comments, bug reports and
encrypted files.

Special thanks to all who found 5 minutes to send me a post card.
All postcards are really great!

10. History
===========
 2.0.1.4 Feb 10 1998
   New patterns: Word 7.0,6.0, Excel 5.0,7.0  - Slovenian

 2.0.1.3 Feb  3 1998
   New patterns: Word 7.0 - Czech, Excel 7.0 - Czech

 2.0.1.2 Jan 31 1998
   New pattern: Word 7.0 Swedish

 2.0.1.0 Dec 12 1997
   New patterns: Word 6.0 - Norwegian, Spanish & Polish;
   Excel 5.0 - Norwegian & Spanish;
   Excel 7.0 - Norwegian, Portuguese & French;
   Word 7.0 - Portuguese;

   New version scheme

 1.998 Oct 15 1997
   Word 6.0/Finish pattern added.

   Word 7.0/Danish pattern added.

 1.997 Oct  1 1997
   Word 6.0/7.0/Chinese pattern added.

   Word 6.0/Slovenian pattern added.

   Command line syntax was changed.

 1.996 Sep 15 1997
   Excel/Word 7.0/German pattern added.

 1.995 Sep 11 1997
   Word 6.0/French pattern added.

 1.994 Sep 10 1997
   Excel 5.0/French pattern added.

 1.993 Sep 9  1997
   Word 7.0/French pattern added.

 1.992 Sep 3  1997
   Word&Excel 7.0/Dutch patterns added.

 1.991 Aug 29 1997
   Word 6.0/Italian pattern added.

   In future versions MSOfPass will be compiled with
   Visual C++ 5.0.

 1.99  Jun 24 1997
   Slightly changed Excel engine to deal with some strange versions
   of Excel.

 1.98  Jun  1 1997
   Excel 7.0/Russian pattern changed.

   Excel engine changed. This should solve problem with Excel files,
   that had 'write reservation' password.

   Executable is now smaller (8KB). But who cares ;)

 1.97  Apr  9 1997
   Excel 5.0/Russian pattern added, that has been accidentally left
   out in the 1.96 version.

 1.96  Feb 24 1997
   First version that went into public

With best regards,
Dmitry Sumin
