lifecycle.h

Go to the documentation of this file.

#pragma once
 
#include <ascii-chat/atomic.h>
#include <stdbool.h>
#include <ascii-chat/platform/mutex.h>
#include <ascii-chat/platform/rwlock.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
  LIFECYCLE_UNINITIALIZED = 0, 
  LIFECYCLE_INITIALIZING = 1,  
  LIFECYCLE_INITIALIZED = 2,   
  LIFECYCLE_DEAD = 3,          
  LIFECYCLE_DESTROYING = 4,    
} lifecycle_state_t;
 
typedef enum {
  LIFECYCLE_SYNC_NONE = 0,   
  LIFECYCLE_SYNC_MUTEX = 1,  
  LIFECYCLE_SYNC_RWLOCK = 2, 
} lifecycle_sync_type_t;
 
typedef struct {
  atomic_t state;               
  lifecycle_sync_type_t sync_type; 
  union {
    mutex_t *mutex;   
    rwlock_t *rwlock; 
  } sync;
} lifecycle_t;
 
#define LIFECYCLE_INIT                                                                                                 \
  {                                                                                                                    \
    .state = {.impl = LIFECYCLE_UNINITIALIZED}, .sync_type = LIFECYCLE_SYNC_NONE, .sync = {0}                          \
  }
 
#define LIFECYCLE_INIT_MUTEX(m)                                                                                        \
  {                                                                                                                    \
    .state = {.impl = LIFECYCLE_UNINITIALIZED}, .sync_type = LIFECYCLE_SYNC_MUTEX, .sync = {.mutex = (m) }             \
  }
 
#define LIFECYCLE_INIT_RWLOCK(r)                                                                                       \
  {                                                                                                                    \
    .state = {.impl = LIFECYCLE_UNINITIALIZED}, .sync_type = LIFECYCLE_SYNC_RWLOCK, .sync = {.rwlock = (r) }           \
  }
 
bool lifecycle_init(lifecycle_t *lc, const char *name);
 
bool lifecycle_init_once(lifecycle_t *lc);
 
void lifecycle_init_commit(lifecycle_t *lc);
 
void lifecycle_init_abort(lifecycle_t *lc);
 
bool lifecycle_shutdown(lifecycle_t *lc);
 
bool lifecycle_shutdown_forever(lifecycle_t *lc);
 
bool lifecycle_is_initialized(const lifecycle_t *lc);
 
bool lifecycle_is_dead(const lifecycle_t *lc);
 
bool lifecycle_reset(lifecycle_t *lc);
 
bool lifecycle_destroy_once(lifecycle_t *lc);
 
void lifecycle_destroy_commit(lifecycle_t *lc);
 
#ifdef __cplusplus
}
#endif