name

The name of the section.

sec-align

An expression that specifies a minimum alignment for the section. This can be increased silently by the linker if needed.

root

Optional. If root is specified, the section is always included, even if it is not referenced.

If space is specified, the defined section will be a NOBITS section. NOBITS sections have no bytes in the ELF file and are are typically placed in RAM. PBITS sections have bytes in the ELF file and are typically placed in ROM. (By default, sections will be PBITS sections.) Note that space sections are only space, they cannot have an initial value (your application can initialize a space section if needed, but there is no assigned initial value). Space sections can only contain space declarations and labels.

If the parameter is an expression (data), it generates an unsigned one-byte member in the section. The data expression is only evaluated during relocation and only if the value is needed. It causes a relocation error if the value of data is too large to fit in a byte. The possible range of values is 0 to 0xFF.

If the parameter is a quoted string, it generates one one-byte member in the section for each character in the string.

sdata8 data;

As udata8 data, except that it generates a signed one-byte member.

The possible range of values is –0x80 to 0x7F.

udata16 data;

As sdata8, except that it generates an unsigned two-byte member. The possible range of values is 0 to 0xFFFF.

sdata16 data;

As sdata8, except that it generates a signed two-byte member. The possible range of values is –0x8000 to 0x7FFF.

udata24 data;

As sdata8, except that it generates an unsigned three-byte member. The possible range of values is 0 to 0xFF'FFFF.

sdata24 data;

As sdata8, except that it generates a signed three-byte member. The possible range of values is –0x80'0000 to 0x7F'FFFF.

udata32 data;

As sdata8, except that it generates an unsigned four-byte member. The possible range of values is 0 to 0xFFFF'FFFF.

sdata32 data;

As sdata8, except that it generates a signed four-byte member.

The possible range of values is –0x8000'0000 to 0x7FFF'FFFF.

udata64 data;

As sdata8, except that it generates an unsigned eight-byte member. The possible range of values is 0 to 0xFFFF'FFFF'FFFF'FFFF.

sdata64 data;

As sdata8, except that it generates a signed eight-byte member. The possible range of values is ‑0x8000'0000'0000'0000 to 0x7FFF'FFFF'FFFF'FFFF.

space data;

Defines data bytes of space. data can be a constant, or an expression (like end_of_buffer - start_of_buffer where the two symbols are public symbols). Space declarations can only be used inside space sections, never in the default sections.

pad_to data-align;

Generates pad bytes to make the current offset from the start of the section to be aligned to the expression data-align. data-align must be a number to the power of two (1, 2, 4, 8, 16, 32, etc.).

Defines a label at the current offset from the start of the section. If public, public_code, etc., is specified, the label is visible to other program modules. If not, it is only visible to other data expressions in the linker configuration file.

public. Synonym for public_data.

public_code. Generates a code label (the ELF type for the symbol is STT_FUNC).

public_data. Generates a data label (the ELF type for the symbol is STT_OBJECT).

public_notype. Generates a type-less label (the ELF type for the symbol is STT_NOTYPE)

Generally, the type of a symbol does not matter.

if-item

Configuration-time selection of items.

condition

An expression.

data

An expression that is only evaluated during relocation and only if the value is needed.

maxstack("category")

The stack depth of the deepest call chain for any call graph root function in the category.

totalstack("category")

The sum of the stack depths of the deepest call chains for each call graph root function in the category.

size(block name)

The size of the block.