hfs_recovery.hpp

Go to the documentation of this file.

// hfs_recovery.hpp -- HFS+ / HFSX read-only recovery.
//
// Public interface, mirroring XfsRecovery / Ext4Recovery / NtfsRecovery
// shape. Implementation status (this build, session 1 of N):
//
//   * Volume header parse (HFS+ + HFSX)        : DONE
//   * B-tree node descriptor + header rec      : DONE
//   * Unicode UTF-16BE -> UTF-8 + partial NFC  : DONE
//   * Catalog B-tree walk                       : NOT YET (session 2)
//   * File extent reading + export              : NOT YET (session 3)
//   * Extents Overflow file (>8 extents)        : NOT YET (session 4)
//   * decmpfs decompression / hardlinks         : NOT YET (session 5+)
//
// In this session, recover() opens the volume, validates its header,
// emits diagnostic logs (variant, geometry, special files, journal
// state, key-compare type), and then returns false with a clear
// "session 1 of N" message.
 
#pragma once
 
#include "disk_reader.hpp"
#include "models.hpp"
#include "filesystem_recovery.hpp"
 
#include <string>
#include <vector>
 
class HfsRecovery {
public:
    explicit HfsRecovery(DiskReader& reader);
 
    // Same shape as the other filesystem recovery classes.
    bool recover(uint64_t volume_offset,
                 const std::string& output_dir,
                 std::vector<RecoveredFileRecord>& recovered,
                 std::vector<std::string>& logs,
                 std::string& error);
 
private:
    DiskReader& reader_;
};