obj_core.h

Go to the documentation of this file.

/*
 * Copyright (c) 2023, Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef __KERNEL_OBJ_CORE_H__
#define __KERNEL_OBJ_CORE_H__
 
#include <zephyr/sys/slist.h>
 
#define K_OBJ_CORE(kobj)  (&((kobj)->obj_core))
 
#define K_OBJ_TYPE_ID_GEN(s)     ((s[0] << 24) | (s[1] << 16) | (s[2] << 8) | (s[3]))
 
/* Known kernel object types */
 
#define K_OBJ_TYPE_CONDVAR_ID    K_OBJ_TYPE_ID_GEN("COND")
#define K_OBJ_TYPE_CPU_ID        K_OBJ_TYPE_ID_GEN("CPU_")
#define K_OBJ_TYPE_EVENT_ID      K_OBJ_TYPE_ID_GEN("EVNT")
#define K_OBJ_TYPE_FIFO_ID       K_OBJ_TYPE_ID_GEN("FIFO")
#define K_OBJ_TYPE_KERNEL_ID     K_OBJ_TYPE_ID_GEN("KRNL")
#define K_OBJ_TYPE_LIFO_ID       K_OBJ_TYPE_ID_GEN("LIFO")
#define K_OBJ_TYPE_MEM_BLOCK_ID  K_OBJ_TYPE_ID_GEN("MBLK")
#define K_OBJ_TYPE_MBOX_ID       K_OBJ_TYPE_ID_GEN("MBOX")
#define K_OBJ_TYPE_MEM_SLAB_ID   K_OBJ_TYPE_ID_GEN("SLAB")
#define K_OBJ_TYPE_MSGQ_ID       K_OBJ_TYPE_ID_GEN("MSGQ")
#define K_OBJ_TYPE_MUTEX_ID      K_OBJ_TYPE_ID_GEN("MUTX")
#define K_OBJ_TYPE_PIPE_ID       K_OBJ_TYPE_ID_GEN("PIPE")
#define K_OBJ_TYPE_SEM_ID        K_OBJ_TYPE_ID_GEN("SEM4")
#define K_OBJ_TYPE_STACK_ID      K_OBJ_TYPE_ID_GEN("STCK")
#define K_OBJ_TYPE_THREAD_ID     K_OBJ_TYPE_ID_GEN("THRD")
#define K_OBJ_TYPE_TIMER_ID      K_OBJ_TYPE_ID_GEN("TIMR")
 
struct k_obj_type;
struct k_obj_core;
 
#ifdef CONFIG_OBJ_CORE
#define K_OBJ_CORE_INIT(_objp, _obj_type)   \
        extern struct k_obj_type _obj_type; \
        k_obj_core_init(_objp, &_obj_type)
 
#define K_OBJ_CORE_LINK(objp) k_obj_core_link(objp)
#else
#define K_OBJ_CORE_INIT(objp, type)   do { } while (0)
#define K_OBJ_CORE_LINK(objp)         do { } while (0)
#endif /* CONFIG_OBJ_CORE */
 
extern sys_slist_t z_obj_type_list;
 
struct k_obj_core_stats_desc {
        size_t  raw_size;   
        size_t  query_size; 
        int (*raw)(struct k_obj_core *obj_core, void *stats);
        int (*query)(struct k_obj_core *obj_core, void *stats);
        int (*reset)(struct k_obj_core *obj_core);
        int (*disable)(struct k_obj_core *obj_core);
        int (*enable)(struct k_obj_core *obj_core);
};
 
struct k_obj_type {
        sys_snode_t    node;   
        sys_slist_t    list;   
        uint32_t       id;     
        size_t         obj_core_offset;  
#ifdef CONFIG_OBJ_CORE_STATS
        struct k_obj_core_stats_desc *stats_desc;
#endif /* CONFIG_OBJ_CORE_STATS */
};
 
struct k_obj_core {
        sys_snode_t        node;   
        struct k_obj_type *type;   
#ifdef CONFIG_OBJ_CORE_STATS
        void  *stats;              
#endif /* CONFIG_OBJ_CORE_STATS */
};
 
struct k_obj_type *z_obj_type_init(struct k_obj_type *type,
                                   uint32_t id, size_t off);
 
struct k_obj_type *k_obj_type_find(uint32_t type_id);
 
int k_obj_type_walk_locked(struct k_obj_type *type,
                           int (*func)(struct k_obj_core *, void *),
                                  void *data);
 
int k_obj_type_walk_unlocked(struct k_obj_type *type,
                             int (*func)(struct k_obj_core *, void *),
                             void *data);
 
void k_obj_core_init(struct k_obj_core *obj_core, struct k_obj_type *type);
 
void k_obj_core_link(struct k_obj_core *obj_core);
 
void k_obj_core_init_and_link(struct k_obj_core *obj_core,
                              struct k_obj_type *type);
 
void k_obj_core_unlink(struct k_obj_core *obj_core);
 
#ifdef CONFIG_OBJ_CORE_STATS
static inline void k_obj_type_stats_init(struct k_obj_type *type,
                                         struct k_obj_core_stats_desc *stats_desc)
{
        type->stats_desc = stats_desc;
}
 
static inline void k_obj_core_stats_init(struct k_obj_core *obj_core,
                                         void *stats)
{
        obj_core->stats = stats;
}
#endif /* CONFIG_OBJ_CORE_STATS */
 
int k_obj_core_stats_register(struct k_obj_core *obj_core, void *stats,
                              size_t stats_len);
 
int k_obj_core_stats_deregister(struct k_obj_core *obj_core);
 
int k_obj_core_stats_raw(struct k_obj_core *obj_core, void *stats,
                         size_t stats_len);
 
int k_obj_core_stats_query(struct k_obj_core *obj_core, void *stats,
                           size_t stats_len);
 
int k_obj_core_stats_reset(struct k_obj_core *obj_core);
 
int k_obj_core_stats_disable(struct k_obj_core *obj_core);
 
int k_obj_core_stats_enable(struct k_obj_core *obj_core);
 
#endif /* __KERNEL_OBJ_CORE_H__ */