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
|
/*
* Oracle Linux DTrace.
* Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved.
* Licensed under the Universal Permissive License v 1.0 as shown at
* http://oss.oracle.com/licenses/upl.
*/
#ifndef _RTLD_DB_H
#define _RTLD_DB_H
#ifdef __cplusplus
extern "C" {
#endif
#include <link.h>
struct ps_prochandle;
/*
* Errors.
*/
typedef enum {
RD_ERR, /* generic */
RD_OK, /* generic "call" succeeded */
RD_NOMAPS /* link-maps are not yet available */
} rd_err_e;
/*
* Debugging events inside the runtime linker.
*/
typedef enum {
RD_NONE = 0, /* no event */
RD_DLACTIVITY /* a dlopen or dlclose has happened */
} rd_event_e;
/*
* Information about event instance. Identical to the r_state enumeration in
* <link.h>, save for slightly different enumeration names. If this ever
* changes (very unlikely), we will need to adapt, or add a translation layer.
*/
typedef enum {
RD_CONSISTENT, /* link-maps are stable */
RD_ADD, /* currently adding object to link-maps */
RD_DELETE /* currently deleting object from link-maps */
} rd_state_e;
typedef struct rd_event_msg {
rd_event_e type;
rd_state_e state; /* for DLACTIVITY */
} rd_event_msg_t;
struct rd_agent;
typedef struct rd_agent rd_agent_t;
/*
* Called with rd_event_msg_t of NULL when deallocating state.
*/
typedef void (*rd_event_fun)(rd_agent_t *, rd_event_msg_t *, void *);
/*
* iteration over load objects.
*/
typedef struct rd_loadobj {
intptr_t rl_diff_addr; /* Difference between addresses in ELF
file and addresses in memory */
uintptr_t rl_nameaddr; /* address of the name in user space */
uintptr_t rl_dyn; /* dynamic section of object */
Lmid_t rl_lmident; /* ident of link map */
uintptr_t *rl_scope; /* symbol search scope array */
unsigned int rl_nscopes; /* size of that array */
int rl_default_scope; /* If 1, this is the same as the
default search scope for this
lmid */
unsigned int rl_nscopes_alloced; /* number of elements allocated
(internal use) */
} rd_loadobj_t;
typedef int rl_iter_f(const rd_loadobj_t *, size_t, void *);
extern void rd_release(rd_agent_t *);
extern void rd_free(rd_agent_t *);
extern rd_err_e rd_event_enable(rd_agent_t *, rd_event_fun fun, void *data);
extern void rd_event_disable(rd_agent_t *rd);
extern void rd_event_suppress(rd_agent_t *rd);
extern rd_err_e rd_loadobj_iter(rd_agent_t *, rl_iter_f *,
void *);
extern rd_agent_t *rd_new(struct ps_prochandle *);
extern rd_loadobj_t *rd_get_scope(rd_agent_t *rd, rd_loadobj_t *buf,
const rd_loadobj_t *obj, unsigned int scope);
#ifdef __cplusplus
}
#endif
#endif /* _RTLD_DB_H */
|
