      DFSee version 6.13 09-09-2004  (c) 1994-2003: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

Installation
_______________________________________________________________________________

The standard distribution of DFSee (DFSEEvxx.ZIP) contains all the
files you will need to use it, organized in the following directories:

 - DOS    Everything needed or usable to run on DOS or Windows-9x full-screen
 - WIN    Everything needed or usable to run on Windows-NT, 2000 or XP
 - OS2    Everything needed or usable to run on OS/2 version 2.0 or newer
 - LINUX  Everything needed or usable to run on LINUX, kernel 2.x or newer
 - DOC    The main DFSee documentation files in a text format
          with detailed information about DFSee and the commands.

So, just unzip DFSEE.ZIP in a directory of your choice ...

WARNING:   Do NOT install DFSee in a path containing any SPACES
           like 'C:\Program files\dfsee 6xx'
           This may cause lots of problems with running scripts
           and accessing other files from within DFSee.

IMPORTANT: When you are new to DFSee,  I recommend you use the
           DFSTART script to start with.  It will collect some
           very useful backup files the first time it is used
           (not available for Linux yet)

           To collect minimal information about your system, to
           email to others, or post on newsgroups for help, use:

           DFSxxx -query

           Where DFSxxx is any of the DFSee executables (see below)
           It will produce a "dfsquery.log" file to be sent/posted.


DFSee is a SWISS-ARMY KNIFE of disk-tools packaged in a single
executable file (.EXE). There is really no need for 'installing'
anything, as long as the executable can be found.
(in the PATH for instance).

So make sure the executable is in a tools directory or a directory
of its own, and make sure that directory is in the PATH to make it
more convenient. The only thing that IS a bit important is that
the registration file needs to be in a directory in the PATH as
well, and must be renamed to the fixed name: 'dfsee.key'.

Available executables:

- DFSOS2.EXE    The OS/2 executable, full function including REXX
- DFSWIN.EXE    The Win-NT/2000/XP executable, full function
- DFSDOS.EXE    The (extended) DOS executable, full function
- dfsee         The native Linux executable,   full function

_______________________________________________________________________________

Important backups
_______________________________________________________________________________

I advise you to keep a copy of DFSDOS.EXE on a DOS boot-diskette for
emergency purposes.

Then an important backup command to used on your existing system(s)
as a preventive measure:

DFSOS2.EXE psave * filename  Some short description of your system

Will make a backup of all important partition-table and boot sectors
to a relatively small file that can be used in cases of emergency to
restore them (with prestore).

Use a meaningful 'filename' for each different system you backup.
(of course it works just as well with DFSDOS.EXE or DFSWIN.EXE)

For extra information on the systems you could also run the
DFSDISK.CMD or DFSDISK.BAT script that comes with DFSee.
It will create four DFSDISKI.* files for each physical harddisk
in the system (note: not available for Linux yet)

Note: The DFSDISK and PSAVE stuff above is included in DFSTART,
      so if you use that you are on the safe side!

_______________________________________________________________________________

Online Help
_______________________________________________________________________________

As a command-line program, DFSee has limited online help, useful
to check the syntax and parameters. The following is available:

'help'  command  : This will display a short introduction and a few
                   important selection commands.

'??'    command  : List all generic commands, available in every mode

'?'     command  : List all commands specific to the current mode

'???'   command  : List sector-types recognized in the current mode

DFSEE   -?       : List available switches for the DFSee executable
                   from the operating-system command-line.
                   The switches set some preferences and options like
                   windowing, using a logfile and batch-mode.
                   (DFSEE = DFSDOS, DFSOS2, DFSWIN or dfsee).

Most commands that require parameters will also display a short usage
and help when called without any parameters, or sometimes when called
with the parameter '-?'

Finally, whenever a (confirmation) dialog window is presented to ask a
question or get other input, you can use the <F1> function-key to get
additional help on that specific dialog or question.

_______________________________________________________________________________

Recommended reading
_______________________________________________________________________________

DFSee is a rather complex program with dozens of commands that could
be used. You will need some time and effort to master that complexity.

All commands and some generic topics are covered in DFSxxxx.txt files:

- DFSEE.TXT     = A short introduction to DFSee and its concepts
- DFSINST.TXT   = short installation description
- DFSPROMO.TXT  = A short promotional text on DFSee and its concepts
- DFSHOWTO.TXT  = An ever growing collection of recovery scenarios and
                  other useful DFSee usage examples
- DFSTERMS.TXT  = A terminology reference about DFSee and partitioning
- DFSCMDS.TXT   = The main command-reference with all generic commands
- DFSDISK.TXT   = Description and examples of the DFSee UNFDISK procedure
- DFSFDISK.TXT  = The FDISK (partitioning) command reference
- DFSHPFS.TXT   = Command reference specific to the HPFS filesystem
- DFSNTFS.TXT   = Command reference specific to the NTFS filesystem
- DFSFAT.TXT    = Command reference specific to the FAT  filesystems
- DFSJFS.TXT    = Command reference specific to the JFS  filesystem
- DFSEXT.TXT    = Command reference specific to the EXT2 and EXT3 filesystem
- DFSRSR.TXT    = Command reference specific to the REISER filesystem
- DFSCRIPT.TXT  = Reference for using command-scripts with DFSee
- DFSHIST.TXT   = History of changes for DFSee, known bugs and wish-list
- DFSYNTAX.TXT  = Syntax rules for DFSee command, parameters and options


There is some additional material on the DFSee website, like links to
reviews and tutorials by others:

        http://www.dfsee.com/dfsee.htm#intro

And a few presentations that explain some background on DFSee and
filesystems. (Lotus Freelance format, and low-quality HTML)

        http://www.dfsee.com/present

_______________________________________________________________________________

Known Problems
_______________________________________________________________________________

The OS2 version, DFSOS2.EXE is known to fail (abort on startup) when a
virtual floppy-disk driver is loaded that is not initialized, as in:

        device=c:\tools\vfdisk.sys  0

Initializing it to another value (like 3 for a 1.44Mb diskette) solves that.

