---

7.45 .gnu_subsection name, comprehension, encoding ¶

Create or switch the current object attributes subsection to name for This file. Valid values for name are following the pattern [a-zA-Z0-9_]+.

The subsection property comprehension determines how a program processing the attributes handles attributes that it does not recognize (perhaps because the object file was generated by a different version of the toolchain). A subsection that is marked optional can be skipped if it is not understood. A subsection marked required implies that information conveyed by the attribute is required for correct processing of the object file; a fatal diagnostic must be generated if a tool does not recognize either the tag or the value associated with it.

encoding specifies the expected encoding of the attributes recorded in the subsection. Currently supported values are ULEB128/uleb128 and NTBS/ntbs (null-terminated byte string).

On the first declaration of a subsection, both comprehension and encoding are mandatory parameters. However, on subsequent declarations, none of the parameters is required. If they are still specified, their values will be matched against the ones from the first declaration. Any mismatch will be reported as an error.

This directive is only available for Object Attributes v2.

See Object Attributes.