inspect.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025 Arduino SA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_LLEXT_INSPECT_H_
#define ZEPHYR_INCLUDE_LLEXT_INSPECT_H_
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stddef.h>
#include <zephyr/llext/llext.h>
#include <zephyr/llext/loader.h>
#include <zephyr/llext/llext_internal.h>


static inline int llext_get_region_info(const struct llext_loader *ldr,
                                        const struct llext *ext,
                                        enum llext_mem region,
                                        const elf_shdr_t **hdr,
                                        const void **addr, size_t *size)
{
        if ((unsigned int)region >= LLEXT_MEM_COUNT) {
                return -EINVAL;
        }
 
        if (hdr) {
                *hdr = &ldr->sects[region];
        }
 
        /* address and size compensated for alignment prepad */
        if (addr) {
                *addr = (void *)((uintptr_t)ext->mem[region] + ldr->sects[region].sh_info);
        }
        if (size) {
                *size = ext->mem_size[region] - ldr->sects[region].sh_info;
        }
 
        return 0;
}

int llext_section_shndx(const struct llext_loader *ldr, const struct llext *ext,
                            const char *section_name);

static inline int llext_get_section_info(const struct llext_loader *ldr,
                                         const struct llext *ext,
                                         unsigned int shndx,
                                         const elf_shdr_t **hdr,
                                         enum llext_mem *region,
                                         size_t *offset)
{
        if (shndx < 0 || shndx >= ext->sect_cnt) {
                return -EINVAL;
        }
        if (!ldr->sect_map) {
                return -ENOTSUP;
        }
 
        enum llext_mem mem_idx = ldr->sect_map[shndx].mem_idx;
 
        if (hdr) {
                *hdr = &ext->sect_hdrs[shndx];
        }
        if (region) {
                *region = mem_idx;
        }
 
        /* offset compensated for alignment prepad */
        if (offset) {
                if (ldr->sect_map[shndx].detached) {
                        *offset = (size_t)-1;
                } else {
                        *offset = ldr->sect_map[shndx].offset - ldr->sects[mem_idx].sh_info;
                }
        }
 
        return 0;
}

 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_LLEXT_INSPECT_H_ */