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 <libplatform/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,
                                bool (*cancel)(void *), void *data);
 
// ============================================================================
// 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);

int platform_dup(int fd);

int platform_fileno(FILE *stream);

asciichat_error_t platform_dup2(int source_fd, int target_fd);

typedef struct {
  char path[PLATFORM_MAX_PATH_LENGTH];
  uintptr_t symbolizer_address;
  bool relative_address;
} platform_binary_match_t;

int get_binary_file_address_offsets(const void *addr, platform_binary_match_t *matches, int max_matches);
 
#ifdef __cplusplus
}
#endif