Files
ballistic/include/bal_errors.h
T
2026-06-17 01:47:03 -04:00

73 lines
1.8 KiB
C

/** @file bal_errors.h
*
* @brief Defines Ballistic error types.
*/
#ifndef BAL_ERRORS_H
#define BAL_ERRORS_H
#include "bal_attributes.h"
#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */
typedef enum
{
// General Errors.
BAL_SUCCESS = 0,
BAL_ERROR_INVALID_ARGUMENT = -1,
BAL_ERROR_ALLOCATION_FAILED = -2,
// Memory and Translation Errors
BAL_ERROR_MEMORY_ALIGNMENT = -50,
BAL_ERROR_MEMORY_FAULT = -51,
/// Engine and Execution Errors
BAL_ERROR_ENGINE_ALREADY_RUNNING = -100,
/// Guest code tried to execute an unaligned instruction.
BAL_ERROR_PC_ALIGNMENT = -101,
/// Ballistic tried to access memory it was not allowed to access.
BAL_ERROR_UNKNOWN_INSTRUCTION = -102,
// Thread Errors
/// Error when creating a thread.
BAL_ERROR_THREAD_CREATION = -150,
/// Error on thread clean up. The user will need to manually clean up the thread's
/// resources.
BAL_ERROR_THREAD_CLEANUP = -151,
// IR / Assembler Errors.
BAL_ERROR_INSTRUCTION_OVERFLOW = -200,
/// The decoded register type does not match the expected type.
BAL_ERROR_INCORRECT_REGISTER_TYPE = -201,
/// The relative jump or branch offset exceeded the capacity of the target displacement
/// field.
BAL_ERROR_BRANCH_OFFSET_OVERFLOW = -202,
/// The provided buffer capacity is too large and would cause an integer overflow.
BAL_ERROR_INVALID_CAPACITY = -203,
} bal_error_t;
/// Converts the enum into a readable string for error handling.
BAL_COLD const char *bal_error_to_string(bal_error_t error);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* BAL_ERRORS_H */
/*** end of file ***/