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 */
116