iterable_sections.h

Go to the documentation of this file.

/*
 * Copyright (C) 2020, Intel Corporation
 * Copyright (C) 2023, Nordic Semiconductor ASA
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef INCLUDE_ZEPHYR_LINKER_ITERABLE_SECTIONS_H_
#define INCLUDE_ZEPHYR_LINKER_ITERABLE_SECTIONS_H_
 
#define Z_LINK_ITERABLE(struct_type) \
        _CONCAT(_##struct_type, _list_start) = .; \
        KEEP(*(SORT_BY_NAME(._##struct_type.static.*))); \
        _CONCAT(_##struct_type, _list_end) = .
 
#define Z_LINK_ITERABLE_NUMERIC(struct_type) \
        _CONCAT(_##struct_type, _list_start) = .; \
        KEEP(*(SORT(._##struct_type.static.*_?_*))); \
        KEEP(*(SORT(._##struct_type.static.*_??_*))); \
        _CONCAT(_##struct_type, _list_end) = .
 
#define Z_LINK_ITERABLE_ALIGNED(struct_type, align) \
        . = ALIGN(align); \
        Z_LINK_ITERABLE(struct_type);
 
#define Z_LINK_ITERABLE_GC_ALLOWED(struct_type) \
        _CONCAT(_##struct_type, _list_start) = .; \
        *(SORT_BY_NAME(._##struct_type.static.*)); \
        _CONCAT(_##struct_type, _list_end) = .
 
#define Z_LINK_ITERABLE_SUBALIGN CONFIG_LINKER_ITERABLE_SUBALIGN
 
#define ITERABLE_SECTION_ROM(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area,,SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE(struct_type); \
        } GROUP_ROM_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
 
#define ITERABLE_SECTION_ROM_NUMERIC(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, EMPTY, SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE_NUMERIC(struct_type); \
        } GROUP_ROM_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
 
#define ITERABLE_SECTION_ROM_GC_ALLOWED(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area,,SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE_GC_ALLOWED(struct_type); \
        } GROUP_LINK_IN(ROMABLE_REGION)
 
#define ITERABLE_SECTION_RAM(struct_type, subalign) \
        SECTION_DATA_PROLOGUE(struct_type##_area,,SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
 
#define ITERABLE_SECTION_RAM_NUMERIC(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, EMPTY, SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE_NUMERIC(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
 
#define ITERABLE_SECTION_RAM_GC_ALLOWED(struct_type, subalign) \
        SECTION_DATA_PROLOGUE(struct_type##_area,,SUBALIGN(subalign)) \
        { \
                Z_LINK_ITERABLE_GC_ALLOWED(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
 
 /* end of struct_section_apis */
 
#endif /* INCLUDE_ZEPHYR_LINKER_ITERABLE_SECTIONS_H_ */