1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2008 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef __RTLD_DB_H
#define __RTLD_DB_H
#pragma ident "%Z%%M% %I% %E% SMI"
#include <proc_service.h>
#include <thread.h>
#include <synch.h>
#include <sgs.h>
#include <machdep.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* Brand helper libraries must name their ops vector using this macro.
*/
#ifdef _LP64
#ifdef _ELF64
#define RTLD_DB_BRAND_OPS rtld_db_brand_ops64
#else /* !_ELF64 */
#define RTLD_DB_BRAND_OPS rtld_db_brand_ops32
#endif /* !_ELF64 */
#else /* !_LP64 */
#define RTLD_DB_BRAND_OPS rtld_db_brand_ops32
#endif /* !_LP64 */
/*
* State kept for brand helper libraries
*
* All librtld_db brand plugin libraries need to specify a Lmid_t value
* that controls how link map ids are assigned to native solaris objects
* (as pointed to by the processes aux vectors) which are enumerated by
* librtld_db. In most cases this value will either be LM_ID_NONE or
* LM_ID_BRAND.
*
* If LM_ID_NONE is specified in the structure below, then when native solaris
* objects are enumerated by librtld_db, their link map id values will match
* the link map ids assigned to those objects by the solaris linker within
* the target process.
*
* If LM_ID_BRAND is specified in the structure below, then when native solaris
* objects are enumerated by librtld_db, their link map id value will be
* explicity set to LM_ID_BRAND, regardless of the link map ids assigned to
* those objects by the solaris linker within the target process.
*
* In all cases the librtld_db brand plugin library can report any link
* map id value that it wants for objects that it enumerates via it's
* rho_loadobj_iter() entry point.
*/
typedef struct __rd_helper_data *rd_helper_data_t;
typedef struct rd_helper_ops {
Lmid_t rho_lmid;
rd_helper_data_t (*rho_init)(rd_agent_t *,
struct ps_prochandle *);
void (*rho_fini)(rd_helper_data_t);
int (*rho_loadobj_iter)(rd_helper_data_t,
rl_iter_f *, void *);
rd_err_e (*rho_get_dyns)(rd_helper_data_t,
psaddr_t, void **, size_t *);
} rd_helper_ops_t;
typedef struct rd_helper {
void *rh_dlhandle;
rd_helper_ops_t *rh_ops;
rd_helper_data_t rh_data;
} rd_helper_t;
struct rd_agent {
mutex_t rd_mutex;
struct ps_prochandle *rd_psp; /* prochandle pointer */
psaddr_t rd_rdebug; /* rtld r_debug */
psaddr_t rd_preinit; /* rtld_db_preinit */
psaddr_t rd_postinit; /* rtld_db_postinit */
psaddr_t rd_dlact; /* rtld_db_dlact */
psaddr_t rd_tbinder; /* tail of binder */
psaddr_t rd_rtlddbpriv; /* rtld rtld_db_priv */
ulong_t rd_flags; /* flags */
ulong_t rd_rdebugvers; /* rtld_db_priv.vers */
int rd_dmodel; /* data model */
rd_helper_t rd_helper; /* private to helper */
};
/*
* Values for rd_flags
*/
#define RDF_FL_COREFILE 0x0001 /* client is core file image */
#define RDAGLOCK(x) (void) mutex_lock(&(x->rd_mutex));
#define RDAGUNLOCK(x) (void) mutex_unlock(&(x->rd_mutex));
#define LOG(func) { \
(void) mutex_lock(&glob_mutex); \
if (rtld_db_logging) \
func; \
(void) mutex_unlock(&glob_mutex); \
}
extern mutex_t glob_mutex;
extern int rtld_db_version;
extern int rtld_db_logging;
extern rd_err_e rd_binder_exit_addr(struct rd_agent *, const char *,
psaddr_t *);
extern rd_err_e _rd_event_enable32(rd_agent_t *, int);
extern rd_err_e _rd_event_getmsg32(rd_agent_t *, rd_event_msg_t *);
extern rd_err_e _rd_get_dyns32(struct rd_agent *,
psaddr_t, Dyn **, size_t *);
extern rd_err_e _rd_get_ehdr32(struct rd_agent *,
psaddr_t, Ehdr *, uint_t *);
extern rd_err_e _rd_objpad_enable32(struct rd_agent *, size_t);
extern rd_err_e _rd_loadobj_iter32(rd_agent_t *, rl_iter_f *, void *);
extern rd_err_e _rd_reset32(struct rd_agent *);
extern rd_err_e find_dynamic_ent32(struct rd_agent *, psaddr_t,
Xword, Dyn *);
extern rd_err_e plt32_resolution(rd_agent_t *, psaddr_t, lwpid_t,
psaddr_t, rd_plt_info_t *);
extern rd_err_e validate_rdebug32(struct rd_agent *rap);
#ifdef _LP64
extern rd_err_e _rd_event_enable64(rd_agent_t *, int);
extern rd_err_e _rd_event_getmsg64(rd_agent_t *, rd_event_msg_t *);
extern rd_err_e _rd_get_dyns64(struct rd_agent *,
psaddr_t, Elf64_Dyn **, size_t *);
extern rd_err_e _rd_get_ehdr64(struct rd_agent *,
psaddr_t, Elf64_Ehdr *, uint_t *);
extern rd_err_e _rd_objpad_enable64(struct rd_agent *, size_t);
extern rd_err_e _rd_loadobj_iter64(rd_agent_t *, rl_iter_f *, void *);
extern rd_err_e _rd_reset64(struct rd_agent *);
extern rd_err_e find_dynamic_ent64(struct rd_agent *, psaddr_t,
Xword, Elf64_Dyn *);
extern rd_err_e plt64_resolution(rd_agent_t *, psaddr_t, lwpid_t,
psaddr_t, rd_plt_info_t *);
extern rd_err_e validate_rdebug64(struct rd_agent *rap);
#endif
#ifdef __cplusplus
}
#endif
#endif /* __RTLD_DB_H */
|
