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
|
/*
* Symbol table support for DTrace.
*/
/*
* Oracle Linux DTrace.
* Copyright (c) 2012, 2025, 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 _DT_SYMTAB_H
#define _DT_SYMTAB_H
#include <gelf.h>
#include <dtrace.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* We cannot rely on ELF symbol table management at all times: in particular,
* kernel symbols have no ELF symbol table. Thus, this module implements a
* simple, reasonably memory-efficient symbol table manager. Once built up, the
* symbol table needs sorting before it can be used for address->name lookup. It
* can also be packed, which increases efficiency further but forbids further
* modification. (We do not define whether the 'more efficient' form increases
* space- or time-efficiency.)
*/
typedef struct dt_symbol dt_symbol_t;
typedef struct dt_symtab dt_symtab_t;
struct dt_module;
extern dt_symtab_t *dt_symtab_create(dtrace_hdl_t *dtp);
extern void dt_symtab_destroy(dtrace_hdl_t *dtp, dt_symtab_t *symtab);
extern dt_symbol_t *dt_symbol_insert(dtrace_hdl_t *dtp, dt_symtab_t *symtab,
struct dt_module *dmp, const char *name, GElf_Addr addr, GElf_Xword size,
unsigned char info);
extern dt_symbol_t *dt_symbol_by_name(dtrace_hdl_t *dtp, const char *name);
extern dt_symbol_t *dt_symbol_by_name_next(const dt_symbol_t *symbol);
extern dt_symbol_t *dt_module_symbol_by_name(dtrace_hdl_t *dtp,
struct dt_module *dmp, const char *name);
extern dt_symbol_t *dt_symbol_by_addr(dt_symtab_t *symtab, GElf_Addr dts_addr);
extern void dt_symtab_sort(dt_symtab_t *symtab, int flag);
extern void dt_symtab_pack(dt_symtab_t *symtab);
extern const char *dt_symbol_name(const dt_symbol_t *symbol);
extern void dt_symbol_to_elfsym(dtrace_hdl_t *dtp, dt_symbol_t *symbol,
GElf_Sym *elf_symp);
extern struct dt_module *dt_symbol_module(dt_symbol_t *symbol);
extern void dt_symtab_set_traceable(dt_symtab_t *symtab);
extern int dt_symtab_traceable(const dt_symtab_t *symtab);
extern void dt_symbol_set_traceable(dt_symbol_t *symbol);
extern int dt_symbol_traceable(const dt_symbol_t *symbol);
#ifdef __cplusplus
}
#endif
#endif /* _DT_SYMTAB_H */
|
