14#include "ruby/internal/config.h"
36#include "debug_counter.h"
37#include "eval_intern.h"
39#include "internal/error.h"
40#include "internal/eval.h"
41#include "internal/sanitizers.h"
42#include "internal/signal.h"
43#include "internal/string.h"
44#include "internal/thread.h"
45#include "ruby_atomic.h"
47#include "ractor_core.h"
50#ifdef NEED_RUBY_ATOMIC_OPS
71#define FOREACH_SIGNAL(sig, offset) \
72 for (sig = siglist + (offset); sig < siglist + numberof(siglist); ++sig)
73enum { LONGEST_SIGNAME = 7 };
75 char signm[LONGEST_SIGNAME + 1];
138 {
"CHLD", RUBY_SIGCHLD },
139 {
"CLD", RUBY_SIGCHLD },
157 {
"VTALRM", SIGVTALRM},
184 {
"DANGER", SIGDANGER},
187 {
"MIGRATE", SIGMIGRATE},
196 {
"RETRACT", SIGRETRACT},
206static const char signame_prefix[] =
"SIG";
207static const int signame_prefix_len = 3;
210signm2signo(
VALUE *sig_ptr,
int negative,
int exit,
int *prefix_ptr)
213 VALUE vsig = *sig_ptr;
224 rb_raise(rb_eArgError,
"bad signal type %s",
227 *sig_ptr = vsig = str;
232 if (memchr(nm,
'\0',
len)) {
233 rb_raise(rb_eArgError,
"signal name with null byte");
236 if (
len > 0 && nm[0] ==
'-') {
238 rb_raise(rb_eArgError,
"negative signal name: % "PRIsVALUE, vsig);
244 if (
len >= prefix + signame_prefix_len) {
245 if (memcmp(nm + prefix, signame_prefix, signame_prefix_len) == 0)
246 prefix += signame_prefix_len;
248 if (
len <= (
long)prefix) {
252 if (prefix_ptr) *prefix_ptr = prefix;
253 nmlen =
len - prefix;
255 if (nmlen > LONGEST_SIGNAME)
goto unsupported;
256 FOREACH_SIGNAL(sigs, !exit) {
257 if (memcmp(sigs->signm, nm, nmlen) == 0 &&
258 sigs->signm[nmlen] ==
'\0') {
259 return negative ? -sigs->signo : sigs->signo;
264 if (prefix == signame_prefix_len) {
267 else if (prefix > signame_prefix_len) {
268 prefix -= signame_prefix_len;
276 prefix = signame_prefix_len;
278 rb_raise(rb_eArgError,
"unsupported signal '%.*s%"PRIsVALUE
"'",
279 prefix, signame_prefix, vsig);
288 FOREACH_SIGNAL(sigs, 0) {
289 if (sigs->signo == no)
312 const char *signame = signo2signm(
NUM2INT(signo));
313 if (!signame)
return Qnil;
320 return signo2signm(no);
324rb_signo2signm(
int signo)
326 const char *
const signm = signo2signm(signo);
328 return rb_sprintf(
"SIG%s", signm);
331 return rb_sprintf(
"SIG%u", signo);
345esignal_init(
int argc,
VALUE *argv,
VALUE self)
353 if (!
NIL_P(sig)) argnum = 2;
359 if (signo < 0 || signo > NSIG) {
360 rb_raise(rb_eArgError,
"invalid signal number (%d)", signo);
366 sig = rb_signo2signm(signo);
371 signo = signm2signo(&sig, FALSE, FALSE, &prefix);
372 if (prefix != signame_prefix_len) {
390esignal_signo(
VALUE self)
397interrupt_init(
int argc,
VALUE *argv,
VALUE self)
406void rb_malloc_info_show_results(
void);
407#if defined(USE_SIGALTSTACK) || defined(_WIN32)
408static void reset_sigmask(
int sig);
415 rb_debug_counter_show_results(
"killed by signal.");
417 rb_malloc_info_show_results();
419 signal(sig, SIG_DFL);
420#if defined(USE_SIGALTSTACK) || defined(_WIN32)
426static void sighandler(
int sig);
427static int signal_ignored(
int sig);
428static void signal_enque(
int sig);
434#define killpg(pg, sig) kill(-(pg), (sig))
447 sig = signm2signo(&str, TRUE, FALSE, NULL);
450 if (argc <= 1)
return INT2FIX(0);
454 for (i=1; i<argc; i++) {
455 if (killpg(
NUM2PIDT(argv[i]), sig) < 0)
460 const rb_pid_t self = (GET_THREAD() == GET_VM()->ractor.main_thread) ? getpid() : -1;
463 for (i=1; i<argc; i++) {
466 if ((sig != 0) && (self != -1) && (pid == self)) {
492 t = signal_ignored(sig);
494 if (t < 0 && kill(pid, sig))
502 else if (kill(pid, sig) < 0) {
507 rb_threadptr_check_signal(GET_VM()->ractor.main_thread);
520#define sighandler_t ruby_sighandler_t
522#ifdef USE_SIGALTSTACK
523typedef void ruby_sigaction_t(
int, siginfo_t*,
void*);
524#define SIGINFO_ARG , siginfo_t *info, void *ctx
525#define SIGINFO_CTX ctx
527typedef void ruby_sigaction_t(
int);
532#ifdef USE_SIGALTSTACK
534#define RUBY_SIGALTSTACK_SIZE (16*1024)
537rb_sigaltstack_size(
void)
539 int size = RUBY_SIGALTSTACK_SIZE;
543 int minsigstksz = (int)MINSIGSTKSZ;
544 if (size < minsigstksz)
548#if defined(HAVE_SYSCONF) && defined(_SC_PAGE_SIZE)
551 pagesize = (int)sysconf(_SC_PAGE_SIZE);
560static int rb_sigaltstack_size_value = 0;
563rb_allocate_sigaltstack(
void)
566 if (!rb_sigaltstack_size_value) {
567 rb_sigaltstack_size_value = rb_sigaltstack_size();
569 altstack = malloc(rb_sigaltstack_size_value);
570 if (!altstack) rb_memerror();
576rb_register_sigaltstack(
void *altstack)
578 stack_t newSS, oldSS;
580 newSS.ss_size = rb_sigaltstack_size_value;
581 newSS.ss_sp = altstack;
584 sigaltstack(&newSS, &oldSS);
592ruby_signal(
int signum, sighandler_t handler)
594 struct sigaction sigact, old;
597 rb_trap_accept_nativethreads[signum] = 0;
600 sigemptyset(&sigact.sa_mask);
601#if defined(USE_SIGALTSTACK) && !defined(__wasm__)
602 if (handler == SIG_IGN || handler == SIG_DFL) {
603 sigact.sa_handler = handler;
607 sigact.sa_sigaction = (ruby_sigaction_t*)handler;
608 sigact.sa_flags = SA_SIGINFO;
611 sigact.sa_handler = handler;
616#if defined(SA_ONSTACK) && defined(USE_SIGALTSTACK)
621 sigact.sa_flags |= SA_ONSTACK;
625 (void)VALGRIND_MAKE_MEM_DEFINED(&old,
sizeof(old));
626 if (sigaction(signum, &sigact, &old) < 0) {
629 if (old.sa_flags & SA_SIGINFO)
630 handler = (sighandler_t)old.sa_sigaction;
632 handler = old.sa_handler;
633 ASSUME(handler != SIG_ERR);
638ruby_posix_signal(
int signum, sighandler_t handler)
640 return ruby_signal(signum, handler);
644static inline sighandler_t
645ruby_signal(
int signum, sighandler_t handler)
647 if (signum == SIGKILL) {
651 return signal(signum, handler);
655#define ruby_signal(sig,handler) ( signal((sig),(handler)))
658ruby_nativethread_signal(
int signum, sighandler_t handler)
662 old = signal(signum, handler);
663 rb_trap_accept_nativethreads[signum] = 1;
670signal_ignored(
int sig)
674 struct sigaction old;
675 (void)VALGRIND_MAKE_MEM_DEFINED(&old,
sizeof(old));
676 if (sigaction(sig, NULL, &old) < 0)
return FALSE;
677 func = old.sa_handler;
680 sighandler_t old = signal(sig, SIG_DFL);
684 if (func == SIG_IGN)
return 1;
685 return func == sighandler ? 0 : -1;
691 ATOMIC_INC(signal_buff.cnt[sig]);
692 ATOMIC_INC(signal_buff.size);
698 int old_errnum =
errno;
701 rb_thread_wakeup_timer_thread(sig);
703#if !defined(BSD_SIGNAL) && !defined(POSIX_SIGNAL)
704 ruby_signal(sig, sighandler);
711rb_signal_buff_size(
void)
713 return signal_buff.size;
717rb_disable_interrupt(
void)
719#ifdef HAVE_PTHREAD_SIGMASK
722 pthread_sigmask(SIG_SETMASK, &mask, NULL);
727rb_enable_interrupt(
void)
729#ifdef HAVE_PTHREAD_SIGMASK
732 pthread_sigmask(SIG_SETMASK, &mask, NULL);
737rb_get_next_signal(
void)
741 if (signal_buff.size != 0) {
742 for (i=1; i<RUBY_NSIG; i++) {
743 if (signal_buff.cnt[i] > 0) {
744 ATOMIC_DEC(signal_buff.cnt[i]);
745 ATOMIC_DEC(signal_buff.size);
754#if defined SIGSEGV || defined SIGBUS || defined SIGILL || defined SIGFPE
755static const char *received_signal;
756# define clear_received_signal() do { \
757 if (GET_VM() != NULL) rb_gc_enable(); \
758 received_signal = 0; \
761# define clear_received_signal() ((void)0)
764#if defined(USE_SIGALTSTACK) || defined(_WIN32)
766# if defined __HAIKU__
767# define USE_UCONTEXT_REG 1
768# elif !(defined(HAVE_UCONTEXT_H) && (defined __i386__ || defined __x86_64__ || defined __amd64__))
769# elif defined __linux__
770# define USE_UCONTEXT_REG 1
771# elif defined __APPLE__
772# define USE_UCONTEXT_REG 1
773# elif defined __FreeBSD__
774# define USE_UCONTEXT_REG 1
776#if defined(HAVE_PTHREAD_SIGMASK)
777# define ruby_sigunmask pthread_sigmask
778#elif defined(HAVE_SIGPROCMASK)
779# define ruby_sigunmask sigprocmask
782reset_sigmask(
int sig)
784#if defined(ruby_sigunmask)
787 clear_received_signal();
788#if defined(ruby_sigunmask)
790 sigaddset(&mask, sig);
791 if (ruby_sigunmask(SIG_UNBLOCK, &mask, NULL)) {
797# ifdef USE_UCONTEXT_REG
799check_stack_overflow(
int sig,
const uintptr_t addr,
const ucontext_t *ctx)
801 const DEFINE_MCONTEXT_PTR(mctx, ctx);
802# if defined __linux__
804 const greg_t sp = mctx->gregs[REG_RSP];
805 const greg_t bp = mctx->gregs[REG_RBP];
807 const greg_t sp = mctx->gregs[REG_ESP];
808 const greg_t bp = mctx->gregs[REG_EBP];
810# elif defined __APPLE__
811# include <AvailabilityMacros.h>
812# if defined(MAC_OS_X_VERSION_10_5) && MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_5
813# define MCTX_SS_REG(reg) __ss.__##reg
815# define MCTX_SS_REG(reg) ss.reg
817# if defined(__LP64__)
818 const uintptr_t sp = mctx->MCTX_SS_REG(rsp);
819 const uintptr_t bp = mctx->MCTX_SS_REG(rbp);
821 const uintptr_t sp = mctx->MCTX_SS_REG(esp);
822 const uintptr_t bp = mctx->MCTX_SS_REG(ebp);
824# elif defined __FreeBSD__
825# if defined(__amd64__)
826 const __register_t sp = mctx->mc_rsp;
827 const __register_t bp = mctx->mc_rbp;
829 const __register_t sp = mctx->mc_esp;
830 const __register_t bp = mctx->mc_ebp;
832# elif defined __HAIKU__
833# if defined(__amd64__)
834 const unsigned long sp = mctx->rsp;
835 const unsigned long bp = mctx->rbp;
837 const unsigned long sp = mctx->esp;
838 const unsigned long bp = mctx->ebp;
841 enum {pagesize = 4096};
842 const uintptr_t sp_page = (uintptr_t)sp / pagesize;
843 const uintptr_t bp_page = (uintptr_t)bp / pagesize;
844 const uintptr_t fault_page = addr / pagesize;
848 if (sp_page == fault_page || sp_page == fault_page + 1 ||
849 (sp_page <= fault_page && fault_page <= bp_page)) {
852 int uplevel = roomof(pagesize,
sizeof(*ec->tag)) / 2;
853 while ((uintptr_t)ec->tag->buf / pagesize <= fault_page + 1) {
857 if ((crit = (!ec->tag->prev || !--uplevel)) != FALSE)
break;
858 rb_vm_tag_jmpbuf_deinit(&ec->tag->buf);
859 ec->tag = ec->tag->prev;
862 rb_ec_stack_overflow(ec, crit + 1);
867check_stack_overflow(
int sig,
const void *addr)
869 int ruby_stack_overflowed_p(
const rb_thread_t *,
const void *);
871 if (ruby_stack_overflowed_p(th, addr)) {
873 rb_ec_stack_overflow(th->ec, 1);
879# define CHECK_STACK_OVERFLOW() check_stack_overflow(sig, 0)
881# define FAULT_ADDRESS info->si_addr
882# ifdef USE_UCONTEXT_REG
883# define CHECK_STACK_OVERFLOW_() check_stack_overflow(sig, (uintptr_t)FAULT_ADDRESS, ctx)
885# define CHECK_STACK_OVERFLOW_() check_stack_overflow(sig, FAULT_ADDRESS)
887# define MESSAGE_FAULT_ADDRESS " at %p", FAULT_ADDRESS
888# define SIGNAL_FROM_USER_P() ((info)->si_code == SI_USER)
889# define CHECK_STACK_OVERFLOW() (SIGNAL_FROM_USER_P() ? (void)0 : CHECK_STACK_OVERFLOW_())
892# define CHECK_STACK_OVERFLOW() (void)0
894#ifndef MESSAGE_FAULT_ADDRESS
895# define MESSAGE_FAULT_ADDRESS
898#if defined SIGSEGV || defined SIGBUS || defined SIGILL || defined SIGFPE
899NOINLINE(
static void check_reserved_signal_(
const char *name,
size_t name_len,
int signo));
902#define check_reserved_signal(name) check_reserved_signal_(name, sizeof(name)-1, sig)
906static sighandler_t default_sigbus_handler;
907NORETURN(
static ruby_sigaction_t sigbus);
910sigbus(
int sig SIGINFO_ARG)
912 check_reserved_signal(
"BUS");
919#if defined __APPLE__ || defined __linux__
920 CHECK_STACK_OVERFLOW();
922 rb_bug_for_fatal_signal(default_sigbus_handler, sig, SIGINFO_CTX,
"Bus Error" MESSAGE_FAULT_ADDRESS);
928static sighandler_t default_sigsegv_handler;
929NORETURN(
static ruby_sigaction_t sigsegv);
932sigsegv(
int sig SIGINFO_ARG)
934 check_reserved_signal(
"SEGV");
935 CHECK_STACK_OVERFLOW();
936 rb_bug_for_fatal_signal(default_sigsegv_handler, sig, SIGINFO_CTX,
"Segmentation fault" MESSAGE_FAULT_ADDRESS);
942static sighandler_t default_sigill_handler;
943NORETURN(
static ruby_sigaction_t sigill);
946sigill(
int sig SIGINFO_ARG)
948 check_reserved_signal(
"ILL");
949#if defined __APPLE__ || defined __linux__
950 CHECK_STACK_OVERFLOW();
952 rb_bug_for_fatal_signal(default_sigill_handler, sig, SIGINFO_CTX,
"Illegal instruction" MESSAGE_FAULT_ADDRESS);
957NORETURN(
static void ruby_abort(
void));
974check_reserved_signal_(
const char *name,
size_t name_len,
int signo)
976 const char *prev = ATOMIC_PTR_EXCHANGE(received_signal, name);
979 ssize_t RB_UNUSED_VAR(err);
980 static const int stderr_fd = 2;
981#define NOZ(name, str) RBIMPL_ATTR_NONSTRING() name[sizeof(str)-1] = str
982 static const char NOZ(msg1,
" received in ");
983 static const char NOZ(msg2,
" handler\n");
988# define W(str, len) \
989 iov[i++] = (struct iovec){.iov_base = (void *)(str), .iov_len = (len)}
991# define W(str, len) err = write(stderr_fd, (str), (len))
994#if __has_feature(address_sanitizer) || \
995 __has_feature(memory_sanitizer) || \
996 defined(HAVE_VALGRIND_MEMCHECK_H)
997 ruby_posix_signal(signo, SIG_DFL);
1000 W(msg1,
sizeof(msg1));
1001 W(prev, strlen(prev));
1002 W(msg2,
sizeof(msg2));
1005 err = writev(stderr_fd, iov, i);
1010 if (GET_VM() != NULL) {
1011 rb_gc_disable_no_rest();
1016#if defined SIGPIPE || defined SIGSYS
1018sig_do_nothing(
int sig)
1024signal_exec(
VALUE cmd,
int sig)
1027 volatile rb_atomic_t old_interrupt_mask = ec->interrupt_mask;
1028 enum ruby_tag_type state;
1039 ec->interrupt_mask |= TRAP_INTERRUPT_MASK;
1041 if ((state = EC_EXEC_TAG()) == TAG_NONE) {
1047 ec->interrupt_mask = old_interrupt_mask;
1051 EC_JUMP_TAG(ec, state);
1059 VALUE trap_exit = vm->trap_list.cmd[0];
1062 vm->trap_list.cmd[0] = 0;
1063 signal_exec(trap_exit, 0);
1072 VALUE cmd = vm->trap_list.cmd[sig];
1097 rb_threadptr_signal_raise(th, sig);
1101 else if (UNDEF_P(cmd)) {
1102 rb_threadptr_signal_exit(th);
1105 return signal_exec(cmd, sig);
1111default_handler(
int sig)
1141 func = (sighandler_t)sigbus;
1146 func = (sighandler_t)sigsegv;
1151 func = sig_do_nothing;
1156 func = sig_do_nothing;
1168trap_handler(
VALUE *cmd,
int sig)
1170 sighandler_t func = sighandler;
1180 if (!command) rb_raise(rb_eArgError,
"bad handler");
1182 if (!
NIL_P(command)) {
1194 func = default_handler(sig);
1201 if (memcmp(cptr,
"SYSTEM_DEFAULT", 14) == 0) {
1207 if (memcmp(cptr,
"SIG_IGN", 7) == 0) {
1210 else if (memcmp(cptr,
"SIG_DFL", 7) == 0) {
1213 else if (memcmp(cptr,
"DEFAULT", 7) == 0) {
1218 if (memcmp(cptr,
"IGNORE", 6) == 0) {
1223 if (memcmp(cptr,
"EXIT", 4) == 0) {
1231 GetProcPtr(*cmd, proc);
1240trap_signm(
VALUE vsig)
1246 if (sig < 0 || sig >= NSIG) {
1247 rb_raise(rb_eArgError,
"invalid signal number (%d)", sig);
1251 sig = signm2signo(&vsig, FALSE, TRUE, NULL);
1257trap(
int sig, sighandler_t func,
VALUE command)
1259 sighandler_t oldfunc;
1272 oldfunc = ruby_signal(sig, func);
1273 if (oldfunc == SIG_ERR) rb_sys_fail_str(rb_signo2signm(sig));
1275 oldcmd = vm->trap_list.cmd[sig];
1279 if (oldfunc == SIG_IGN) oldcmd =
rb_str_new2(
"IGNORE");
1280 else if (oldfunc == SIG_DFL) oldcmd =
rb_str_new2(
"SYSTEM_DEFAULT");
1281 else if (oldfunc == sighandler) oldcmd =
rb_str_new2(
"DEFAULT");
1291 ACCESS_ONCE(
VALUE, vm->trap_list.cmd[sig]) = command;
1297reserved_signal_p(
int signo)
1301 if (signo == SIGSEGV)
1305 if (signo == SIGBUS)
1309 if (signo == SIGILL)
1313 if (signo == SIGFPE)
1319 if (signo == SIGVTALRM)
1366 sig = trap_signm(argv[0]);
1367 if (reserved_signal_p(sig)) {
1368 const char *name = signo2signm(sig);
1370 rb_raise(rb_eArgError,
"can't trap reserved signal: SIG%s", name);
1372 rb_raise(rb_eArgError,
"can't trap reserved signal: %d", sig);
1381 func = trap_handler(&cmd, sig);
1386 cmd = rb_proc_isolate(cmd);
1389 return trap(sig, func, cmd);
1404 VALUE h = rb_hash_new();
1407 FOREACH_SIGNAL(sigs, 0) {
1408 rb_hash_aset(h, rb_fstring_cstr(sigs->signm),
INT2FIX(sigs->signo));
1413#define INSTALL_SIGHANDLER(cond, signame, signum) do { \
1414 static const char failed[] = "failed to install "signame" handler"; \
1415 if (!(cond)) break; \
1416 if (reserved_signal_p(signum)) rb_bug(failed); \
1421install_sighandler_core(
int signum, sighandler_t handler, sighandler_t *old_handler)
1425 old = ruby_signal(signum, handler);
1426 if (old == SIG_ERR)
return -1;
1428 *old_handler = (old == SIG_DFL || old == SIG_IGN) ? 0 : old;
1432 if (old != SIG_DFL) {
1433 ruby_signal(signum, old);
1439# define install_sighandler(signum, handler) \
1440 INSTALL_SIGHANDLER(install_sighandler_core(signum, handler, NULL), #signum, signum)
1441# define force_install_sighandler(signum, handler, old_handler) \
1442 INSTALL_SIGHANDLER(install_sighandler_core(signum, handler, old_handler), #signum, signum)
1447 sighandler_t oldfunc;
1449 oldfunc = ruby_signal(SIGINT, SIG_IGN);
1450 if (oldfunc == sighandler) {
1451 ruby_signal(SIGINT, SIG_DFL);
1455int ruby_enable_coredump = 0;
1510 VM_ASSERT(GET_THREAD()->pending_interrupt_queue);
1513 rb_disable_interrupt();
1515 install_sighandler(SIGINT, sighandler);
1517 install_sighandler(SIGHUP, sighandler);
1520 install_sighandler(SIGQUIT, sighandler);
1523 install_sighandler(SIGTERM, sighandler);
1526 install_sighandler(SIGALRM, sighandler);
1529 install_sighandler(SIGUSR1, sighandler);
1532 install_sighandler(SIGUSR2, sighandler);
1535 if (!ruby_enable_coredump) {
1537 force_install_sighandler(SIGBUS, (sighandler_t)sigbus, &default_sigbus_handler);
1540 force_install_sighandler(SIGILL, (sighandler_t)sigill, &default_sigill_handler);
1543 RB_ALTSTACK_INIT(GET_VM()->main_altstack, rb_allocate_sigaltstack());
1544 force_install_sighandler(SIGSEGV, (sighandler_t)sigsegv, &default_sigsegv_handler);
1548 install_sighandler(SIGPIPE, sig_do_nothing);
1551 install_sighandler(SIGSYS, sig_do_nothing);
1555 install_sighandler(RUBY_SIGCHLD, sighandler);
1558 rb_enable_interrupt();
std::atomic< unsigned > rb_atomic_t
Type that is eligible for atomic operations.
#define rb_define_method(klass, mid, func, arity)
Defines klass#mid.
#define rb_define_module_function(klass, mid, func, arity)
Defines klass#mid and makes it a module function.
#define rb_define_global_function(mid, func, arity)
Defines rb_mKernel #mid.
VALUE rb_define_module(const char *name)
Defines a top-level module.
#define rb_str_new2
Old name of rb_str_new_cstr.
#define T_STRING
Old name of RUBY_T_STRING.
#define Qundef
Old name of RUBY_Qundef.
#define INT2FIX
Old name of RB_INT2FIX.
#define UNREACHABLE_RETURN
Old name of RBIMPL_UNREACHABLE_RETURN.
#define FIX2INT
Old name of RB_FIX2INT.
#define ASSUME
Old name of RBIMPL_ASSUME.
#define rb_ary_new3
Old name of rb_ary_new_from_args.
#define Qtrue
Old name of RUBY_Qtrue.
#define NUM2INT
Old name of RB_NUM2INT.
#define INT2NUM
Old name of RB_INT2NUM.
#define Qnil
Old name of RUBY_Qnil.
#define NIL_P
Old name of RB_NIL_P.
#define IMMEDIATE_P
Old name of RB_IMMEDIATE_P.
#define FIXNUM_P
Old name of RB_FIXNUM_P.
#define SYMBOL_P
Old name of RB_SYMBOL_P.
void ruby_sig_finalize(void)
Clear signal handlers.
VALUE rb_eInterrupt
Interrupt exception.
void rb_bug_errno(const char *mesg, int errno_arg)
This is a wrapper of rb_bug() which automatically constructs appropriate message from the passed errn...
VALUE rb_eSignal
SignalException exception.
VALUE rb_check_to_integer(VALUE val, const char *mid)
Identical to rb_check_convert_type(), except the return value type is fixed to rb_cInteger.
VALUE rb_call_super(int argc, const VALUE *argv)
This resembles ruby's super.
#define UNLIMITED_ARGUMENTS
This macro is used in conjunction with rb_check_arity().
static int rb_check_arity(int argc, int min, int max)
Ensures that the passed integer is in the passed range.
VALUE rb_block_proc(void)
Constructs a Proc object from implicitly passed components.
VALUE rb_obj_is_proc(VALUE recv)
Queries if the given object is a proc.
void ruby_default_signal(int sig)
Pretends as if there was no custom signal handler.
const char * ruby_signal_name(int signo)
Queries the name of the signal.
VALUE rb_f_kill(int argc, const VALUE *argv)
Sends a signal ("kills") to processes.
VALUE rb_str_append(VALUE dst, VALUE src)
Identical to rb_str_buf_append(), except it converts the right hand side before concatenating.
VALUE rb_str_subseq(VALUE str, long beg, long len)
Identical to rb_str_substr(), except the numbers are interpreted as byte offsets instead of character...
void rb_must_asciicompat(VALUE obj)
Asserts that the given string's encoding is (Ruby's definition of) ASCII compatible.
VALUE rb_check_string_type(VALUE obj)
Try converting an object to its stringised representation using its to_str method,...
#define rb_str_new_cstr(str)
Identical to rb_str_new, except it assumes the passed pointer is a pointer to a C string.
VALUE rb_thread_current(void)
Obtains the "current" thread.
VALUE rb_ivar_set(VALUE obj, ID name, VALUE val)
Identical to rb_iv_set(), except it accepts the name as an ID instead of a C string.
VALUE rb_ivar_get(VALUE obj, ID name)
Identical to rb_iv_get(), except it accepts the name as an ID instead of a C string.
void rb_alias(VALUE klass, ID dst, ID src)
Resembles alias.
VALUE rb_eval_cmd_kw(VALUE cmd, VALUE arg, int kw_splat)
This API is practically a variant of rb_proc_call_kw() now.
static ID rb_intern_const(const char *str)
This is a "tiny optimisation" over rb_intern().
VALUE rb_sym2str(VALUE symbol)
Obtain a frozen string representation of a symbol (not including the leading colon).
int len
Length of the buffer.
static bool rb_ractor_shareable_p(VALUE obj)
Queries if multiple Ractors can share the passed object or not.
Defines RBIMPL_ATTR_NONSTRING.
#define NUM2PIDT
Converts an instance of rb_cNumeric into C's pid_t.
#define StringValue(v)
Ensures that the parameter object is a String.
#define RSTRING_GETMEM(str, ptrvar, lenvar)
Convenient macro to obtain the contents and length at once.
const char * rb_obj_classname(VALUE obj)
Queries the name of the class of the passed object.
#define errno
Ractor-aware version of errno.
#define RB_NO_KEYWORDS
Do not pass keywords.
#define _(args)
This was a transition path from K&R to ANSI.
uintptr_t VALUE
Type that represents a Ruby object.
static bool RB_SYMBOL_P(VALUE obj)
Queries if the object is an instance of rb_cSymbol.
static bool RB_TYPE_P(VALUE obj, enum ruby_value_type t)
Queries if the given object is of given type.