ra8_fs_meta.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_fs.h"
 
/* =============================================================================
 * Free space (statvfs)
 * =============================================================================
 */

typedef enum : uint8_t {
  k_ra8_fs_label_cap = 12, 
} ra8_fs_label_limit_t;

typedef struct {
  uint64_t total_bytes;       
  uint64_t free_bytes;        
  uint64_t used_bytes;        
  uint32_t bytes_per_cluster; 
  uint32_t total_clusters;    
  uint32_t free_clusters;     
  uint32_t used_clusters;     
} ra8_fs_space_t;

[[nodiscard]] ra8_err_t ra8_fs_free_space(const ra8_fs_mount_t* handle, ra8_fs_space_t* out);
 
/* =============================================================================
 * Volume label
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_fs_get_label(const ra8_fs_mount_t* handle, char* out, uint32_t out_len);

[[nodiscard]] ra8_err_t ra8_fs_set_label(const ra8_fs_mount_t* handle, const char* label);
 
/* =============================================================================
 * Per-entry timestamps (utime)
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_fs_utime(const ra8_fs_mount_t*    handle,
                                     const char*              path,
                                     const ra8_fs_datetime_t* create,
                                     const ra8_fs_datetime_t* modify,
                                     const ra8_fs_datetime_t* access);

[[nodiscard]] ra8_err_t ra8_fs_truncate(ra8_fs_file_t* file, uint64_t new_size);
 
/* =============================================================================
 * Per-entry attributes (chmod-style)
 * =============================================================================
 */

typedef enum : uint8_t {
  k_ra8_fs_attr_settable =
    (uint8_t)((uint8_t)k_ra8_fs_attr_read_only | (uint8_t)k_ra8_fs_attr_hidden |
              (uint8_t)k_ra8_fs_attr_system | (uint8_t)k_ra8_fs_attr_archive),
} ra8_fs_attr_settable_t;

[[nodiscard]] ra8_err_t ra8_fs_set_attr(const ra8_fs_mount_t* handle,
                                        const char*           path,
                                        uint8_t               set_mask,
                                        uint8_t               clear_mask);
 
#ifdef __cplusplus
}
#endif