HPFSRead 1.0  (c) 1993 by Peter Kraufmann
READHPFS.TXT is an English translation by Maurice Fox
=========================================

1. Function
-----------

This program makes it possible to read from an OS/2 HPFS partition under
normal DOS!

Ater starting, the program displays a table of all HPFS-partitions found, 
on hard disk 1, then all on hard disk 2.  "Startsektor" is the beginning 
of the partition in sectors from the physical beginning of the disk.

'Name" is the label applied, either with the LABEL command or by formatting.
'CHKDSK-Aufruf' shows the date and time of the latest time CHKDSK /F was
run against this partition.

When a partition is then selected, the root directory is displayed.  
(Translator's note.  He omitted to tell you to pick the partition you want
by typing in the number the program assigned.)  In the first line the 
actual path is displayed, except there is a number, because DOS does not 
assign letters for HPFS partitions.

The entries are displayed as in OS/2, for better viewing the directories
are yellow, normal files are white, and hidden files grey.  Additionally,
the attributes are displayed before the names.

The Attributes mean:

  S=System        H=Hidden     R=Read only
  L-Volume Label  D=Directory  E=long filename

It can occur that a file name is shown in RED.  This means that the file 
is in more than 8 contiguous areas on the disk, and is therefore fragmented.
One can therfore also use this program to find out the fragmentation of the
partition.  This can be fixed with GAMMATECH Utilities, for example.

In the last row it displays 'Weiter mit beliebiger Taste <ESC=Ende>', when 
not all the entries have been shown.  You can use <Esc> to break off the 
display and go directly to retrieval. (Translator's note:  It's 'Press
any key to continue <Esc=End>')

When the display of entries is ended, you can enter the following in the 
last row (white on red):

- a directory name causes that directory to be displayed.  Entering '..'  
  displays the parent directory of the current one.

- Immediate ENTER shows the entry screen

- A filename starts the copy of this data to an actual FAT partition, so 
  long as the destination is a different drive or a different path.

2. Limitations
--------------

- The copying of fragmented files (displayed in RED) is at the moment not 
  yet possible.

- Writing on HPFS Partitions is not yet implemented, because this advance is
  more complicated than with FAT and is not dependable enough yet.  
  (Translator's note:  I guess he means his implementation is not dependable
  enough yet.)

- With an unfavorable arrangement of partitions, for example when besides
  OS/2 and DOS, Linux is also installed, it can happen that not all HPFS
  drives can be recognized.

3. Contacting the Author
------------------------

The accompanying version of HPFSRead can be copied and placed on BBS, so
long as this README file accompanies it.

I can naturally make no guarantee for this program, although it runs 
dependably after detailed tests up to the foregoing limitations.

Comments, Questions, problems, please to my FIDO-Address:

   Peter Kraufmann 2:242/1213@fidonet

   CS-Port Berlin Tel: +49-30-4913418
   ZyXel 1496E+ modem (6.00)
   Baud Rate: 1200 - 19200 Baud

   Online   : 00:00 - 23:59  BBS/Mailer/FAX, no freq between 03:30-06


4.  Outlook for the future
--------------------------

The following extensions are planned or in work:

- comfortable TurboVision (tm) front end
- copying fragmented files
- writing files on HPFS partitions
- the longed-for HPFS driver for DOS

Whoever can and will support me with information, I ask you please, remember 
that the exact HPFS documentation is one of the best-protected trade secrets
of 'Big Blue" IBM.  (Translator's note:  Don't get on the wrong end of a
lawsuit!)

Berlin, September 29, 1993.

                                (Peter Kraufmann)

(Translator's note:  It's a best effort, folks, based on 11 years in Germany
and my faithful dictionary, plus trying out the program.)




