HPFSRead 1.0  (c) 1993 by Peter Kraufmann
=========================================
[English translation by James B. Mehl; English-language executable
 patched by Greg R. Roelofs.  6 November 1993]

1. Functions
------------

This program makes it possible to read OS/2 HPFS partitions under
normal DOS (!).

After starting the program a table appears with all HPFS partitions
found on your system.  All partitions on hard disk 1 are displayed
first, then hard disk 2.  "1st sector" is the sector number of the
beginning of the partition, counted from the physical origin of the
disk.

"Vol Label" is the label specified either with the label command
or at formatting.  "Last CHKDSK" shows dates and times of the last
"CHKDSK /F" operation on the partition.

If a partition is selected the root directory of the partition will be
displayed.  In the first line the actual path is displayed in white on
green.  The partition number is displayed instead of the drive letter
because DOS has no letter-designations for HPFS drives.

The directory contents are displayed as in a full-screen OS/2 session.
In order to display a better summary, directories are displayed in
yellow, normal files in white and hidden files in grey.  In addition,
the file attributes are shown.  The attributes are coded as follows:

  S = system        H = hidden     R = read-only     A = archive
  V = volume label  D = directory  L = long (non-FAT) filename

It can occasionally happen that a filename is displayed in RED.  This
means that the file consists of more than 8 non-contiguous groups of
sectors, i.e. it is "fragmented".  One can thus use this program to
determine the disk's fragmentation level, which can then be removed
with, e.g., the GAMMATECH Utilities.

If the complete list of directory contents will not fit on a single
screen the last line displayed is "Press any key to continue    <ESC>
to quit".  With <ESC> the display can be interrupted in order to return
directly to the beginning.

After the full display of directory contents the following selections
can be made in the last line (white on red):

- ENTER returns the program to the opening screen.

- a directory name causes the respective directory to be displayed;
  with ".." the parent of the current directory is displayed.

- a filename starts the copying of the file to the current FAT
  partition unless the target file specification contains another disk
  or path.

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

- Copying fragmented files (displayed in RED) is currently not possible.

- Writing to HPFS partitions is likewise not yet implemented, for this
  procedure is much more complicated than writing to FAT and is not
  yet functioning sufficiently reliably.

- With an unfavorable ordering of partitions on a disk (e.g., when
  Linux is installed besides OS/2 and DOS) it can happen that not all
  HPFS partitions will be recognized.  [GRR comment:  this can happen
  even with only two HPFS partitions on the disk.]

3. Contacting the author
------------------------

This version of HPFSRead can be copied at will and also distributed via
BBS's as long as this README file is included.

I can naturally give no guarantee for this program.  However, it has
been tested rather thoroughly subject to the above-noted limitations.

Comments, questions and problems can be sent 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. Future developments
----------------------

The following extensions are planned or are in preparation:

- comfortable TurboVision (tm) front end
- copying from fragmented files
- writing of files to HPFS partitions
- the long-awaited HPFS driver for DOS

Whoever can and will support me by supplying information is kindly
requested to do so, because the exact HPFS specification appears to 
be one of the best-kept secrets of "Big Blue" IBM.

Berlin, 29 September 1993

                                (Peter Kraufmann)
