emu_host_io_internal.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <sys/types.h>
 
#include "ra8_attributes.h"

typedef enum : uint8_t {
  k_emu_io_ok = 0U,   
  k_emu_io_invalid,   
  k_emu_io_truncated, 
  k_emu_io_eof,       
  k_emu_io_error,     
} emu_io_status_t;

typedef struct {
  emu_io_status_t status;      
  size_t          transferred; 
  int             os_error;    
} emu_io_result_t;

typedef struct {
  ssize_t (*read_fn)(int fd, void* buf, size_t count);                    
  ssize_t (*write_fn)(int fd, const void* buf, size_t count);             
  ssize_t (*pread_fn)(int fd, void* buf, size_t count, off_t offset);     
  ssize_t (*pwrite_fn)(int fd, const void* buf, size_t count, off_t off); 
} emu_io_ops_t;

typedef struct {
  int     fd;   
  int64_t size; 
} emu_io_file_t;

typedef struct {
  int  fd;         
  char final[512]; 
  char temp[544];  
} emu_io_txn_t;

RA8_PRIV void priv_emu_io_configure(int out_fd, int err_fd, const emu_io_ops_t* ops);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_read_exact(int fd, void* buf, size_t count);
RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_write_exact(int fd, const void* buf, size_t count);
RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_pread_exact(int fd, void* buf, size_t count, off_t offset);
RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_pwrite_exact(int fd, const void* buf, size_t count, off_t offset);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_out_text(const char* text);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_err_text(const char* text);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_err_bytes(const void* bytes, size_t length);
[[gnu::format(printf, 1, 2)]] RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_outf(const char* format, ...);
[[gnu::format(printf, 1, 2)]] RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_errf(const char* format, ...);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_file_text(int fd, const char* text);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_file_char(int fd, char value);
[[gnu::format(printf, 2, 3)]] RA8_PRIV [[nodiscard]] emu_io_result_t
priv_emu_io_filef(int fd, const char* format, ...);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_open_read(const char* path, emu_io_file_t* file);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_close(emu_io_file_t* file);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_txn_begin(const char* path, emu_io_txn_t* txn);
RA8_PRIV [[nodiscard]] emu_io_result_t priv_emu_io_txn_commit(emu_io_txn_t* txn);
RA8_PRIV void priv_emu_io_txn_abort(emu_io_txn_t* txn);