sysdeps/generic/tls.h

   1 /* Definition for thread-local data handling.  Generic version.
   2    Copyright (C) 2002, 2006 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, write to the Free
  17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18    02111-1307 USA.  */
  19
  20 /* An architecture-specific version of this file has to defined a
  21    number of symbols:
  22
  23      TLS_TCB_AT_TP  or  TLS_DTV_AT_TP
  24
  25      The presence of one of these symbols signals which variant of
  26      the TLS ABI is used.  There are in the moment two variants
  27      available:
  28
  29      * the thread pointer points to a thread control block
  30
  31      * the thread pointer points to the dynamic thread vector
  32
  33
  34      TLS_TCB_SIZE
  35
  36      This is the size of the thread control block structure.  How
  37      this is actually defined depends on the ABI.  The thread control
  38      block could be internal descriptor of the thread library or
  39      just a data structure which allows finding the DTV.
  40
  41      TLS_INIT_TCB_SIZE
  42
  43      Similarly, but this value is only used at startup and in the
  44      dynamic linker itself.  There are no threads in use at that time.
  45
  46
  47      TLS_TCB_ALIGN
  48
  49      Alignment requirements for the TCB structure.
  50
  51      TLS_INIT_TCB_ALIGN
  52
  53      Similarly, but for the structure used at startup time.
  54
  55
  56      INSTALL_DTV(tcb, init_dtv)
  57
  58      This macro must install the given initial DTV into the thread control
  59      block TCB.  The normal runtime functionality must then be able to
  60      use the value.
  61
  62
  63      TLS_INIT_TP(tcb, firstcall)
  64
  65      This macro must initialize the thread pointer to enable normal TLS
  66      operation.  The first parameter is a pointer to the thread control
  67      block.  The second parameter specifies whether this is the first
  68      call for the TCB.  ld.so calls this macro more than once.
  69
  70
  71      THREAD_DTV()
  72
  73      This macro returns the address of the DTV of the current thread.
  74      This normally is done using the the thread register which points
  75      to the dtv or the TCB (from which the DTV can found).
  76   */