filesystem.h

Go to the documentation of this file.

#pragma once
 
#include <stddef.h>
#include <stdbool.h>
#include <sys/types.h>
#include "../asciichat_errno.h"
 
/* ============================================================================
 * Cross-platform I/O headers
 * ============================================================================
 * Consolidates file descriptor and I/O operations across platforms.
 */
#ifdef _WIN32
#include <io.h>    /* Windows I/O functions */
#include <fcntl.h> /* File control options */
#else
#include <unistd.h> /* POSIX standard I/O and file descriptor functions */
#include <fcntl.h>  /* POSIX file control options */
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
// ============================================================================
// File Mode Constants (for consistency with fcntl.h)
// ============================================================================
 
#ifdef _WIN32
#include <fcntl.h>
#define PLATFORM_O_RDONLY _O_RDONLY
#define PLATFORM_O_WRONLY _O_WRONLY
#define PLATFORM_O_RDWR _O_RDWR
#define PLATFORM_O_CREAT _O_CREAT
#define PLATFORM_O_EXCL _O_EXCL
#define PLATFORM_O_TRUNC _O_TRUNC
#define PLATFORM_O_APPEND _O_APPEND
#define PLATFORM_O_BINARY _O_BINARY
#else
#include <fcntl.h>
#define PLATFORM_O_RDONLY O_RDONLY
#define PLATFORM_O_WRONLY O_WRONLY
#define PLATFORM_O_RDWR O_RDWR
#define PLATFORM_O_CREAT O_CREAT
#define PLATFORM_O_EXCL O_EXCL
#define PLATFORM_O_TRUNC O_TRUNC
#define PLATFORM_O_APPEND O_APPEND
#define PLATFORM_O_BINARY 0 // Not needed on POSIX
#endif
 
// ============================================================================
// Path Separator and Length Constants
// ============================================================================
 
#ifdef _WIN32
#define PATH_DELIM '\\'
#define PATH_SEPARATOR_STR "\\"
#else
#define PATH_DELIM '/'
#define PATH_SEPARATOR_STR "/"
#endif
 
#ifdef _WIN32
#define PATH_ENV_SEPARATOR ";"
#else
#define PATH_ENV_SEPARATOR ":"
#endif
 
#ifdef _WIN32
#define PLATFORM_MAX_PATH_LENGTH 32767
#elif defined(__linux__)
#ifndef PATH_MAX
#define PLATFORM_MAX_PATH_LENGTH 4096
#else
#define PLATFORM_MAX_PATH_LENGTH PATH_MAX
#endif
#elif defined(__APPLE__)
#ifndef PATH_MAX
#define PLATFORM_MAX_PATH_LENGTH 1024
#else
#define PLATFORM_MAX_PATH_LENGTH PATH_MAX
#endif
#else
#define PLATFORM_MAX_PATH_LENGTH 4096
#endif
 
#define PLATFORM_MAX_ENV_VALUE_LENGTH 32768
 
// ============================================================================
// File Permission Constants
// ============================================================================
 
#define FILE_PERM_PRIVATE 0600
 
#define DIR_PERM_PRIVATE 0700
 
#define FILE_PERM_PUBLIC_READ 0644
 
#define FILE_PERM_MASK 0777
 
// ============================================================================
// File Statistics
// ============================================================================
 
typedef struct {
  size_t size;         
  int mode;            
  int is_regular_file; 
  int is_directory;    
  int is_symlink;      
} platform_stat_t;
 
asciichat_error_t platform_stat(const char *path, platform_stat_t *stat_out);
 
int platform_is_regular_file(const char *path);
 
int platform_is_directory(const char *path);
 
// ============================================================================
// Directory Management
// ============================================================================
 
asciichat_error_t platform_mkdir(const char *path, int mode);
 
asciichat_error_t platform_mkdir_recursive(const char *path, int mode);
 
asciichat_error_t platform_mkdtemp(char *path_out, size_t path_size, const char *prefix);
 
asciichat_error_t platform_rmdir_recursive(const char *path);
 
typedef struct {
  const char *name; 
  bool is_dir;      
} platform_dir_entry_t;
 
typedef bool (*platform_dir_foreach_cb)(const platform_dir_entry_t *entry, void *user_data);
 
asciichat_error_t platform_dir_foreach(const char *path, platform_dir_foreach_cb callback, void *user_data);
 
// ============================================================================
// Temporary Files
// ============================================================================
 
int platform_create_temp_file(char *path_out, size_t path_size, const char *prefix, int *fd);
 
int platform_delete_temp_file(const char *path);
 
asciichat_error_t platform_temp_file_open(const char *name, const char *path, int *fd_out);
 
// ============================================================================
// File Truncation
// ============================================================================
 
asciichat_error_t platform_truncate_file(const char *path, size_t size);
 
// ============================================================================
// Path Utilities
// ============================================================================
 
bool platform_path_is_absolute(const char *path);
 
char platform_path_get_separator(void);
 
asciichat_error_t platform_path_normalize(const char *input, char *output, size_t output_size);
 
// ============================================================================
// Key File Security
// ============================================================================
 
asciichat_error_t platform_validate_key_file_permissions(const char *key_path);
 
// ============================================================================
// Config File Search
// ============================================================================
 
typedef struct {
  char *path;            
  uint8_t priority;      
  bool exists;           
  bool is_system_config; 
} config_file_result_t;
 
typedef struct {
  config_file_result_t *files; 
  size_t count;                
  size_t capacity;             
} config_file_list_t;
 
asciichat_error_t platform_find_config_file(const char *filename, config_file_list_t *list_out);
 
void config_file_list_destroy(config_file_list_t *list);
 
// ============================================================================
// Home and Config Directory Discovery
// ============================================================================
 
const char *platform_get_home_dir(void);
 
char *platform_get_config_dir(void);
 
char *platform_get_data_dir(void);
 
// ============================================================================
// File I/O Operations
// ============================================================================
 
int platform_open(const char *name, const char *pathname, int flags, ...);
 
FILE *platform_fopen(const char *name, const char *filename, const char *mode);
 
FILE *platform_tmpfile(void);
 
FILE *platform_fdopen(const char *name, int fd, const char *mode);
 
ssize_t platform_read(int fd, void *buf, size_t count);
 
ssize_t platform_write(int fd, const void *buf, size_t count);
 
int platform_close(int fd);
 
int platform_unlink(const char *pathname);
 
int platform_chmod(const char *pathname, int mode);
 
// ============================================================================
// Platform Path Utilities
// ============================================================================
 
const char *platform_path_skip_absolute_prefix(const char *path);
 
void platform_normalize_path_separators(char *path);
 
int platform_path_strcasecmp(const char *a, const char *b, size_t n);
 
const char *file_read_error_message(const char *path);
 
const char *file_write_error_message(const char *path);
 
bool file_is_readable(const char *path);
 
bool file_is_writable(const char *path);
 
/* ============================================================================
 * Path Utilities
 * ============================================================================ */
 
bool platform_get_executable_path(char *exe_path, size_t path_size);
 
bool platform_get_temp_dir(char *temp_dir, size_t path_size);
 
bool platform_get_cwd(char *cwd, size_t path_size);
 
#define PLATFORM_ACCESS_EXISTS 0 
#define PLATFORM_ACCESS_WRITE 2  
#define PLATFORM_ACCESS_READ 4   
 
int platform_access(const char *path, int mode);
 
bool platform_is_binary_in_path(const char *bin_name);
 
void platform_cleanup_binary_path_cache(void);
 
int platform_fsync(int fd);
 
/* ============================================================================
 * Platform-Specific Internal Functions (not part of public API)
 * ============================================================================ */
 
bool check_binary_in_path_uncached(const char *bin_name);
 
#ifdef __cplusplus
}
#endif