archive/ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2025-08-15 13:39:04 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Add Thread#native_thread_id [Feature #17853]

Browse source
This commit is contained in:
NARUSE, Yui 2021-05-22 21:36:27 +09:00
parent 88e3848fca
commit 46655156dc
5 changed files with 104 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
thread.c
View file

@ -3402,6 +3402,36 @@ rb_thread_setname(VALUE thread, VALUE name)
return name;
}
/*
* call-seq:
* thr.native_thread_id -> integer
*
* Return the native thread ID which is used by the Ruby thread.
*
* The ID depends on the OS. (not POSIX thread ID returned by pthread_self(3))
* * On Linux it is TID returned by gettid(2).
* * On macOS it is the system-wide unique integral ID of thread returned
* by pthread_threadid_np(3).
* * On FreeBSD it is the unique integral ID of the thread returned by
* pthread_getthreadid_np(3).
* * On Windows it is the thread identifier returned by GetThreadId().
* * On other platforms, it raises NotImplementedError.
*
* NOTE:
* If the thread is not associated yet or already deassociated with a native
* thread, it returns _nil_.
* If the Ruby implementation uses M:N thread model, the ID may change
* depending on the timing.
*/
static VALUE
rb_thread_native_thread_id(VALUE thread)
{
rb_thread_t *target_th = rb_thread_ptr(thread);
if (rb_threadptr_dead(target_th)) return Qnil;
return native_thread_native_thread_id(target_th);
}
/*
* call-seq:
* thr.to_s -> string
@ -5494,6 +5524,7 @@ Init_Thread(void)
rb_define_method(rb_cThread, "name", rb_thread_getname, 0);
rb_define_method(rb_cThread, "name=", rb_thread_setname, 1);
rb_define_method(rb_cThread, "native_thread_id", rb_thread_native_thread_id, 0);
rb_define_method(rb_cThread, "to_s", rb_thread_to_s, 0);
rb_define_alias(rb_cThread, "inspect", "to_s");