From 0589419247c9cba64ab5fa3fa80134ed9ec835b3 Mon Sep 17 00:00:00 2001 From: Josh Stone Date: Fri, 10 May 2013 13:10:17 -0700 Subject: [PATCH] stapdyn.h: make the release markers a bit more visible --- runtime/dyninst/stapdyn.h | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/runtime/dyninst/stapdyn.h b/runtime/dyninst/stapdyn.h index 6f81df4b4..32970a4f7 100644 --- a/runtime/dyninst/stapdyn.h +++ b/runtime/dyninst/stapdyn.h @@ -22,10 +22,13 @@ extern "C" { * module, either directly or via dyninst in the mutatee. To maintain * compatibility as much as possible, function signatures should not be * changed between releases, only deprecated/renamed as necessary. + * + * NB: These are organized by the systemtap release in which each was first + * added, so we can keep some idea of the ABI progression. */ -/* STAP 2.0 : */ +/**** STAP 2.0 : ****/ extern int stp_dyninst_session_init(void); extern void stp_dyninst_session_exit(void); @@ -45,7 +48,8 @@ extern int enter_dyninst_uprobe(uint64_t index, struct pt_regs *regs); * first the original PC, then DWARF-ordered registers. */ extern int enter_dyninst_uprobe_regs(uint64_t index, unsigned long nregs, ...); -/* STAP 2.x : */ + +/**** STAP 2.1 : ****/ /* uprobes-like flags */ #define STAPDYN_PROBE_FLAG_RETURN 0x1 @@ -63,11 +67,20 @@ extern int enter_dyninst_utrace_probe(uint64_t index, struct pt_regs *regs); extern const char* stp_dyninst_shm_init(void); extern int stp_dyninst_shm_connect(const char* name); + +/**** STAP 2.2 : ****/ + /* The following function is dynamically generated by systemtap, and used by stapdyn to modify global variables at module startup only (that is, *before* running stp_dyninst_session_init()): */ extern int stp_global_setter(const char *name, const char *value); + +/**** STAP 2.x : ****/ + + +/* STAPDYN_PROBE_ALL_FLAGS was first added for 2.1, but is placed here so + * it can continue to be updated with new flags too. */ #define STAPDYN_PROBE_ALL_FLAGS (uint64_t)(STAPDYN_PROBE_FLAG_RETURN \ | STAPDYN_PROBE_FLAG_PROC_BEGIN | STAPDYN_PROBE_FLAG_PROC_END \ | STAPDYN_PROBE_FLAG_THREAD_BEGIN | STAPDYN_PROBE_FLAG_THREAD_END) -- 2.43.5