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_

 
/* clang-format off */
#define Z_LINK_ITERABLE(struct_type) \
        PLACE_SYMBOL_HERE(_CONCAT(_##struct_type, _list_start)); \
        KEEP(*(SORT_BY_NAME(._##struct_type.static.*))); \
        PLACE_SYMBOL_HERE(_CONCAT(_##struct_type, _list_end));
 
 
#define Z_LINK_ITERABLE_NUMERIC(struct_type) \
        PLACE_SYMBOL_HERE(_CONCAT(_##struct_type, _list_start)); \
        KEEP(*(SORT(._##struct_type.static.*_?_*))); \
        KEEP(*(SORT(._##struct_type.static.*_??_*))); \
        KEEP(*(SORT(._##struct_type.static.*_???_*))); \
        KEEP(*(SORT(._##struct_type.static.*_????_*))); \
        KEEP(*(SORT(._##struct_type.static.*_?????_*))); \
        PLACE_SYMBOL_HERE(_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) \
        PLACE_SYMBOL_HERE(_CONCAT(_##struct_type, _list_start)); \
        *(SORT_BY_NAME(._##struct_type.static.*)); \
        PLACE_SYMBOL_HERE(_CONCAT(_##struct_type, _list_end));
/* clang-format on */
 
#define Z_LINK_ITERABLE_SUBALIGN CONFIG_LINKER_ITERABLE_SUBALIGN

#define ITERABLE_SECTION_ROM(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, ,) \
        { \
                Z_LINK_ITERABLE(struct_type); \
        } GROUP_ROM_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
#define ITERABLE_SECTION_ROM(struct_type, subalign) \ …

#define ITERABLE_SECTION_ROM_NUMERIC(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, EMPTY,) \
        { \
                Z_LINK_ITERABLE_NUMERIC(struct_type); \
        } GROUP_ROM_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
#define ITERABLE_SECTION_ROM_NUMERIC(struct_type, subalign) \ …

#define ITERABLE_SECTION_ROM_GC_ALLOWED(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, ,) \
        { \
                Z_LINK_ITERABLE_GC_ALLOWED(struct_type); \
        } GROUP_LINK_IN(ROMABLE_REGION)
#define ITERABLE_SECTION_ROM_GC_ALLOWED(struct_type, subalign) \ …

#define ITERABLE_SECTION_RAM(struct_type, subalign) \
        SECTION_DATA_PROLOGUE(struct_type##_area, ,) \
        { \
                Z_LINK_ITERABLE(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
#define ITERABLE_SECTION_RAM(struct_type, subalign) \ …

#define ITERABLE_SECTION_RAM_NUMERIC(struct_type, subalign) \
        SECTION_PROLOGUE(struct_type##_area, EMPTY,) \
        { \
                Z_LINK_ITERABLE_NUMERIC(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
#define ITERABLE_SECTION_RAM_NUMERIC(struct_type, subalign) \ …

#define ITERABLE_SECTION_RAM_GC_ALLOWED(struct_type, subalign) \
        SECTION_DATA_PROLOGUE(struct_type##_area, ,) \
        { \
                Z_LINK_ITERABLE_GC_ALLOWED(struct_type); \
        } GROUP_DATA_LINK_IN(RAMABLE_REGION, ROMABLE_REGION)
#define ITERABLE_SECTION_RAM_GC_ALLOWED(struct_type, subalign) \ …
 /* end of struct_section_apis */
 
#endif /* INCLUDE_ZEPHYR_LINKER_ITERABLE_SECTIONS_H_ */