mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
2f50936cb9
Introduce new method Ractor.make_shareable(obj) which tries to make
obj shareable object. Protocol is here.
(1) If obj is shareable, it is shareable.
(2) If obj is not a shareable object and if obj can be shareable
object if it is frozen, then freeze obj. If obj has reachable
objects (rs), do rs.each{|o| Ractor.make_shareable(o)}
recursively (recursion is not Ruby-level, but C-level).
(3) Otherwise, raise Ractor::Error. Now T_DATA is not a shareable
object even if the object is frozen.
If the method finished without error, given obj is marked as
a sharable object.
To allow makng a shareable frozen T_DATA object, then set
`RUBY_TYPED_FROZEN_SHAREABLE` as type->flags. On default,
this flag is not set. It means user defined T_DATA objects are
not allowed to become shareable objects when it is frozen.
You can make any object shareable by setting FL_SHAREABLE flag,
so if you know that the T_DATA object is shareable (== thread-safe),
set this flag, at creation time for example. `Ractor` object is one
example, which is not a frozen, but a shareable object.
52 lines
968 B
C
52 lines
968 B
C
#ifndef RACTOR_PUB_INCLUDED
|
|
#define RACTOR_PUB_INCLUDED
|
|
|
|
RUBY_EXTERN bool ruby_multi_ractor;
|
|
|
|
bool rb_ractor_main_p_(void);
|
|
|
|
static inline bool
|
|
rb_ractor_main_p(void)
|
|
{
|
|
if (!ruby_multi_ractor) {
|
|
return true;
|
|
}
|
|
else {
|
|
return rb_ractor_main_p_();
|
|
}
|
|
}
|
|
|
|
bool rb_ractor_shareable_p_continue(VALUE obj);
|
|
|
|
#define RB_OBJ_SHAREABLE_P(obj) FL_TEST_RAW((obj), RUBY_FL_SHAREABLE)
|
|
|
|
// TODO: deep frozen
|
|
|
|
static inline bool
|
|
rb_ractor_shareable_p(VALUE obj)
|
|
{
|
|
if (SPECIAL_CONST_P(obj)) {
|
|
return true;
|
|
}
|
|
else if (RB_OBJ_SHAREABLE_P(obj)) {
|
|
return true;
|
|
}
|
|
else {
|
|
return rb_ractor_shareable_p_continue(obj);
|
|
}
|
|
}
|
|
|
|
VALUE rb_ractor_make_shareable(VALUE obj);
|
|
|
|
RUBY_SYMBOL_EXPORT_BEGIN
|
|
|
|
VALUE rb_ractor_stdin(void);
|
|
VALUE rb_ractor_stdout(void);
|
|
VALUE rb_ractor_stderr(void);
|
|
void rb_ractor_stdin_set(VALUE);
|
|
void rb_ractor_stdout_set(VALUE);
|
|
void rb_ractor_stderr_set(VALUE);
|
|
|
|
RUBY_SYMBOL_EXPORT_END
|
|
|
|
#endif
|