koishi.h

Go to the documentation of this file.

 
#ifndef KOISHI_H
#define KOISHI_H
 
#if defined _WIN32 || defined __CYGWIN__
    #if defined BUILDING_KOISHI
        #define KOISHI_API __declspec(dllexport)
    #elif defined KOISHI_DLLIMPORT
        #define KOISHI_API __declspec(dllimport)
    #else
        #define KOISHI_API
    #endif
#else
    #if defined BUILDING_KOISHI && defined __GNUC__
        #define KOISHI_API __attribute__((visibility("default")))
    #else
        #define KOISHI_API
    #endif
#endif
 
#if defined __STDC_VERSION__ && __STDC_VERSION__ >= 201112L
    #define KOISHI_NORETURN _Noreturn
#elif defined __cplusplus && __cplusplus >= 201103L
    #define KOISHI_NORETURN [[noreturn]]
#elif defined __GNUC__ || defined __clang__
    #define KOISHI_NORETURN __attribute__((__noreturn__))
#else
    #define KOISHI_NORETURN
#endif
 
#if defined BUILDING_KOISHI
    #include <stddef.h>
 
    #if defined NDEBUG && (defined __GNUC__ || defined __clang__)
        #define KOISHI_UNREACHABLE __builtin_unreachable()
    #else
        #define KOISHI_UNREACHABLE do { assert(0 && "This code path should never be reached"); abort(); } while(0)
    #endif
 
    #ifndef __has_feature
        #define __has_feature(x) 0  /* compatibility with non-clang compilers */
    #endif
 
    #if defined(__SANITIZE_ADDRESS__) || __has_feature(address_sanitizer)
        #include <sanitizer/asan_interface.h>
        #define KOISHI_ASAN
    #endif
 
    #if defined(KOISHI_VALGRIND)
        #include <valgrind/valgrind.h>
        #define KOISHI_VALGRIND_STACK_ID(name) int name;
        #define KOISHI_VALGRIND_STACK_REGISTER(id, start, end) id = VALGRIND_STACK_REGISTER(start, end)
        #define KOISHI_VALGRIND_STACK_DEREGISTER(id) VALGRIND_STACK_DEREGISTER(id)
    #else
        #define KOISHI_VALGRIND_STACK_ID(name)
        #define KOISHI_VALGRIND_STACK_REGISTER(id, start, end)
        #define KOISHI_VALGRIND_STACK_DEREGISTER(id)
    #endif
 
    #ifndef offsetof
        #ifdef __GNUC__
            #define offsetof(type, field) __builtin_offsetof(type, field)
        #else
            #define offsetof(type, field) ((size_t)&(((type *)0)->field))
        #endif
    #endif
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stddef.h>
 
enum koishi_state {
    KOISHI_SUSPENDED,  
    KOISHI_RUNNING,    
    KOISHI_DEAD,       
    KOISHI_IDLE,       
};
 
#ifdef BUILDING_KOISHI
typedef struct koishi_coroutine koishi_coroutine_t;
struct koishi_coroutine_pub {
#else
typedef struct koishi_coroutine {
#endif
    void *_private[8];
#ifdef BUILDING_KOISHI
};
#else
} koishi_coroutine_t;
#endif
 
typedef void *(*koishi_entrypoint_t)(void *data);
 
KOISHI_API void koishi_init(koishi_coroutine_t *co, size_t min_stack_size, koishi_entrypoint_t entry_point);
 
KOISHI_API void koishi_recycle(koishi_coroutine_t *co, koishi_entrypoint_t entry_point);
 
KOISHI_API void koishi_deinit(koishi_coroutine_t *co);
 
KOISHI_API void *koishi_resume(koishi_coroutine_t *co, void *arg);
 
KOISHI_API void *koishi_yield(void *arg);
 
KOISHI_API KOISHI_NORETURN void koishi_die(void *arg);
 
KOISHI_API void koishi_kill(koishi_coroutine_t *co, void *arg);
 
KOISHI_API int koishi_state(koishi_coroutine_t *co);
 
KOISHI_API koishi_coroutine_t *koishi_active(void);
 
KOISHI_API void *koishi_get_stack(koishi_coroutine_t *co, size_t *stack_size);
 
KOISHI_API size_t koishi_util_page_size(void);
 
KOISHI_API size_t koishi_util_real_stack_size(size_t min_size);
 
#ifdef __cplusplus
}
#endif
 
#endif