anth64
1e97b69fcd
Add strict error handling for stk initialization and platform operations. stk_init() now fails fast on critical errors and returns typed error codes that users can handle programmatically. Changes: - Add STK_INIT_* error codes for init failures (memory, tmpdir, watch) - Add STK_PLATFORM_* error codes for platform operation results - Check platform_mkdir() and fail if temp directory cannot be created - Check platform_directory_watch_start() and fail if watch cannot initialize - Add error_cleanup path in platform_directory_watch_start() to properly free resources on critical Windows failures. - Replace all platform error checks with STK_PLATFORM_OPERATION_SUCCESS - Log FATAL errors with when critical operations fail - Add warning logs for non-critical failures Critical failures now return specific error codes: - STK_INIT_MEMORY_ERROR: Module memory allocation failed - STK_INIT_TMPDIR_ERROR: Cannot create temp directory - STK_INIT_WATCH_ERROR: Cannot start directory watching Individual module load failures remain non-fatal and are handled logged.
70 lines
1.5 KiB
C
70 lines
1.5 KiB
C
#ifndef STK_H
|
|
#define STK_H
|
|
|
|
#include "stk_version.h"
|
|
#include <stdlib.h>
|
|
|
|
/* Buffers */
|
|
#define STK_MOD_DIR_BUFFER 256
|
|
#define STK_MOD_ID_BUFFER 64
|
|
#define STK_PATH_MAX 256
|
|
#define STK_PATH_MAX_OS 4096
|
|
|
|
/* Initialization return codes */
|
|
#define STK_INIT_SUCCESS 0
|
|
#define STK_INIT_MEMORY_ERROR 1
|
|
#define STK_INIT_TMPDIR_ERROR 2
|
|
#define STK_INIT_WATCH_ERROR 3
|
|
|
|
/* Module loading return codes */
|
|
#define STK_MOD_INIT_SUCCESS 0
|
|
#define STK_MOD_INIT_FAILURE 1
|
|
#define STK_MOD_LIBRARY_LOAD_ERROR 2
|
|
#define STK_MOD_SYMBOL_NOT_FOUND_ERROR 3
|
|
|
|
/* Platform return codes */
|
|
#define STK_PLATFORM_OPERATION_SUCCESS 0
|
|
#define STK_PLATFORM_FILE_COPY_ERROR 1
|
|
#define STK_PLATFORM_MKDIR_ERROR 2
|
|
#define STK_PLATFORM_REMOVE_DIR_ERROR 3
|
|
#define STK_PLATFORM_REMOVE_FILE_ERROR 4
|
|
|
|
#if defined(__linux__) || defined(_WIN32)
|
|
#define STK_EVENT_BUFFER 4096
|
|
#endif
|
|
|
|
#if defined(_WIN32)
|
|
#define STK_MODULE_EXT ".dll"
|
|
#elif defined(__APPLE__)
|
|
#define STK_MODULE_EXT ".dylib"
|
|
#else
|
|
#define STK_MODULE_EXT ".so"
|
|
#endif
|
|
|
|
#define STK_MODULE_EXT_LEN (sizeof(STK_MODULE_EXT) - 1)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
STK_MOD_LOAD,
|
|
STK_MOD_UNLOAD,
|
|
STK_MOD_RELOAD
|
|
} stk_module_event_t;
|
|
|
|
int stk_init(void);
|
|
void stk_shutdown(void);
|
|
size_t stk_module_count(void);
|
|
size_t stk_poll(void);
|
|
void stk_set_mod_dir(const char *path);
|
|
void stk_set_tmp_dir_name(const char *name);
|
|
void stk_set_module_init_fn(const char *name);
|
|
void stk_set_module_shutdown_fn(const char *name);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* STK_H */
|