filesystem.h

Go to the documentation of this file.

#pragma once
 
#include <libplatform/filesystem.h>
 
#if 0

 
#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;

typedef struct {
  char *path;
  int mode;
} platform_directory_candidate_t;
 
typedef struct {
  platform_directory_candidate_t *candidates;
  size_t count;
} platform_directory_list_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);

asciichat_error_t platform_get_data_dir_candidates(const char *install_prefix, platform_directory_list_t *list_out);

void platform_directory_list_destroy(platform_directory_list_t *list);
 
// ============================================================================
// 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

#endif