      DFSee version 16.2 2019-07-25  (c) 1994-2019: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

C O N T E N T S:
_______________________________________________________________________________

   Command reference    = overview of HFS 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

        However, most of these command will not be functional for HFS
        filesystems due to currently lacking FS-specific functions.

_______________________________________________________________________________

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

HFS specific commands

Active filesystem : HFS, specific commands are:

 BL              = Translate and display 'this' LSN as a block number
 BL block  [cmd] = Translate specified block-number to LSN, display using 'cmd'
 CATS Fid [name] = Catalog search for folder-CnID, [containing filename]",
 FOLDER    [Fid] = Display Catalog directory data for specified folder CnID
 LABEL   [label] = Display/edit 255-char volume label in the Catalog file
 NODE            = Translate and display 'this' LSN as a Catalog-node number
 NODE cat-nodenr = Calculate LSN for a Catalog-node number, default display
 SUPER           = Display the filesystem SUPERBLOCK sector


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

 HFS specific sector types  (see ??? command)

   's' = HFS+ superblock      'B' = Boot(loader) file    'M' = Allocation Bitmap
   'E' = Extents    B-tree    'A' = Attributes B-tree    'c' = Catalog  (unused)
   'i' = Catalog IndexNode    'f' = Catalog  LeafNode    'm' = Catalog   MapNode
   'F' = Catalog    Header


             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:
_______________________________________________________________________________

 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:       HFS 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:       HFS specific, and alias for the generic 'CL' command
_______________________________________________________________________________

 FOLDER   [CnID] = Display Catalog directory data for specified folder CnID

 Purpose:       Display FOLDER (directory) contents for specified catalog-ID

 Parameters:    CnID    mandatory  CnID value 0 .. max-CnID (not contigious!)

 Output:        display of the folder contents, when CnID is valid for a folder

                Contents is in the DFSee standard directory like format, with
                date and time information, size, and the filename. Each entry
                shown is added to the DFSee Sectorlist, so it can be examined
                in more detail by selecting it using an .NNN command.

                Example output, trimmed to fit (more info is actually displayed)
                From the list below, you could display 'folder 550' or 'folder 401237'

 Nr    Folder/File ID Creation/LastAccess Attr Modified / Filename             Filesizee
 ==================== =================== ==== =================== =====================
.0000000          547 2017-10-03 00:29:33      2018-03-20 13:21:09                8.196
         File -----^  2018-03-20 13:20:56  664 .DS_Store

 ...

.0000010          550 2017-12-01 19:37:03
         Folder ---^  2018-03-16 21:46:05  775 Applications
.0000011       401237 2017-12-01 19:39:20
         Folder ---^  2018-01-22 12:19:32  755 bin

 ...

.0000015       424581 2018-01-22 12:26:37
         Folder ---^                       555 home
.0000016       401277 2017-10-05 22:42:40                                           313
         File -----^  2018-01-22 12:28:57  644 installer.failurerequests


 Remarks:       HFS specific

                'folder 2' will display the ROOT directory, and you can select
                other directories from that using the .NNN command using the
                number shown at the start of the line, for 'Folder' entries.

                'folder 1' is special, and will show the Volume name, which is
                the keyname for the entire Catalog-file (also called label)

                'folder 0' is special, in that it will list the directory info
                for ALL files and folders in the filesystem, sorted by CnID and
                the file/folder names. Warning: This could be millions of lines!

                The FOLDER command uses the NODE command to do the actual display
                specifying the proper arguments. For each node

                Selection of one of the lines using the .NNN command will show for:

                - a folder, the contents of that folder, using a 'folder' command

                - a file, summary info on the file, including data allocation

_______________________________________________________________________________

 LABEL    [label] = Display/edit the volume label in the Catalog file

 Purpose:       Set a volume label in the Catalog special file

 Parameters:    label   optional   New volume label, maximum length 255
                                   Default value is the current volume label

 Options        -!-                Skip input dialog for a new value

 Output:        Progress information

 Remarks:       On HFS there is NO label in the bootsector, but it resides
                in several Index or Leaf NODES in the Catalog B-tree
                which is updated by DFSee when changing the label value.

                The HFS label in the Catalog file is 255 characters maximum,
                but updating with DFSee MAY be limited by the available space
                in any of the nodes to be updated. You will get an error message
                when the new, longer, label does not fit.
                (DFSee does NOT split/rebalance the Btree)
_______________________________________________________________________________

 NODE            = Translate and display 'this' LSN as a Catalog-node number

 Purpose:       Display Catalog-node number for the CURRENT sector 'this'

 Parameters:    none

 Output:        node-number, when current sector is part of the Catalog file

 Remarks:       HFS specific
_______________________________________________________________________________

 NODE cat-nodenr = Calculate LSN for a Catalog-node number, default display

 Purpose:       Display contents for specified node-number in default format

 Parameters:    nodenr  mandatory  Node-number value 0 .. max-node-number

 Output:        display of the node, when in use, in formatted for each type:

                Header Node     Node-number 0, with info on the Catalog Btree
                                including first-leaf and last-leaf node number

                Map Node        Additional node-usage-mapping on large volumes

                Index Node      Internal node with named split-points pointing
                                to other index or Leaf-nodes

                Leaf Node       The lowest level, and the only level containing
                                actual contents in the form of directory/file
                                info (like INODEs, Fnodes, MFT on other FS)

                                They also hold the directory/folder tree
                                relationships in specific 'thread' records

 Remarks:       HFS specific

                To display directory information, you may want to use the FOLDER
                command instead, that will take a folder Catalog-ID (CnID) and
                issue a properly formatted 'node' command to display that
                in the DFSee standard directory like format

                'folder 2' will display the ROOT directory
_______________________________________________________________________________

SUPER           = Display the filesystem SUPERBLOCK sector

 Purpose:       Display the contents of the HFS superblock

 Parameters:    none

 Output:        Dirty status


 Remarks:       To be enhanced
_______________________________________________________________________________

