#ifndef __DISKREADDRIVER_H__ #define __DISKREADDRIVER_H__ #ifdef __cplusplus #include "icsneo/communication/communication.h" #include "icsneo/api/eventmanager.h" #include "icsneo/disk/diskdriver.h" #include #include #include namespace icsneo { namespace Disk { /** * Interface for drivers which read block data from devices */ class ReadDriver : public virtual Driver { public: virtual std::optional readLogicalDisk(Communication& com, device_eventhandler_t report, uint64_t pos, uint8_t* into, uint64_t amount, std::chrono::milliseconds timeout = DefaultTimeout); void invalidateCache(uint64_t pos = 0, uint64_t amount = std::numeric_limits::max() /* large value, but avoid overflow */); protected: /** * Perform a read which the driver can do in one shot. * * The `pos` requested must be sector-aligned, and the `amount` must be * within the block size bounds provided by the driver. */ virtual std::optional readLogicalDiskAligned(Communication& com, device_eventhandler_t report, uint64_t pos, uint8_t* into, uint64_t amount, std::chrono::milliseconds timeout) = 0; private: std::vector cache; uint64_t cachePos = 0; std::chrono::time_point cachedAt; static constexpr const std::chrono::milliseconds CacheTime = std::chrono::milliseconds(1000); std::optional readFromCache(uint64_t pos, uint8_t* into, uint64_t amount, std::chrono::milliseconds staleAfter = CacheTime); }; } // namespace Disk } // namespace icsneo #endif // __cplusplus #endif // __DISKREADDRIVER_H__