aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorJean Boussier <byroot@ruby-lang.org>2023-11-09 13:56:29 +0100
committerJean Boussier <jean.boussier@gmail.com>2023-11-13 08:45:20 +0100
commit9ca41e999159096cb0872b4babbb94bf5d1af4ce (patch)
tree997d7847124e8ddcadc75413b7eb6b0a587e1772 /include
parent4376a17552670021a9175bb487be8eb16a2a97e9 (diff)
downloadruby-9ca41e999159096cb0872b4babbb94bf5d1af4ce.tar.gz
GVL Instrumentation: pass thread->self as part of event data
Context: https://github.com/ivoanjo/gvl-tracing/pull/4 Some hooks may want to collect data on a per thread basis. Right now the only way to identify the concerned thread is to use `rb_nativethread_self()` or similar, but even then because of the thread cache or MaNy, two distinct Ruby threads may report the same native thread id. By passing `thread->self`, hooks can use it as a key to store the metadata. NB: Most hooks are executed outside the GVL, so such data collection need to use a thread-safe data-structure, and shouldn't use the reference in other ways from inside the hook. They must also either pin that value or handle compaction.
Diffstat (limited to 'include')
-rw-r--r--include/ruby/thread.h4
1 files changed, 3 insertions, 1 deletions
diff --git a/include/ruby/thread.h b/include/ruby/thread.h
index d6a543af91..f6eea65b70 100644
--- a/include/ruby/thread.h
+++ b/include/ruby/thread.h
@@ -227,7 +227,9 @@ void *rb_nogvl(void *(*func)(void *), void *data1,
#define RUBY_INTERNAL_THREAD_EVENT_MASK 0xff /** All Thread events */
-typedef void rb_internal_thread_event_data_t; // for future extension.
+typedef struct rb_internal_thread_event_data {
+ VALUE thread;
+} rb_internal_thread_event_data_t;
typedef void (*rb_internal_thread_event_callback)(rb_event_flag_t event,
const rb_internal_thread_event_data_t *event_data,