symbol.h

Go to the documentation of this file.

/*
 * Copyright (c) 2023 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_LLEXT_SYMBOL_H
#define ZEPHYR_LLEXT_SYMBOL_H
 
#include <zephyr/sys/iterable_sections.h>
#include <zephyr/toolchain.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct llext_const_symbol {
        union {
                const char *const name;
 
                const uintptr_t slid;
        };
 
        const void *const addr;
};
BUILD_ASSERT(sizeof(struct llext_const_symbol) == 2 * sizeof(uintptr_t));
 
struct llext_symbol {
        const char *name;
 
        void *addr;
};
 
 
struct llext_symtable {
        size_t sym_cnt;
 
        struct llext_symbol *syms;
};
 
 
#if defined(CONFIG_LLEXT) && defined(LL_EXTENSION_BUILD)
#define LL_EXTENSION_SYMBOL(x)                                                  \
        static const struct llext_const_symbol                                  \
                        Z_GENERIC_SECTION(".exported_sym") __used               \
                        x ## _sym = {                                           \
                .name = STRINGIFY(x), .addr = (const void *)&x,                 \
        }
#else
#define LL_EXTENSION_SYMBOL(x)
#endif
 
#if defined(LL_EXTENSION_BUILD)
#define EXPORT_SYMBOL(x) LL_EXTENSION_SYMBOL(x)
#elif defined(CONFIG_LLEXT_EXPORT_BUILTINS_BY_SLID)
#define EXPORT_SYMBOL(x)                                                        \
        static const char Z_GENERIC_SECTION("llext_exports_strtab") __used      \
                x ## _sym_name[] = STRINGIFY(x);                                \
        static const STRUCT_SECTION_ITERABLE(llext_const_symbol, x ## _sym) = { \
                .name = x ## _sym_name, .addr = (const void *)&x,               \
        }
#elif defined(CONFIG_LLEXT)
#define EXPORT_SYMBOL(x)                                                        \
        static const STRUCT_SECTION_ITERABLE(llext_const_symbol, x ## _sym) = { \
                .name = STRINGIFY(x), .addr = (const void *)&x,                 \
        }
#else
#define EXPORT_SYMBOL(x)
#endif
 
#ifdef __cplusplus
}
#endif
 
 
#endif /* ZEPHYR_LLEXT_SYMBOL_H */