This software is Freeware!!

This software is provided as is without any warranty of any kind.
You are free to copy and distribute it as you like in source or
binary form provided that this notice and author credits remain intact
in the source.  You are also free to alter, enhance, embellish, or 
otherwise change its content provided that the credits to the
original author remain, and that any changes are commented stating
the change made and the author of that change.  You may NOT profit in
any way from the sale or distribution of this software in its original
or altered form.

-----

To extract, use 'pkzip -d scanfilb.zip'.  This will preserve
the directory structure.

If the directory structure is intact after extraction, then
you will see the following files (paths included) starting
at the directory of extraction:

README.txt                            | This file

SCANFILE\SOURCE\scanfile.h            | Sources for scanfile.exe and
SCANFILE\SOURCE\scanfile.c            | extrfile.exe under the Borland C++ 4.02
SCANFILE\SOURCE\lim.c                 | for Win95 environment. 
SCANFILE\SOURCE\extrfile.txt          | The *.txt files are ascii manual pages
SCANFILE\SOURCE\scanfile.txt          | for the utilities.
SCANFILE\SOURCE\extrfile.c            |
SCANFILE\SOURCE\getoptux.c            |

SCANFILE\BINARY\WIN32\extrfile.exe    | The Win95/WinNT binaries compiled
SCANFILE\BINARY\WIN32\scanfile.exe    | from the above sources

-----

I conceived these utilities out of a need to compare
and contrast sectors from floppies and hard drives.  I wanted
to see how well a utility called MBR Wizard could regenerate
DOS partition, boot, and FAT sectors.  MBR Wizard did
well with boot and partition sectors. It didn't do well with
FAT sectors, even in simple situations where I scrambled
the first copy and let the second copy of floppy FAT sectors
untouched.  Anyway, the scanfile utility proved quite useful.
I hope you enjoy using it as much as I've enjoyed writing it.

I would greatly appreciate that if you discover any bugs, or
if you think of any useful enhancements, please e-mail them
to me at:

metcalf@snet.net

Thanks,

Jeffrey M. Metcalf
19-May-98
------------------

I have successfully compiled the utilities under:

a. UNIX or The Cygnus B19 GNU environment for Win95/NT.

	For the sources under this environment, please download 

	'scanfils.tgz'

b. The Borland C++ 4.02 environment.  Note: you will probably get it to 
compile under a better version of Borland C++ with little or no changes.

	For the sources (and binaries) under this environment, please download

	'scanfilb.zip'

-------------------------------------------------------------------
a.

*********
For UNIX:

1. Edit 'Makefile' changing any of the following variables:

CC=     Name of your C compiler
CFLAGS= Options to give your C compiler

MANDIR= Location you wish to put the manual pages
BINDIR= Location you wish to put the binaries

Note: You must be root to put the the manual pages and
      the binaries into directories not owned by you.

2. Type 'make'

3. Type 'make install'

4. If you do not have the capability to display groff formatted
manual pages, I have provided 'scanfile.txt' and 'extract.txt'.

************************************************
For The Cygnus B19 GNU environment for Win95/NT:

1. Copy 'Makefile.win32' to 'Makefile'.

2. Edit 'Makefile' changing any of the following variables:
 
CC=     Name of your C compiler
CFLAGS= Options to give your C compiler
RM=	Command to delete files
CP=	Command to copy files

BINDIR= Location you wish to put the binaries

3. Remove any actions you don't want to be performed (eg. remove the
$(STRIP) lines if you don't have the strip executable).

4. Uncomment the '#define GCCWIN32' in scanfile.c and extract.c

5. Type 'make'

6. Type 'make install'

7. I have provided 'scanfile.dos' and 'extrfile.dos' as substitutes
for groff formatted manual pages.

-------------------------------------------------------------------
b.

****************************************
Compiling with Borland C++ version 4.02:

1. Extract the package.  Go to the SOURCE directory and make an IDE for
each of the 'scanfile.c' and 'extrfile.c' sources.  Remember these are
C sources, not C++.

2. I suggest building for Win32 and Console using runtime libraries.
If you want to distribute them without also having to include the Borland
runtime dll's, select static linking.

*************
The binaries:

Extract the package and look under the BINARIES\WIN32 directory.
The binaries are there.  You don't need any dll's.  Just put them
somewhere in your path.


I have provided 'scanfile.txt' and 'extrfile.txt' to describe the
utilities.

