### 18.25 Emulating TLS

For targets whose psABI does not provide Thread Local Storage via specific relocations and instruction sequences, an emulation layer is used. A set of target hooks allows this emulation layer to be configured for the requirements of a particular target. For instance the psABI may in fact specify TLS support in terms of an emulation layer.

The emulation layer works by creating a control object for every TLS object. To access the TLS object, a lookup function is provided which, when given the address of the control object, will return the address of the current thread’s instance of the TLS object.

Target Hook: const char * TARGET_EMUTLS_GET_ADDRESS

  Contains the name of the helper function that uses a TLS control object to locate a TLS instance. The default causes libgcc’s emulated TLS helper function to be used.

Target Hook: const char * TARGET_EMUTLS_REGISTER_COMMON

  Contains the name of the helper function that should be used at program startup to register TLS objects that are implicitly initialized to zero. If this is `NULL`, all TLS objects will have explicit initializers. The default causes libgcc’s emulated TLS registration function to be used.

Target Hook: const char * TARGET_EMUTLS_VAR_SECTION

  Contains the name of the section in which TLS control variables should be placed. The default of `NULL` allows these to be placed in any section.

Target Hook: const char * TARGET_EMUTLS_TMPL_SECTION

  Contains the name of the section in which TLS initializers should be placed. The default of `NULL` allows these to be placed in any section.

Target Hook: const char * TARGET_EMUTLS_VAR_PREFIX

  Contains the prefix to be prepended to TLS control variable names. The default of `NULL` uses a target-specific prefix.

Target Hook: const char * TARGET_EMUTLS_TMPL_PREFIX

  Contains the prefix to be prepended to TLS initializer objects. The default of `NULL` uses a target-specific prefix.

Target Hook: tree TARGET_EMUTLS_VAR_FIELDS (tree type, tree *name)

  Specifies a function that generates the FIELD_DECLs for a TLS control object type. type is the RECORD_TYPE the fields are for and name should be filled with the structure tag, if the default of `__emutls_object` is unsuitable. The default creates a type suitable for libgcc’s emulated TLS function.

Target Hook: tree TARGET_EMUTLS_VAR_INIT (tree var, tree decl, tree tmpl_addr)

  Specifies a function that generates the CONSTRUCTOR to initialize a TLS control object. var is the TLS control object, decl is the TLS object and tmpl_addr is the address of the initializer. The default initializes libgcc’s emulated TLS control object.

Target Hook: bool TARGET_EMUTLS_VAR_ALIGN_FIXED

  Specifies whether the alignment of TLS control variable objects is fixed and should not be increased as some backends may do to optimize single objects. The default is false.

Target Hook: bool TARGET_EMUTLS_DEBUG_FORM_TLS_ADDRESS

  Specifies whether a DWARF `DW_OP_form_tls_address` location descriptor may be used to describe emulated TLS control objects.