system.h

Go to the documentation of this file.

#pragma once
 
#include <stdio.h>
#include <stddef.h>
#include <stdarg.h>
#include <time.h>
#ifdef _WIN32
#include <basetsd.h>
#ifndef _SSIZE_T_DEFINED
typedef SSIZE_T ssize_t;
#define _SSIZE_T_DEFINED
#endif
#endif
#include "../common.h"
#include "process.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef void (*signal_handler_t)(int);
 
void platform_install_crash_handler(void);
 
// ============================================================================
// System Functions
// ============================================================================
 
asciichat_error_t platform_init(void);
 
void platform_destroy(void);
 
void platform_force_exit(int exit_code);
 
void platform_sleep_ms(unsigned int ms);
 
uint64_t platform_get_monotonic_time_us(void);
 
asciichat_error_t platform_request_timer_precision(int precision);
 
asciichat_error_t platform_restore_timer_resolution(void);
 
asciichat_error_t platform_enable_keepawake(void);
 
void platform_disable_keepawake(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_us() directly
#else
// MSVC/Clang on Windows: Define usleep macro to use platform_sleep_us
#define usleep(usec) platform_sleep_us(usec)
#endif
// sleep() in seconds mapped to platform_sleep_us() in microseconds
#ifndef sleep
#define sleep(sec) platform_sleep_us((sec) * 1000000U)
#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);
 
const char *platform_get_username(void);
 
signal_handler_t platform_signal(int sig, signal_handler_t handler);
 
typedef struct {
  int sig;                  
  signal_handler_t handler; 
} platform_signal_handler_t;
 
asciichat_error_t platform_register_signal_handlers(const platform_signal_handler_t *handlers, int count);
 
const char *platform_getenv(const char *name);
 
int platform_setenv(const char *name, const char *value);
 
int platform_unsetenv(const char *name);
 
void platform_raise_fd_limit(unsigned int limit);
 
// ============================================================================
// Stream Redirection
// ============================================================================
 
typedef struct {
  int original_fd; 
  int devnull_fd;  
} platform_stderr_redirect_handle_t;
 
platform_stderr_redirect_handle_t platform_stderr_redirect_to_null(void);
 
void platform_stderr_restore(platform_stderr_redirect_handle_t handle);
 
platform_stderr_redirect_handle_t platform_stdout_stderr_redirect_to_null(void);
 
void platform_stdout_stderr_restore(platform_stderr_redirect_handle_t handle);
 
void platform_stdio_redirect_to_null_permanent(void);
 
void platform_install_crash_handler(void);
 
// ============================================================================
// Safe String Functions
// ============================================================================
 
int safe_snprintf(char *buffer, size_t buffer_size, const char *format, ...);
 
int safe_fprintf(FILE *stream, const char *format, ...);
 
int safe_vsnprintf(char *buffer, size_t buffer_size, const char *format, va_list ap);
 
#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);
 
int platform_get_last_error(void);
 
const char *platform_strerror(int errnum);
 
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);
 
// ============================================================================
// Subprocess Execution
// ============================================================================
 
int platform_execute_subprocess(const char *executable, const char **argv,
                                char *output_buffer, size_t output_size);
 
// ============================================================================
// I/O Functions
// ============================================================================
 
size_t platform_write_all(int fd, const void *buf, size_t count);
 
ssize_t platform_write(int fd, const void *buf, size_t count);
 
typedef struct {
  char path[PLATFORM_MAX_PATH_LENGTH];
  uintptr_t file_offset;
} platform_binary_match_t;
 
int get_binary_file_address_offsets(const void *addr, platform_binary_match_t *matches, int max_matches);
 
#ifdef __cplusplus
}
#endif