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
|
/*
* Oracle Linux DTrace.
* Copyright (c) 2006, 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_PROVIDER_H
#define _DT_PROVIDER_H
#include <dtrace/pid.h>
#include <dt_impl.h>
#include <dt_ident.h>
#include <dt_list.h>
#include <tracefs.h>
#ifdef __cplusplus
extern "C" {
#endif
struct dt_probe;
/*
* Because it would waste both space and time, argument types are not recorded
* with the probe by default. In order to determine argument types for args[X]
* variables, the D compiler queries for argument types on a probe-by-probe
* basis. (This optimizes for the common case that arguments are either not
* used or used in an untyped fashion.) Typed arguments are specified with a
* string of the type name in the 'native' member of the argument description
* structure. Typed arguments may be further translated to types of greater
* stability; the provider indicates such a translated argument by filling in
* the 'xlate' member with the string of the translated type.
* Finally, the provider may indicate which argument value a given argument
* maps to by setting the 'mapping' member -- allowing a single argument to map
* to multiple args[X] variables.
*/
typedef struct dt_argdesc {
int mapping;
int flags; /* see DT_NF_* */
const char *native;
const char *xlate;
} dt_argdesc_t;
typedef struct dt_provimpl {
const char *name; /* provider generic name */
int prog_type; /* BPF program type */
uint32_t stack_skip; /* # of stack frames to skip */
int (*populate)(dtrace_hdl_t *dtp); /* register probes */
int (*provide)(dtrace_hdl_t *dtp, /* provide probes */
const dtrace_probedesc_t *pdp);
int (*provide_probe)(dtrace_hdl_t *dtp, /* provide a specific probe */
const pid_probespec_t *psp);
void (*enable)(dtrace_hdl_t *dtp, /* enable the given probe */
struct dt_probe *prp);
void (*reject_clause)(const struct dt_probe *prp, int clsflags);
/* check clause flags */
int (*trampoline)(dt_pcb_t *pcb, /* generate BPF trampoline */
uint_t exitlbl);
int (*load_prog)(dtrace_hdl_t *dtp, const struct dt_probe *prp,
const dtrace_difo_t *dp, uint32_t lvl, char *buf,
size_t sz);
int (*attach)(dtrace_hdl_t *dtp, /* attach BPF prog to probe */
const struct dt_probe *prp, int bpf_fd);
int (*probe_info)(dtrace_hdl_t *dtp, /* get probe info */
const struct dt_probe *prp,
int *argcp, dt_argdesc_t **argvp);
int (*discover)(dtrace_hdl_t *dtp); /* discover new probes */
int (*add_probe)(dtrace_hdl_t *dtp, /* add a new probe */
struct dt_probe *prp);
void (*detach)(dtrace_hdl_t *dtp, /* probe cleanup */
const struct dt_probe *prb);
void (*probe_destroy)(dtrace_hdl_t *dtp, /* free probe data */
void *datap);
void (*destroy)(dtrace_hdl_t *dtp, /* free provider data */
void *datap);
} dt_provimpl_t;
/* list dt_dtrace first */
extern dt_provimpl_t dt_dtrace;
extern dt_provimpl_t dt_cpc;
extern dt_provimpl_t dt_fbt;
extern dt_provimpl_t dt_io;
extern dt_provimpl_t dt_ip;
extern dt_provimpl_t dt_lockstat;
extern dt_provimpl_t dt_proc;
extern dt_provimpl_t dt_profile;
extern dt_provimpl_t dt_rawtp;
extern dt_provimpl_t dt_sched;
extern dt_provimpl_t dt_sdt;
extern dt_provimpl_t dt_syscall;
extern dt_provimpl_t dt_tcp;
extern dt_provimpl_t dt_udp;
extern dt_provimpl_t dt_uprobe;
extern dt_provimpl_t dt_usdt;
extern const dt_provimpl_t *dt_providers[];
typedef struct dt_provider {
dt_list_t pv_list; /* list forward/back pointers */
struct dt_hentry he; /* htab links */
dtrace_providerdesc_t desc; /* provider name and attributes */
const dt_provimpl_t *impl; /* provider implementation */
dt_idhash_t *pv_probes; /* probe defs (if user-declared) */
dt_node_t *pv_nodes; /* parse node allocation list */
ulong_t *pv_xrefs; /* translator reference bitmap */
ulong_t pv_xrmax; /* number of valid bits in pv_xrefs */
ulong_t pv_gen; /* generation # that created me */
dtrace_hdl_t *pv_hdl; /* pointer to containing dtrace_hdl */
uint_t pv_flags; /* flags (see below) */
void *prv_data; /* provider-specific data */
} dt_provider_t;
#define DT_PROVIDER_INTF 0x1 /* provider interface declaration */
#define DT_PROVIDER_IMPL 0x2 /* provider implementation is loaded */
#define DT_PROVIDER_PID 0x4 /* provider is a PID provider */
extern dt_provider_t *dt_provider_lookup(dtrace_hdl_t *, const char *);
extern dt_provider_t *dt_provider_create(dtrace_hdl_t *, const char *,
const dt_provimpl_t *,
const dtrace_pattr_t *, void *);
extern int dt_provider_xref(dtrace_hdl_t *, dt_provider_t *, id_t);
extern int dt_provider_discover(dtrace_hdl_t *dtp);
#ifdef __cplusplus
}
#endif
#endif /* _DT_PROVIDER_H */
|
