system.h

Go to the documentation of this file.

#pragma once
 
#include <stdio.h>
#include <stddef.h>
#include <time.h>
#include "../common.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef void (*signal_handler_t)(int);
 
// ============================================================================
// System Functions
// ============================================================================
 
asciichat_error_t platform_init(void);
 
void platform_cleanup(void);
 
void platform_sleep_ms(unsigned int ms);
 
uint64_t platform_get_monotonic_time_us(void);
 
#ifdef _WIN32
// usleep macro - only define if not already declared (GCC's unistd.h declares it as a function)
// On Windows with GCC/Clang, usleep may be available via unistd.h, so we check for that
// If it's not available, we provide our macro wrapper
#ifndef _WIN32_USLEEP_AVAILABLE
// Check if usleep is declared (GCC's unistd.h provides it)
#if defined(__GNUC__) && !defined(__clang__)
// INFO: GCC on Windows: unistd.h declares usleep, so don't redefine it
// Code should use usleep() directly or platform_sleep_usec() directly
#else
// MSVC/Clang on Windows: Define usleep macro to use platform_sleep_usec
#define usleep(usec) platform_sleep_usec(usec)
#endif
#endif
#endif
 
asciichat_error_t platform_localtime(const time_t *timer, struct tm *result);
 
asciichat_error_t platform_gtime(const time_t *timer, struct tm *result);
 
int platform_get_pid(void);
 
const char *platform_get_username(void);
 
signal_handler_t platform_signal(int sig, signal_handler_t handler);
 
typedef enum {
  CONSOLE_CTRL_C = 0,     
  CONSOLE_CTRL_BREAK = 1, 
  CONSOLE_CLOSE = 2,      
  CONSOLE_LOGOFF = 3,     
  CONSOLE_SHUTDOWN = 4    
} console_ctrl_event_t;
 
typedef bool (*console_ctrl_handler_t)(console_ctrl_event_t event);
 
bool platform_set_console_ctrl_handler(console_ctrl_handler_t handler);
 
const char *platform_getenv(const char *name);
 
int platform_setenv(const char *name, const char *value);
 
int platform_isatty(int fd);
 
const char *platform_ttyname(int fd);
 
int platform_fsync(int fd);
 
int platform_backtrace(void **buffer, int size);
 
char **platform_backtrace_symbols(void *const *buffer, int size);
 
void platform_backtrace_symbols_free(char **strings);
 
void platform_install_crash_handler(void);
 
typedef bool (*backtrace_frame_filter_t)(const char *frame);
 
void platform_print_backtrace_symbols(const char *label, char **symbols, int count, int skip_frames, int max_frames,
                                      backtrace_frame_filter_t filter);
 
int platform_format_backtrace_symbols(char *buffer, size_t buffer_size, const char *label, char **symbols, int count,
                                      int skip_frames, int max_frames, backtrace_frame_filter_t filter);
 
void platform_print_backtrace(int skip_frames);
 
// ============================================================================
// Safe String Functions
// ============================================================================
 
int safe_snprintf(char *buffer, size_t buffer_size, const char *format, ...);
 
int safe_fprintf(FILE *stream, const char *format, ...);
 
#define SAFE_IGNORE_PRINTF_RESULT(expr) ((void)(expr))
 
// ============================================================================
// Safe Memory Functions
// ============================================================================
 
asciichat_error_t platform_memcpy(void *dest, size_t dest_size, const void *src, size_t count);
 
asciichat_error_t platform_memset(void *dest, size_t dest_size, int ch, size_t count);
 
asciichat_error_t platform_memmove(void *dest, size_t dest_size, const void *src, size_t count);
 
asciichat_error_t platform_strcpy(char *dest, size_t dest_size, const char *src);
 
asciichat_error_t platform_resolve_hostname_to_ipv4(const char *hostname, char *ipv4_out, size_t ipv4_out_size);
 
asciichat_error_t platform_load_system_ca_certs(char **pem_data_out, size_t *pem_size_out);
 
bool platform_is_binary_in_path(const char *bin_name);
 
void platform_cleanup_binary_path_cache(void);
 
// ============================================================================
// Path Separator 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
 
// ============================================================================
// File Permission Constants
// ============================================================================
 
#define FILE_PERM_PRIVATE 0600
 
#define DIR_PERM_PRIVATE 0700
 
#define FILE_PERM_PUBLIC_READ 0644
 
#define FILE_PERM_MASK 0777
 
// ============================================================================
// Maximum Path Length
// ============================================================================
 
#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
 
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);
 
#ifdef __cplusplus
}
#endif