home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / dfsee510.zip / dfsee.txt < prev    next >
Text File  |  2003-01-14  |  17KB  |  390 lines
  1.   Display File Systems; version 5.10 14-01-2003  (c) 1994-2003; Jan van Wijk
  2.  ----------------------------[ www.dfsee.com ]-------------------------------
  3.  
  4.  
  5. C O N T E N T S:
  6. ================
  7.  
  8.    Overview       = a list of all documents
  9.    Introduction   = what is DFSee ?
  10.    Operating mode = small description how to handel dfsee commands
  11.    User Interface = user bedienung
  12.    Availability   = where can I get more information
  13.    Licence        = how to register dfsee
  14.    Limitations    = known limitations or bugs of dfsee
  15.    Improvements   = considered improvements
  16.  
  17.  
  18.  
  19. O V E R V I E W:
  20. ================
  21.  
  22. DFSee is a rather complex program with dozens of commands that could
  23. be used. You will need some time and effort to master that complexity.
  24.  
  25. All commands and some generic topics are covered in DFSxxxx.txt files:
  26.  
  27. - DFSEE.TXT     = This document, overview, introduction
  28. - DFSINST.TXT   = short installation description
  29. - DFSPROMO.TXT  = A short promotional text on DFSee and its concepts
  30. - DFSHOWTO.TXT  = An ever growing collection of recovery scenario's and
  31.                   other usefull DFSee usage examples
  32. - DFSTERMS.TXT  = A terminology reference about DFSee and partitioning
  33. - DFSCMDS.TXT   = The main command-reference with all generic commands
  34. - DFSFDISK.TXT  = The FDISK (partitioning) command reference
  35. - DFSHPFS.TXT   = Command reference specific to the HPFS filesystem
  36. - DFSNTFS.TXT   = Command reference specific to the NTFS filesystem
  37. - DFSFAT.TXT    = Command reference specific to the FAT  filesystems
  38. - DFSJFS.TXT    = Command reference specific to the JFS  filesystem
  39. - DFSCRIPT.TXT  = Reference for using command-scripts with DFSee
  40. - DFSHIST.TXT   = History of changes for DFSee, known bugs and wish-list
  41. - DFSYNTAX.TXT  = Syntax rules for DFSee command, parameters and options
  42. - DFSUNFD.TXT   = Description and examples of the DFSUNFD procedure
  43.  
  44.  
  45. I N T R O D U C T I O N:
  46. ========================
  47.  
  48.  What is DFSee ?
  49.  
  50.  Display File Systems (DFSee) is a generic partition and filesystem
  51.  browser/analyser. DFSee supports partition-tables (FDISK, LVM), (V)FAT,
  52.  FAT-32, HPFS-structures, some NTFS and JFS stuff and it might support
  53.  different file-systems like EXT2 in the future.
  54.  
  55.  DFSee, starting with version 4.00 is NOT freeware anymore, requiring
  56.  registration and payment for actual use and support.
  57.  
  58.  Several licence models are available, starting with a cheap single-user
  59.  individual registration for just 30 euro for the current 5.xx version.
  60.  
  61.  DFSee can be used in one of several ways:
  62.  
  63.  - As a replacement for the classic FDISK program
  64.  
  65.    DFSee is a complete replacement for the partitioning tools as
  66.    found with DOS, OS/2, Win9x, Windows-NT and Windows-2000
  67.  
  68.    At the moment (version 5.00) it is a nearly full-replacement for the
  69.    LVM utility used with eComStation, and Warp Server for e-Business.
  70.    The only thing not covered is creation of LVM-specific volumes (JFS).
  71.  
  72.    Apart from the standard create/delete type of functions there are
  73.    a lot of special commands to display information and fix all kinds
  74.    of problems related to partition-tables and LVM information.
  75.  
  76.    An often used function here is the DFSUNFD script that automates
  77.    the collection of needed information to 'UNDO' an accidental FDISK
  78.    operation or other partitioning related disaster.
  79.    Another important feature is the ability to save and restore ALL
  80.    partitioning information in a regular file that you can keep as a
  81.    backup on a diskette so recovery operations will be MUCH easier
  82.    (see PSAVE and PRESTORE commands).
  83.  
  84.    Finally, this FDISK capability is being used by large organisations
  85.    for automatic (and unattended) roll-out scenarios.
  86.  
  87.  
  88.  - As a tool to 'UNDELETE' files that have been accidentaly deleted,
  89.    or to recover/copy files from damaged or unaccessible filesystems
  90.  
  91.    This feature is implemented for HPFS and NTFS only, but on those
  92.    filesystems it is a very powerfull tool. It works by finding all
  93.    wanted files (DELFIND or FILEFIND), and then letting the user make
  94.    a selection based on a wild-card filespecification and an outlook
  95.    percentage for recoverability (DELSHOW or list +f).
  96.    The actual recover operation will copy the matching files to a
  97.    specified directory, if possible on another disk (RECOVER).
  98.  
  99.  
  100.  - As an analysis and recovery tool for most used filesystems.
  101.  
  102.    This includes boot-sectors, superblocks and low-level directory
  103.    structures. For most supported filesystems some specific commands
  104.    are available that fix common problems with that filesystem.
  105.  
  106.    To support a large number of possible filesystems, DFSee uses
  107.    specific modes of operation. Every mode has its own set of
  108.    of dedicated commands and recognized data formats (sector types).
  109.    Generic commands (and sector types) are available in all modes.
  110.    On selecting a data-source (disk, partition, volume) DFSee will
  111.    try to recognize the involved filesystem and activate support
  112.    for it automatically.
  113.  
  114.    The most important modes are:
  115.  
  116.    - FDISK  for partitioning work, default active at startup
  117.    - HPFS   native filesystem on OS/2, eComStation, WsEB ...
  118.    - FAT    classic PC filesystems including FAT32 and VFAT
  119.    - NTFS   native filesystem on Windows-NT or Windows-2000
  120.    - JFS    journaled filesystem on OS/2, eCS or WsEB
  121.    - AUX    Auxilary mode for unrecognized data
  122.  
  123.  
  124.  - As a simple but powerfull binary (or HEX) display and edit tool.
  125.  
  126.    DFSee can access data on hard-disks, operating-system volumes like
  127.    diskettes or CDROM and (image) files.
  128.  
  129.  
  130. U S E R   I N T E R F A C E:
  131. ============================
  132.  
  133.  The user-interface has a command entry-field with history buffer so
  134.  previous commands can be recalled, and a large scroll-buffer for output.
  135.  Output can also be copied to a file for later analysis.
  136.  
  137.  A more primitive 'classic' user-interface can be used as well, by
  138.  starting the program with a switch '-w-' (see DFSCMDS for details)
  139.  
  140.  DFSee commands are single words or (hexadecimal) numbers.
  141.  Most commands have one or more parameters of which some are optional.
  142.  
  143.  DFSee keeps track of the current- and some other useful SN's so they
  144.  can be referenced faster, without having to type them in. They are:
  145.  
  146.      Name          Cmd       Description
  147.      ----          ---       -----------
  148.      up            'u'       up in hierarchy
  149.      down          'd'       down in hierarchy
  150.      down          <Enter>   down in hierarchy
  151.      this          't'       this (current)
  152.      xtra          'x'       Extra, alternative
  153.  
  154.  You can display and analyse either a physical disk, a partition, a volume
  155.  or an imagefile. A physical disk can be opened using the 'disk' command.
  156.  
  157.  A disk-partition or volume can be opened first with the 'part' or 'vol'
  158.  commands respectively. The next prompt display will show some status info.
  159.  After opening an HPFS partition, using 'Enter' a few times will take you
  160.  to the superblock, root-directory, possible sub-directories upto some file.
  161.  
  162.  Multiple commands can be chained if separated with a special character,
  163.  the default is '#' but this can be changed with the '-s:xxx' switch.
  164.  
  165.  An overview of the available commands is given in DFSCMDS.TXT, it can also
  166.  be referenced from within the program using the 'help' command.
  167.  
  168. HINT: When using DFSee to create a logfile, DO NOT USE ">" REDIRECTION, use
  169.       the DFSee "log filename" command or the "-f" program switch instead.
  170.       This will prevent littering the logfile with ANSI control-codes.
  171.  
  172.       When browsing an LVM (WsEB, MCP or eComstation) system, set the
  173.       screen-width to over 100 characters when possible. This will allow
  174.       complete display of the volume + partition-names in the 'part' table
  175.  
  176.  
  177. O P E R A T I N G   M O D E:
  178. ============================
  179.  
  180.  An important concept is the "operating mode", when you startup
  181.  DFSee normally, it will be in "FDISK" mode and know about
  182.  fdisk-related stuff and has fdisk-related commands.
  183.  
  184.  The mode is always displayd at the status-line near the bottom
  185.  of the screen, together with other relevant details about which disk
  186.  or partition you are currently working on.
  187.  
  188.  You can get a brief list of the available commands in that mode
  189.  by using the "?" command (a single question-mark).
  190.  
  191.  There are also a lot of commands that are independant of the mode
  192.  and could be called "generic". You can get a brief list of those
  193.  by using the "??" command (TWO question marks).
  194.  
  195.  More help can be found in the .txt files, with most of the "generic"
  196.  commands in DFSCMDS.TXT.  The commands are in alphabetic
  197.  order there, but to find things you could use a "search" function
  198.  from the text-editor or viewing program you use ...
  199.  
  200.  The commands specific to a mode are in DFSmode.TXT, so for the FDISK
  201.  mode they are in DFSFDISK.TXT and for HPFS they are in DFSHPFS.TXT.
  202.  
  203.  Some hints and tips are in DFSHOWTO.TXT ...
  204.  
  205.  The mode is set automatically when you start DFSee, and when you select
  206.  some object like a disk or a partition to work with.  Selecting something to
  207.  work on is done with the DISK, PART, VOL or IM command.
  208.  
  209.  If automatic selection of the mode fails (because the object is damaged), you
  210.  can force a specific/desired mode by using the FS command, as in:
  211.  
  212.  FS HPFS
  213.  
  214.  Which will force the HPFS mode to become active.
  215.  
  216.  
  217. A V A I L A B I L I T Y:
  218. ========================
  219.  1) Home:         http://www.dfsee.com
  220.  
  221.  2) Download:     http://www.dfsee.com/dfsee.htm#download
  222.  
  223.  3) Registration: http://www.dfsee.com/dfsee.htm#register
  224.  
  225.  
  226. L I C E N C E:
  227. ==============
  228.  
  229.  This version of the program is SHAREWARE, it is NOT FREE!
  230.  
  231.  However, evaluation of the program is allowed for a limited time,
  232.  any real use or getting support requires a registration, one off:
  233.  
  234.  - Standard reg:     For use by ONE person on their own personal
  235.                      computer(s).       (no commercial use)
  236.  
  237.  - Professional reg: For use by ONE person on your own and your
  238.                      customers systems. (commercial use allowed)
  239.  
  240.  For details on the license agreements see:
  241.  
  242.          http://www.dfsee.com/dfsee.htm#register
  243.  
  244.  Without registration almost all functions are fully operational.
  245.  You WILL get some registration reminders and the trial time is
  246.  limited to a few months from release-date.
  247.  
  248.  Further development depends on my own needs and feedback I receive from
  249.  users, and the amount of registrations getting in over time ...
  250.  
  251.  Suggestions and other comments regarding DFSee and filesystems are welcome.
  252.  
  253.  If you have a disk-related problem, feel free to contact me, I cannot
  254.  guarantee prompt or continuous attention but I will do the best I can ...
  255.  
  256.  You can reach me through the Internet: support@dfsee.com
  257.  
  258.  NOTE: Version 3.42 is the last 3.xx version and is FREEWARE
  259.        Development of the 3.xx version is stopped so new functionality and
  260.        a better user-interface will only be in the SHAREWARE version.
  261.  
  262.        Version 4.28 is the last 4.xx version, it will be supported until
  263.        the end of 2002 (usage support only, in case of bugs, upgrade :-)
  264.  
  265.        Version 5.00 with a new 32-bit DOS-extended version has been released
  266.        early august 2002 ...
  267.  
  268.  
  269. L I M I T A T I O N S   A N D   B U G S:
  270. ========================================
  271.  
  272. - The 5.xx versions of DFSDOS.EXE can cause spurious hang-situations
  273.   on some systems. Often a hard-reset or power-down is required ...
  274.   Sometimes using a different version, or the trace-version DFSDOST.EXE
  275.   from DFSTRDOS.ZIP (see website) will help.
  276.   Also, use of memory managers like EMM386 has a negative impact on this!
  277.   This is very likely a memory-management or DOS-EXTENDER issue and
  278.   is under investigation.
  279.  
  280. - VOL command on large HPFS partitions (> 2GB) can cause traps, this is
  281.   not 100% reproducable on different systems and can sometimes be avoided
  282.   by opening a logfile (don't ask me why yet :-).  Under investigation.
  283.  
  284. - VOL command in some DOS versions is not reliable for writing harddisks.
  285.   Diskette writing seems OK.
  286.  
  287. - TRUNCATE/RESIZE command on NTFS works from version 4.12 but is not very
  288.   usefull yet because NTFS system partitions tend to scatter data all over
  289.   the volume. Future versions of DFSee might offer an optimizer for that.
  290.   Resize of an NTFS boot-partition will NOT work because the required
  291.   CHKDSK by Windows will fail. This can only be done if you have a second
  292.   bootable Windows-NT/W2K/XP partition available,
  293.  
  294. - The SETLET, NTMAP and other drive-letter related FDISK commands for Win-NT
  295.   do NOT work correctly or reliably on Windows-2000 and Windows-XP.
  296.  
  297.   DO NOT USE 'SETLET' on them, it might give unpredictable results!
  298.  
  299. - Allocation integrity checks do not check the allocation for EA's
  300.  
  301. - Accessing (large ?) partition using the 'vol' command in the DFSDOS version
  302.   seems to be unreliable. Wrong data is sometimes returned.
  303.   On a diskette (vol a:) everything seems to be OK, so I recommend using
  304.   only the 'part x' command for accessing hard-disk partitions and use
  305.   the 'vol' command only for floppies. (DFSDOS restriction only)
  306.  
  307.  
  308.  
  309. C O N S I D E R E D   I M P R O V E M E N T S:
  310. ==============================================
  311.  
  312.  User interface with menu's and GUI-like selection windows guiding the
  313.  less experienced user through the huge complexity of DFSee ...
  314.  
  315.  Rewrite of this documentation in a description, command-reference and
  316.  technical info on filesystems (possibly in HTML)
  317.  
  318.  More automatic detection of inconsistencies (like CHKDSK, CHKPART)
  319.    This will show HPFS problems like CHKDSK does, but in more detail and
  320.    maybe some more types of inconsistencies.
  321.  
  322.  Real coverage of other filesystems besides HPFS like FAT, EXT2, NTFS ...
  323.    VFAT date/time info and long filenames added in            ver 2.56
  324.    FAT32 functionality added/fixed in                         ver 2.65
  325.    NTFS  functionality expanded in version                    ver 2.80
  326.    JFS   bootsector and superblock recognition/display in     ver 3.39
  327.  
  328.  
  329.  Generic edit and write capability,
  330.  
  331.    This will allow recovery operations without using other (third-party)
  332.    utilities. The user interface needs to support screen-editing for this.
  333.  
  334.    Note: Basic edit and write capability added in version 2.50
  335.          Additional position/data dialog added in version 4.17
  336.  
  337.  Recovery for a 'quick format' on HPFS (unformat)
  338.  
  339.  LINUX version, port being investigated, low priority.
  340.  
  341.  Some FORMAT capabilities, creating FAT or HPFS partitions, this will allow
  342.  better unattended, batch-like installation procedures from DOS diskettes.
  343.  
  344.  More complete Logical Volume Manager support (LVM) and support for the
  345.  Journaled File System (JFS) for OS/2 Warpserver for e-business (Aurora)
  346.  and the IBM convenience-pack or eComStation client OS/2 version
  347.  - Much (display) LVM support added in the 3.35 to 3.39 versions
  348.  - Additional LVMSET commands added in version 4.15 to change LVM values
  349.  - Transparent support for multiple partition LVM volumes is planned.
  350.  
  351.  Multiple UNDO and REDO, and only write to the disks at quiting the program.
  352.  
  353.  
  354. O N L I N E   H E L P:
  355. ======================
  356.  
  357. As a command-line program, DFSee has limited online help, usefull
  358. to check the syntax and parameters. The following is available:
  359.  
  360. 'help'  command  : This will display a short introduction and a few
  361.                    important selection commands.
  362.  
  363. '??'    command  : List all generic commands, available in every mode
  364.  
  365. '?'     command  : List all commands specific to the current mode
  366.  
  367. '???'   command  : List sector-types recognized in the current mode
  368.  
  369.  <F2>   key      : List introduction and generic commands (help + ?)
  370.  
  371.  <F1>   key      : Popup window with some help about the userinterface
  372.  
  373. DFSxxx  -?       : List available switches for the DFSee executable
  374.                    from the operating-system commandline.
  375.                    The switches set some preferences and options like
  376.                    windowing, using a logfile and batch-mode.
  377.                    (.EXE can be DFSOS2.EXE, DFSDOS.EXE or DFSWIN.EXE)
  378.  
  379.  
  380. Most commands that require parameters will also display a short usage
  381. and help when called without any parameters, or sometimes when called
  382. with the parameter '-?'
  383.  
  384. Finally, whenever a (confirmation) dialogwindow is presented to ask a
  385. question or get other input, you can use the <F1> functionkey to get
  386. additional help on that specific dialog or question.
  387.  
  388.  ----------------------------[ www.dfsee.com ]-------------------------------
  389.  
  390.