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