device_health_probe.hpp

Go to the documentation of this file.

#pragma once
 
#include <cstdint>
#include <functional>
#include <string>
#include <vector>
 
enum class DeviceHealthState {
    Healthy,
    ReadableWithErrors,
    PartiallyReadable,
    EnumeratedButUnstable,
    NotReadable
};
 
struct DeviceProbeSample {
    uint64_t offset {0};
    size_t size {0};
    bool success {false};
    bool timeout {false};
    std::string error;
    uint64_t latency_ms {0};
};
 
struct DeviceHealthReport {
    std::string device_path;
    uint64_t total_size {0};
    uint32_t logical_sector_size {512};
    bool open_ok {false};
    bool read_lba0_ok {false};
    bool read_tail_ok {false};
    bool intermittent_failures {false};
    bool size_suspicious {false};
    bool unstable_latency {false};
    DeviceHealthState state {DeviceHealthState::NotReadable};
    std::vector<DeviceProbeSample> samples;
    std::string summary;
};
 
class DeviceHealthProbe {
public:
    using CancelCallback = std::function<bool()>;
 
    static DeviceHealthReport probe(
        const std::string& device_path,
        CancelCallback cancel_cb = {});
};