xf_init_registry.h

浏览该文件的文档.

 
#ifndef __XF_INIT_REGISTRY_H__
#define __XF_INIT_REGISTRY_H__
 
/* ==================== [Includes] ========================================== */
 
#include "../xf_init_config_internal.h"
#include "xf_utils.h"
 
#if (XF_INIT_IMPL_METHOD == XF_INIT_IMPL_BY_REGISTRY) \
    || (XF_INIT_IMPL_METHOD == XF_INIT_IMPL_BY_CONSTRUCTOR) \
    || defined(__DOXYGEN__)
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ==================== [Defines] =========================================== */
 
#if defined(__GNUC__) && !defined(__constructor) && XF_INIT_IMPL_METHOD == XF_INIT_IMPL_BY_CONSTRUCTOR
#   define __constructor               __attribute__((constructor))
#else
#   define __constructor
#endif
 
/* ==================== [Typedefs] ========================================== */
 
typedef enum _xf_init_registry_type_t {
    XF_INIT_REGISTRY_TYPE_SETUP = 0x00,     
    XF_INIT_REGISTRY_TYPE_BOARD,            
    XF_INIT_REGISTRY_TYPE_PREV,             
    XF_INIT_REGISTRY_TYPE_CLEANUP,          
    XF_INIT_REGISTRY_TYPE_DEVICE,           
    XF_INIT_REGISTRY_TYPE_COMPONENT,        
    XF_INIT_REGISTRY_TYPE_ENV,              
    XF_INIT_REGISTRY_TYPE_APP,              
    XF_INIT_REGISTRY_TYPE_MAX,
} xf_init_registry_type_t;
 
typedef int (*xf_init_fn_t)(void);
 
typedef struct _xf_init_registry_desc_t {
    const xf_init_fn_t func;            
    const char *func_name;              
} xf_init_registry_desc_t;
 
typedef struct _xf_init_registry_desc_node_t {
    xf_list_t node;
    const xf_init_registry_desc_t *const p_desc;
} xf_init_registry_desc_node_t;
 
/* ==================== [Global Prototypes] ================================= */
 
void xf_init_registry_register_desc_node(xf_init_registry_desc_node_t *p_desc_node, xf_init_registry_type_t type);
 
void xf_init_from_registry(void);
 
/* ==================== [Macros] ============================================ */
 
#define XF_INIT_EXPORT_REGISTRY(type, function) \
    void __used __constructor __xf_init_registry_##function(void) { \
        static const xf_init_registry_desc_t CONCAT(__xf_init_desc_, function) = { \
            .func       = (function), \
            .func_name  = XSTR(function), \
        };\
        static xf_init_registry_desc_node_t CONCAT(__xf_init_desc_node_, function) = { \
            .node       = XF_LIST_HEAD_INIT(CONCAT(__xf_init_desc_node_, function).node), \
            .p_desc     = &CONCAT(__xf_init_desc_, function), \
        };\
        xf_init_registry_register_desc_node(&CONCAT(__xf_init_desc_node_, function), XF_INIT_REGISTRY_TYPE_##type); \
    }
 
#define XF_INIT_EXPORT_REGISTRY_SETUP(function) XF_INIT_EXPORT_REGISTRY(SETUP, function)
 
#define XF_INIT_EXPORT_REGISTRY_BOARD(function) XF_INIT_EXPORT_REGISTRY(BOARD, function)
 
#define XF_INIT_EXPORT_REGISTRY_PREV(function) XF_INIT_EXPORT_REGISTRY(PREV, function)
 
#define XF_INIT_EXPORT_REGISTRY_CLEANUP(function) XF_INIT_EXPORT_REGISTRY(CLEANUP, function)
 
#define XF_INIT_EXPORT_REGISTRY_DEVICE(function) XF_INIT_EXPORT_REGISTRY(DEVICE, function)
 
#define XF_INIT_EXPORT_REGISTRY_COMPONENT(function) XF_INIT_EXPORT_REGISTRY(COMPONENT, function)
 
#define XF_INIT_EXPORT_REGISTRY_ENV(function) XF_INIT_EXPORT_REGISTRY(ENV, function)
 
#define XF_INIT_EXPORT_REGISTRY_APP(function) XF_INIT_EXPORT_REGISTRY(APP, function)
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* (XF_INIT_IMPL_METHOD == XF_INIT_IMPL_BY_REGISTRY) \
            || (XF_INIT_IMPL_METHOD == XF_INIT_IMPL_BY_CONSTRUCTOR) \
            || defined(__DOXYGEN__) */
 
#endif /* __XF_INIT_REGISTRY_H__ */