required_symbols.md

Required symbols

This entry is used to tell the linker that a symbol should be linked into the build, even if it isn't refenced in any code.

This behavior is usually used when linking static libraries (.a) into the build, since the default linking behavior for those archives is to only pull symbols that are refenced on the rest of the build.

Every attribute listed is optional unless explicitly stated.

Table of contents

• Required symbols
  • Table of contents
  • name
    • Example
    • Valid values
  • include_if_any, include_if_all, exclude_if_any and exclude_if_all

name

This field is required.

The name of the corresponding symbol to be required.

Example

required_symbols:
  - name: guMtxCatL

Valid values

Non empty string.

TODO: Impose rules for valid names?

include_if_any, include_if_all, exclude_if_any and exclude_if_all

These fields allow to conditionally include or exclude a given segment depending on the current custom options.

Their syntax is the same as their file counterparts.