gdb/solib-svr4.h

   1 /* Handle shared libraries for GDB, the GNU Debugger.
   2
   3    Copyright (C) 2000-2024 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifndef SOLIB_SVR4_H
  21 #define SOLIB_SVR4_H
  22
  23 #include "solist.h"
  24
  25 struct objfile;
  26 struct solib_ops;
  27
  28 extern const solib_ops svr4_so_ops;
  29
  30 /* Link map info to include in an allocated so_list entry.  */
  31
  32 struct lm_info_svr4 final : public lm_info
  33 {
  34   /* Amount by which addresses in the binary should be relocated to
  35      match the inferior.  The direct inferior value is L_ADDR_INFERIOR.
  36      When prelinking is involved and the prelink base address changes,
  37      we may need a different offset - the recomputed offset is in L_ADDR.
  38      It is commonly the same value.  It is cached as we want to warn about
  39      the difference and compute it only once.  L_ADDR is valid
  40      iff L_ADDR_P.  */
  41   CORE_ADDR l_addr = 0, l_addr_inferior = 0;
  42   bool l_addr_p = false;
  43
  44   /* The target location of lm.  */
  45   CORE_ADDR lm_addr = 0;
  46
  47   /* Values read in from inferior's fields of the same name.  */
  48   CORE_ADDR l_ld = 0, l_next = 0, l_prev = 0, l_name = 0;
  49 };
  50
  51 using lm_info_svr4_up = std::unique_ptr<lm_info_svr4>;
  52
  53 /* Critical offsets and sizes which describe struct r_debug and
  54    struct link_map on SVR4-like targets.  All offsets and sizes are
  55    in bytes unless otherwise specified.  */
  56
  57 struct link_map_offsets
  58   {
  59     /* Offset and size of r_debug.r_version.  */
  60     int r_version_offset, r_version_size;
  61
  62     /* Offset of r_debug.r_map.  */
  63     int r_map_offset;
  64
  65     /* Offset of r_debug.r_brk.  */
  66     int r_brk_offset;
  67
  68     /* Offset of r_debug.r_ldsomap.  */
  69     int r_ldsomap_offset;
  70
  71     /* Offset of r_debug_extended.r_next.  */
  72     int r_next_offset;
  73
  74     /* Size of struct link_map (or equivalent), or at least enough of it
  75        to be able to obtain the fields below.  */
  76     int link_map_size;
  77
  78     /* Offset to l_addr field in struct link_map.  */
  79     int l_addr_offset;
  80
  81     /* Offset to l_ld field in struct link_map.  */
  82     int l_ld_offset;
  83
  84     /* Offset to l_next field in struct link_map.  */
  85     int l_next_offset;
  86
  87     /* Offset to l_prev field in struct link_map.  */
  88     int l_prev_offset;
  89
  90     /* Offset to l_name field in struct link_map.  */
  91     int l_name_offset;
  92   };
  93
  94 /* set_solib_svr4_fetch_link_map_offsets() is intended to be called by
  95    a <arch>_gdbarch_init() function.  It is used to establish an
  96    architecture specific link_map_offsets fetcher for the architecture
  97    being defined.  */
  98
  99 extern void set_solib_svr4_fetch_link_map_offsets
 100   (struct gdbarch *gdbarch, struct link_map_offsets *(*func) (void));
 101
 102 /* This function is called by thread_db.c.  Return the address of the
 103    link map for the given objfile.  */
 104 extern CORE_ADDR svr4_fetch_objfile_link_map (struct objfile *objfile);
 105
 106 /* Fetch (and possibly build) an appropriate `struct link_map_offsets'
 107    for ILP32 and LP64 SVR4 systems.  */
 108 extern struct link_map_offsets *svr4_ilp32_fetch_link_map_offsets (void);
 109 extern struct link_map_offsets *svr4_lp64_fetch_link_map_offsets (void);
 110
 111 /* Return 1 if PC lies in the dynamic symbol resolution code of the
 112    SVR4 run time loader.  */
 113 int svr4_in_dynsym_resolve_code (CORE_ADDR pc);
 114
 115 #endif /* solib-svr4.h */