file_flash.h

Go to the documentation of this file.

#ifndef NEXUS_FILE_FLASH_H
#define NEXUS_FILE_FLASH_H
#include "nexus/components/storage.h"
#ifdef __cplusplus
extern "C" {
#endif
/* Native POSIX flash model, not a hardware driver. Exclusive file ownership,
 * exact persistent geometry, 1->0 programming and caller-controlled failures.
 * fail_after counts programmed/erased bytes and sync attempts, including bytes
 * whose value remains unchanged. Negative disables it.
 * A zero budget simulates a powered-off device until explicitly cleared. */
typedef struct {
    int fd;
    nx_storage_port_t port;
    int64_t fail_after;
    uint64_t mutation_events;
} nx_file_flash_t;

nx_storage_status_t nx_file_flash_open(nx_file_flash_t* flash, const char* path,
                                       size_t size, size_t erase_size,
                                       size_t program_size);
void nx_file_flash_close(nx_file_flash_t* flash);
void nx_file_flash_fail_after(nx_file_flash_t* flash, int64_t events);
#ifdef __cplusplus
}
#endif
#endif