      DFSee version 17.0 2022-10-22  (c) 1994-2022: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

C O N T E N T S:
_______________________________________________________________________________

   Command reference    = overview of EXT2/3/4 specific commands
   Detailed description = description for every command


  Note: All generic commands can be found in DFSCMDS.TXT, for example:

        ALLOC,  CHECK,  CLONE,  RESIZE,  RECOVER,  SAVETO,  SCAN,  WIPE

_______________________________________________________________________________

C O M M A N D   R E F E R E N C E:
_______________________________________________________________________________

EXT specific commands

Active filesystem : EXT, specific commands are:


 \path-spec       = find and show file/directory relative to root (FINDPATH)
 ABG              = Display filesystem ALLOC map, with one line per blockgroup
 BG group | *     = Display group info and block-bitmap for one or all groups
 BL               = Translate and display 'this' LSN as a block number
 BL block  [cmd]  = Translate specified block-number to LSN, display using 'cmd'
 BSL  [-f]        = Display Sparse-Super blockgroup# table, location of backup
 FILEFIND [name]  = Find normal files, with name-info matching (partial) name
 INO  [-v][ino#]  = Calculate sector+index for Inode, display contents [verbose]
 SUPER            = Display the filesystem SUPERBLOCK sector
 UUID [[-u:]uuid] = Display or set a UUID string, dialog if no id specified


 For an up-to-date list of commands, use the '?' command

 EXTn specific sector types  (see ??? command)

  's' = EXT superblock       'S' = EXT boot+superblk    'd' = Directory block
  'f' = File Inode           'D' = Directory Inode      'E' = Ext-Attrib block
  'B' = BACKUP Superblock    'K' = Group Descr-Table    'c' = BACKUP GD-Table
  'k' = GDT Reserved area    'M' = BlockAlloc Bitmap    'm' = InodeAlloc Bitmap
  'i' = Inode Table          '1' = BlockIndirectLvl1    '2' = BlockIndirectLvl2
  '3' = BlockIndirectLvl3    'A' = AllocExtent Index    'a' = AllocExtent Leaf
  'j' = Journaling File      'z' = ResizeInformation


             For an up-to-date list, use the '???" command
_______________________________________________________________________________

D E T A I L E D   D E S C R I P T I O N:
_______________________________________________________________________________

 \path-spec       = find and show file/directory relative to root (FINDPATH)

 Purpose:       Locate and display the Inode for a given file/dir full path

 Parameters:    none

 Output:        The chain of Inodes and DIR-blocks upto the found Inode,
                followed by the display of the Inode, or an error message
                when a path component was not found.

 Remarks:       Synonym for the FINDPATH generic command, where path-spec
                is a separate parameter to the command
_______________________________________________________________________________

ABG             = Display filesystem ALLOC map, with one line per blockgroup

 Purpose:       Show filesystem allocation, but organized to match the
                division into groups

 Parameters:    none

 Output:        Semi graphic display showing block usage per blockgroup


 Remarks:
_______________________________________________________________________________

BG group | *    = Display group info and block-bitmap for one or all groups

 Purpose:

 Parameters:    group     Group number to display info for, or '*' for ALL

 Options:       -v        Verbose, display a bitmap allocation graphic for group

 Output:        A single line per blockgroup, showing the number of blocks that
                are in-use as shown in the bitmap, and in the blockgroup table
                plus the value of the group flags.

                With '-v' there is some additional information about Inode usage
                and a pseudo graphic display of the block usage is shown

 Remarks:
_______________________________________________________________________________

 BL               = Translate and display 'this' LSN as a block nr

 Purpose:       Display block value for the CURRENT sector 'this'

 Parameters:    none

 Output:        cluster value

 Remarks:       EXTn specific, and alias for the generic 'CL' command
_______________________________________________________________________________

 BL   block [cmd] = Translate hex block number to hex LSN, display using cmd

 Purpose:       Display sector for specified block in default or cmd format

 Parameters:    block   mandatory  Block value 0 .. max-block

                cmd     optional   Command to use for displaying the sector

 Output:        display of the sector

 Remarks:       EXTn specific, and alias for the generic 'CL' command
_______________________________________________________________________________

BSL  [-f]       = Display Sparse-Super blockgroup# table, location of backup

 Purpose:       Show the blockgroups that have backup copies of the superblock
                and the blockgroup tables

 Options:       -f      Force display of ALL (known to DFSee) locations, even
                        when these are beyond the end of this filesystem

 Parameters:    none

 Output:        Group number and block+sector numbers for the backup locations


 Remarks:
_______________________________________________________________________________

 FILEFIND [name] = Find normal files, with name-info matching (partial) name

 Purpose:       Find non-deleted files, either all of them, or just the ones
                where available name-info contains the (partial) name given.
                The found files can be copied to another disk using the
                RECOVER or SAVEAS commands, just as with deleted files.

 Parameters:    name        optional   part of filename wanted, not a wildcard!
                                       (does NOT apply to the path component)

 Options:       -a        = search ANY files, deleted and normal  (with -d- only)
                -D        = search  directories  only, not files+directories
                -f        = search regular files only, not files+directories
                -c        = start from current sector, not start of volume
                -d        = search within  known INODE areas only (default)
                -d-       = search outside known INODE areas too   (SLOW!)
                -F:first  = start at given Inode nr, default = 4   (unless -d-)
                -v        = verbose search, list files while found (SLOW!)


 Output:        Find-result list (as "find -t:f") on screen and in memory

 Remarks:       All non-deleted files, or the ones where the fileinfo contains
                the given ASCII string, will be found and added to the list.

                The [name] selection aims at the FILENAME part only. To select
                on part of the full path for the file, use the wildcard select
                parameters on the DELSHOW and RECOVER commands afterwards.

                List can be manipulated as usual, best viewed with "delshow" or
                the equivalent "list -f"

                The 'name' parameter is useful only when name information is
                available with the INODE's. This is the case if a .LONGNAME EA
                (extended attribute) is present, if the sector lookup table
                (SLT) has been built, or if the name-info is explicitly added
                as DFSee-recovery info using the 'check -r -M' command or the
                corresponding menu: Mode=JFS -> Add/Update recovery filenames

                By default, only known INODES are searched, which is at least
                a hundred times faster as searching the whole filesystem.

                Note: SLT will be built automatically when not present yet.
_______________________________________________________________________________

INO  [-v][ino#] = Calculate sector+index for Inode, display contents [verbose]

 Purpose:       Display the contents of the EXT superblock

 Parameters:    ino#        mandatory  Inode number to display info for

 Output:        Calculated sectornumber + index in that sector for the Inode
                and a formatted display of the Inode contents, including the
                allocated blocks for the file or directory

 Remarks:
_______________________________________________________________________________

SUPER           = Display the filesystem SUPERBLOCK sector

 Purpose:       Display the contents of the EXT superblock

 Parameters:    none

 Output:        Formatted display of almost all the superblock fields


 Remarks:
_______________________________________________________________________________

 UUID [UUID] | [-u:UUID]  = Display/set UUID, dialog if no id specified

 Purpose:       Display or edit the value of the filesystem UUID (unique ID)

 Parameters:    UUID     string value, 5 groups separated by hyphens, no brackets

 Options:       -u:UUID  36 character UUID value: 12345678-abcd-0123-4567-0123456789ab


 Output:        Display of the UUID value as a string

 Remarks:       When no parameter or -u option UUID value is specified, a UUID dialog
                is presented with a separate edit field for each of the 5 components
                of the UUID value, showing the current value.

_______________________________________________________________________________

