diff options
| author | normal <normal@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2019-01-04 13:14:11 +0000 |
|---|---|---|
| committer | normal <normal@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2019-01-04 13:14:11 +0000 |
| commit | 23444302d9200bcc41ce279a529f73cad63c3f05 (patch) | |
| tree | cb541d972fd43a434593dca6c3aebcfcdd8fe560 /include | |
| parent | 16cfd26a57c30e17bc3c116c83134420693ba5c4 (diff) | |
introduce rb_nogvl C-API to mark ubf as async-signal-safe
zlib and bignum both contain unblocking functions which are
async-signal-safe and do not require spawning additional
threads.
We can execute those functions directly in signal handlers
without incurring overhead of extra threads, so provide C-API
users the ability to deal with that. Other C-API users may
have similar need.
This flexible API can supercede existing uses of
rb_thread_call_without_gvl and rb_thread_call_without_gvl2 by
introducing a flags argument to control behavior.
Note: this API is NOT finalized. It needs approval from other
committers. I prefer shorter name than previous
rb_thread_call_without_gvl* functions because my eyes requires
big fonts.
[Bug #15499]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@66712 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'include')
| -rw-r--r-- | include/ruby/thread.h | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/include/ruby/thread.h b/include/ruby/thread.h index 550f678e54..d398cc127e 100644 --- a/include/ruby/thread.h +++ b/include/ruby/thread.h @@ -21,6 +21,10 @@ extern "C" { #include "ruby/intern.h" +/* flags for rb_nogvl */ +#define RB_NOGVL_INTR_FAIL (0x1) +#define RB_NOGVL_UBF_ASYNC_SAFE (0x2) + RUBY_SYMBOL_EXPORT_BEGIN void *rb_thread_call_with_gvl(void *(*func)(void *), void *data1); @@ -30,6 +34,14 @@ void *rb_thread_call_without_gvl(void *(*func)(void *), void *data1, void *rb_thread_call_without_gvl2(void *(*func)(void *), void *data1, rb_unblock_function_t *ubf, void *data2); +/* + * XXX: unstable/unapproved - out-of-tree code should NOT not depend + * on this until it hits Ruby 2.6.1 + */ +void *rb_nogvl(void *(*func)(void *), void *data1, + rb_unblock_function_t *ubf, void *data2, + int flags); + #define RUBY_CALL_WO_GVL_FLAG_SKIP_CHECK_INTS_AFTER 0x01 #define RUBY_CALL_WO_GVL_FLAG_SKIP_CHECK_INTS_ |