14#include "ruby/internal/config.h"
22# include <sys/cygwin.h>
25#if defined(LOAD_RELATIVE) && defined(HAVE_DLADDR)
33#if defined(HAVE_FCNTL_H)
35#elif defined(HAVE_SYS_FCNTL_H)
36# include <sys/fcntl.h>
39#ifdef HAVE_SYS_PARAM_H
40# include <sys/param.h>
44#include "eval_intern.h"
46#include "internal/cmdlineopt.h"
47#include "internal/cont.h"
48#include "internal/error.h"
49#include "internal/file.h"
50#include "internal/inits.h"
51#include "internal/io.h"
52#include "internal/load.h"
53#include "internal/loadpath.h"
54#include "internal/missing.h"
55#include "internal/object.h"
56#include "internal/thread.h"
57#include "internal/ruby_parser.h"
58#include "internal/variable.h"
65#define singlebit_only_p(x) !((x) & ((x)-1))
66STATIC_ASSERT(Qnil_1bit_from_Qfalse, singlebit_only_p(
Qnil^
Qfalse));
67STATIC_ASSERT(Qundef_1bit_from_Qnil, singlebit_only_p(
Qundef^
Qnil));
70# define MAXPATHLEN 1024
73# define O_ACCMODE (O_RDONLY | O_WRONLY | O_RDWR)
76void Init_ruby_description(ruby_cmdline_options_t *opt);
82#ifndef DISABLE_RUBYGEMS
83# define DISABLE_RUBYGEMS 0
86#define DEFAULT_RUBYGEMS_ENABLED "disabled"
88#define DEFAULT_RUBYGEMS_ENABLED "enabled"
91void rb_warning_category_update(
unsigned int mask,
unsigned int bits);
94#define FEATURE_BIT(bit) (1U << feature_##bit)
95#define EACH_FEATURES(X, SEP) \
106 X(frozen_string_literal) \
112#define EACH_DEBUG_FEATURES(X, SEP) \
113 X(frozen_string_literal) \
115#define AMBIGUOUS_FEATURE_NAMES 0
116#define DEFINE_FEATURE(bit) feature_##bit
117#define DEFINE_DEBUG_FEATURE(bit) feature_debug_##bit
118enum feature_flag_bits {
119 EACH_FEATURES(DEFINE_FEATURE, COMMA),
120 DEFINE_FEATURE(frozen_string_literal_set),
121 feature_debug_flag_first,
122#if !USE_YJIT && USE_ZJIT
123 DEFINE_FEATURE(jit) = feature_zjit,
125 DEFINE_FEATURE(jit) = feature_yjit,
127 feature_jit_mask = FEATURE_BIT(yjit) | FEATURE_BIT(zjit),
129 feature_debug_flag_begin = feature_debug_flag_first - 1,
130 EACH_DEBUG_FEATURES(DEFINE_DEBUG_FEATURE, COMMA),
134#define MULTI_BITS_P(bits) ((bits) & ((bits) - 1))
136#define DEBUG_BIT(bit) (1U << feature_debug_##bit)
138#define DUMP_BIT(bit) (1U << dump_##bit)
139#define DEFINE_DUMP(bit) dump_##bit
140#define EACH_DUMPS(X, SEP) \
159 dump_opt_error_tolerant,
162 EACH_DUMPS(DEFINE_DUMP, COMMA),
163 dump_exit_bits = (DUMP_BIT(yydebug) | DUMP_BIT(syntax) |
164 DUMP_BIT(parsetree) | DUMP_BIT(insns)),
165 dump_optional_bits = (DUMP_BIT(opt_error_tolerant) |
166 DUMP_BIT(opt_comment) |
167 DUMP_BIT(opt_optimize))
171rb_feature_set_to(
ruby_features_t *feat,
unsigned int bit_mask,
unsigned int bit_set)
173 feat->mask |= bit_mask;
174 feat->set = (feat->set & ~bit_mask) | bit_set;
177#define FEATURE_SET_TO(feat, bit_mask, bit_set) \
178 rb_feature_set_to(&(feat), bit_mask, bit_set)
179#define FEATURE_SET(feat, bits) FEATURE_SET_TO(feat, bits, bits)
180#define FEATURE_SET_RESTORE(feat, save) FEATURE_SET_TO(feat, (save).mask, (save).set & (save).mask)
181#define FEATURE_SET_P(feat, bits) ((feat).set & FEATURE_BIT(bits))
182#define FEATURE_USED_P(feat, bits) ((feat).mask & FEATURE_BIT(bits))
183#define FEATURE_SET_BITS(feat) ((feat).set & (feat).mask)
185static void init_ids(ruby_cmdline_options_t *);
187#define src_encoding_index GET_VM()->src_encoding_index
190 COMPILATION_FEATURES = (
192 | FEATURE_BIT(frozen_string_literal)
193 | FEATURE_BIT(frozen_string_literal_set)
194 | FEATURE_BIT(debug_frozen_string_literal)
197 (FEATURE_BIT(debug_flag_first)-1)
201 & ~FEATURE_BIT(frozen_string_literal)
202 & ~FEATURE_BIT(frozen_string_literal_set)
207#define BACKTRACE_LENGTH_LIMIT_VALID_P(n) ((n) >= -1)
208#define OPT_BACKTRACE_LENGTH_LIMIT_VALID_P(opt) \
209 BACKTRACE_LENGTH_LIMIT_VALID_P((opt)->backtrace_length_limit)
211static ruby_cmdline_options_t *
212cmdline_options_init(ruby_cmdline_options_t *opt)
216 opt->src.enc.index = src_encoding_index;
217 opt->ext.enc.index = -1;
218 opt->intern.enc.index = -1;
219 opt->features.set = DEFAULT_FEATURES;
220#if defined(YJIT_FORCE_ENABLE)
221 opt->features.set |= FEATURE_BIT(yjit);
223 opt->dump |= DUMP_BIT(opt_optimize);
224 opt->backtrace_length_limit = LONG_MIN;
230 ruby_cmdline_options_t *opt);
231static VALUE open_load_file(
VALUE fname_v,
int *xflag);
232static void forbid_setid(
const char *,
const ruby_cmdline_options_t *);
233#define forbid_setid(s) forbid_setid((s), opt)
240static const char esc_standout[] =
"\n\033[1;7m";
241static const char esc_bold[] =
"\033[1m";
242static const char esc_reset[] =
"\033[0m";
243static const char esc_none[] =
"";
244#define USAGE_INDENT " "
247show_usage_part(
const char *str,
const unsigned int namelen,
248 const char *str2,
const unsigned int secondlen,
250 int help,
int highlight,
unsigned int w,
int columns)
252 static const int indent_width = (int)
rb_strlen_lit(USAGE_INDENT);
253 const char *sb = highlight ? esc_bold : esc_none;
254 const char *se = highlight ? esc_reset : esc_none;
255 unsigned int desclen = (
unsigned int)strcspn(desc,
"\n");
256 if (!help && desclen > 0 && strchr(
".;:", desc[desclen-1])) --desclen;
257 if (help && (namelen + 1 > w) &&
258 (
int)(namelen + secondlen + indent_width) >= columns) {
259 printf(USAGE_INDENT
"%s" "%.*s" "%s\n", sb, namelen, str, se);
261 const int second_end = secondlen;
263 if (str2[n] ==
',') n++;
264 if (str2[n] ==
' ') n++;
265 printf(USAGE_INDENT
"%s" "%.*s" "%s\n", sb, second_end-n, str2+n, se);
267 printf(
"%-*s%.*s\n", w + indent_width, USAGE_INDENT, desclen, desc);
270 const int wrap = help && namelen + secondlen >= w;
271 printf(USAGE_INDENT
"%s%.*s%-*.*s%s%-*s%.*s\n", sb, namelen, str,
272 (wrap ? 0 : w - namelen),
273 (help ? secondlen : 0), str2, se,
275 (wrap ?
"\n" USAGE_INDENT :
""),
279 while (desc[desclen]) {
281 desclen = (
unsigned int)strcspn(desc,
"\n");
282 printf(
"%-*s%.*s\n", w + indent_width, USAGE_INDENT, desclen, desc);
289 int help,
int highlight,
unsigned int w,
int columns)
291 const char *str = m->str;
292 const unsigned int namelen = m->namelen, secondlen = m->secondlen;
293 const char *desc = str + namelen + secondlen;
294 show_usage_part(str, namelen - 1, str + namelen, secondlen - 1, desc,
295 help, highlight, w, columns);
299ruby_show_usage_line(
const char *name,
const char *secondary,
const char *description,
300 int help,
int highlight,
unsigned int width,
int columns)
302 unsigned int namelen = (
unsigned int)strlen(name);
303 unsigned int secondlen = (secondary ? (
unsigned int)strlen(secondary) : 0);
304 show_usage_part(name, namelen, secondary, secondlen,
305 description, help, highlight, width, columns);
311usage(
const char *name,
int help,
int highlight,
int columns)
313#define M(shortopt, longopt, desc) RUBY_OPT_MESSAGE(shortopt, longopt, desc)
316# define DEFAULT_JIT_OPTION "--yjit"
318# define DEFAULT_JIT_OPTION "--zjit"
324 M(
"-0[octal]",
"",
"Set input record separator ($/):\n"
325 "-0 for \\0; -00 for paragraph mode; -0777 for slurp mode."),
326 M(
"-a",
"",
"Split each input line ($_) into fields ($F)."),
327 M(
"-c",
"",
"Check syntax (no execution)."),
328 M(
"-Cdirpath",
"",
"Execute program in specified directory."),
329 M(
"-d",
", --debug",
"Set debugging flag ($DEBUG) and $VERBOSE to true."),
330 M(
"-e 'code'",
"",
"Execute given Ruby code; multiple -e allowed."),
331 M(
"-Eex[:in]",
", --encoding=ex[:in]",
"Set default external and internal encodings."),
332 M(
"-Fpattern",
"",
"Set input field separator ($;); used with -a."),
333 M(
"-i[extension]",
"",
"Set ARGF in-place mode;\n"
334 "create backup files with given extension."),
335 M(
"-Idirpath",
"",
"Prepend specified directory to load paths ($LOAD_PATH);\n"
336 "relative paths are expanded; multiple -I are allowed."),
337 M(
"-l",
"",
"Set output record separator ($\\) to $/;\n"
338 "used for line-oriented output."),
339 M(
"-n",
"",
"Run program in gets loop."),
340 M(
"-p",
"",
"Like -n, with printing added."),
341 M(
"-rlibrary",
"",
"Require the given library."),
342 M(
"-s",
"",
"Define global variables using switches following program path."),
343 M(
"-S",
"",
"Search directories found in the PATH environment variable."),
344 M(
"-v",
"",
"Print version; set $VERBOSE to true."),
345 M(
"-w",
"",
"Synonym for -W1."),
346 M(
"-W[level=2|:category]",
"",
"Set warning flag ($-W):\n"
347 "0 for silent; 1 for moderate; 2 for verbose."),
348 M(
"-x[dirpath]",
"",
"Execute Ruby code starting from a #!ruby line."),
349#if USE_YJIT || USE_ZJIT
350 M(
"--jit",
"",
"Enable the default JIT for the build; same as " DEFAULT_JIT_OPTION
"."),
353 M(
"--yjit",
"",
"Enable in-process JIT compiler."),
356 M(
"--zjit",
"",
"Enable method-based JIT compiler."),
358 M(
"-h",
"",
"Print this help message; use --help for longer message."),
360 STATIC_ASSERT(usage_msg_size, numberof(usage_msg) < 26);
363 M(
"--backtrace-limit=num",
"",
"Set backtrace limit."),
364 M(
"--copyright",
"",
"Print Ruby copyright."),
365 M(
"--crash-report=template",
"",
"Set template for crash report file."),
366 M(
"--disable=features",
"",
"Disable features; see list below."),
367 M(
"--dump=items",
"",
"Dump items; see list below."),
368 M(
"--enable=features",
"",
"Enable features; see list below."),
369 M(
"--external-encoding=encoding",
"",
"Set default external encoding."),
370 M(
"--help",
"",
"Print long help message; use -h for short message."),
371 M(
"--internal-encoding=encoding",
"",
"Set default internal encoding."),
372 M(
"--parser=parser",
"",
"Set Ruby parser: parse.y or prism."),
373 M(
"--verbose",
"",
"Set $VERBOSE to true; ignore input from $stdin."),
374 M(
"--version",
"",
"Print Ruby version."),
375 M(
"-y",
", --yydebug",
"Print parser log; backward compatibility not guaranteed."),
378 M(
"insns",
"",
"Instruction sequences."),
379 M(
"yydebug",
"",
"yydebug of yacc parser generator."),
380 M(
"parsetree",
"",
"Abstract syntax tree (AST)."),
381 M(
"-optimize",
"",
"Disable optimization (affects insns)."),
382 M(
"+error-tolerant",
"",
"Error-tolerant parsing (affects yydebug, parsetree)."),
383 M(
"+comment",
"",
"Add comments to AST (affects parsetree with --parser=parse.y)."),
386 M(
"gems",
"",
"Rubygems (only for debugging, default: "DEFAULT_RUBYGEMS_ENABLED
")."),
387 M(
"error_highlight",
"",
"error_highlight (default: "DEFAULT_RUBYGEMS_ENABLED
")."),
388 M(
"did_you_mean",
"",
"did_you_mean (default: "DEFAULT_RUBYGEMS_ENABLED
")."),
389 M(
"syntax_suggest",
"",
"syntax_suggest (default: "DEFAULT_RUBYGEMS_ENABLED
")."),
390 M(
"rubyopt",
"",
"RUBYOPT environment variable (default: enabled)."),
391 M(
"frozen-string-literal",
"",
"Freeze all string literals (default: disabled)."),
393 M(
"yjit",
"",
"In-process JIT compiler (default: disabled)."),
396 M(
"zjit",
"",
"Method-based JIT compiler (default: disabled)."),
400 M(
"deprecated",
"",
"Deprecated features."),
401 M(
"experimental",
"",
"Experimental features."),
402 M(
"performance",
"",
"Performance issues."),
403 M(
"strict_unused_block",
"",
"Warning unused block strictly"),
406 const char *sb = highlight ? esc_standout+1 : esc_none;
407 const char *se = highlight ? esc_reset : esc_none;
408 const int num = numberof(usage_msg) - (help ? 1 : 0);
409 unsigned int w = (columns > 80 ? (columns - 79) / 2 : 0) + 16;
410#define SHOW(m) show_usage_line(&(m), help, highlight, w, columns)
412 printf(
"%sUsage:%s %s [options] [--] [filepath] [arguments]\n", sb, se, name);
413 for (i = 0; i < num; ++i)
418 if (highlight) sb = esc_standout;
420 for (i = 0; i < numberof(help_msg); ++i)
422 printf(
"%s""Dump List:%s\n", sb, se);
423 for (i = 0; i < numberof(dumps); ++i)
425 printf(
"%s""Features:%s\n", sb, se);
426 for (i = 0; i < numberof(features); ++i)
428 printf(
"%s""Warning categories:%s\n", sb, se);
429 for (i = 0; i < numberof(warn_categories); ++i)
430 SHOW(warn_categories[i]);
432 printf(
"%s""YJIT options:%s\n", sb, se);
433 rb_yjit_show_usage(help, highlight, w, columns);
436 printf(
"%s""ZJIT options:%s\n", sb, se);
437 extern void rb_zjit_show_usage(
int help,
int highlight,
unsigned int width,
int columns);
438 rb_zjit_show_usage(help, highlight, w, columns);
442#define rubylib_path_new rb_str_new
445ruby_push_include(
const char *path,
VALUE (*filter)(
VALUE))
449 VALUE load_path = rb_root_box()->load_path;
451 char rubylib[FILENAME_MAX];
453# define is_path_sep(c) ((c) == sep || (c) == ';')
455# define is_path_sep(c) ((c) == sep)
458 if (path == 0)
return;
462 while (is_path_sep(*p))
465 for (s = p; *s && !is_path_sep(*s); s = CharNext(s));
473 p = RSTRING_PTR(buf);
476 rb_str_resize(buf,
len);
477 p = strncpy(RSTRING_PTR(buf), p,
len);
480#ifdef HAVE_CYGWIN_CONV_PATH
481#define CONV_TO_POSIX_PATH(p, lib) \
482 cygwin_conv_path(CCP_WIN_A_TO_POSIX|CCP_RELATIVE, (p), (lib), sizeof(lib))
484# error no cygwin_conv_path
486 if (CONV_TO_POSIX_PATH(p, rubylib) == 0) {
497identical_path(
VALUE path)
503locale_path(
VALUE path)
512 ruby_push_include(path, locale_path);
516expand_include_path(
VALUE path)
518 char *p = RSTRING_PTR(path);
521 if (*p ==
'.' && p[1] ==
'/')
523 return rb_file_expand_path(path,
Qnil);
527ruby_incpush_expand(
const char *path)
529 ruby_push_include(path, expand_include_path);
533#if defined _WIN32 || defined __CYGWIN__
534static HMODULE libruby;
537DllMain(HINSTANCE dll, DWORD reason, LPVOID reserved)
539 if (reason == DLL_PROCESS_ATTACH)
545rb_libruby_handle(
void)
551translit_char_bin(
char *p,
int from,
int to)
554 if ((
unsigned char)*p == from)
563# define chdir rb_w32_uchdir
571# define IF_UTF8_PATH(t, f) t
573# define IF_UTF8_PATH(t, f) f
578str_conv_enc(
VALUE str, rb_encoding *from, rb_encoding *to)
585# define str_conv_enc(str, from, to) (str)
590#if defined(LOAD_RELATIVE)
592runtime_libruby_path(
void)
594#if defined _WIN32 || defined __CYGWIN__
602 while (wlibpath = (WCHAR *)RSTRING_PTR(wsopath),
603 ret = GetModuleFileNameW(libruby, wlibpath,
len),
609 if (!ret || ret >
len) rb_fatal(
"failed to get module file name");
610#if defined __CYGWIN__
612 const int win_to_posix = CCP_WIN_W_TO_POSIX | CCP_RELATIVE;
613 size_t newsize = cygwin_conv_path(win_to_posix, wlibpath, 0, 0);
614 if (!newsize) rb_fatal(
"failed to convert module path to cygwin");
616 libpath = RSTRING_PTR(path);
617 if (cygwin_conv_path(win_to_posix, wlibpath, libpath, newsize)) {
618 rb_str_resize(path, 0);
624 for (
len = ret, i = 0; i <
len; ++i) {
625 if (wlibpath[i] == L
'\\') {
631 len = WideCharToMultiByte(CP_UTF8, 0, wlibpath, ret, NULL, 0, NULL, NULL);
633 libpath = RSTRING_PTR(path);
634 WideCharToMultiByte(CP_UTF8, 0, wlibpath, ret, libpath,
len, NULL, NULL);
636 rb_str_resize(wsopath, 0);
638#elif defined(HAVE_DLADDR)
641 const void* addr = (
void *)(
VALUE)expand_include_path;
643 if (!dladdr((
void *)addr, &dli)) {
647 else if (origarg.argc > 0 && origarg.argv && dli.dli_fname == origarg.argv[0]) {
649 path = rb_readlink(fname, NULL);
654 path = rb_realpath_internal(
Qnil, fname, 1);
656 rb_str_resize(fname, 0);
659# error relative load path is not supported on this platform.
664#define INITIAL_LOAD_PATH_MARK rb_intern_const("@gem_prelude_index")
666VALUE ruby_archlibdir_path, ruby_prefix_path;
671 VALUE load_path, archlibdir = 0;
672 ID id_initial_load_path_mark;
673 const char *paths = ruby_initial_load_paths;
675#if defined LOAD_RELATIVE
676#if !defined ENABLE_MULTIARCH
677# define RUBY_ARCH_PATH ""
678#elif defined RUBY_ARCH
679# define RUBY_ARCH_PATH "/"RUBY_ARCH
681# define RUBY_ARCH_PATH "/"RUBY_PLATFORM
688 sopath = runtime_libruby_path();
689 libpath = RSTRING_PTR(sopath);
691 p = strrchr(libpath,
'/');
693 static const char libdir[] =
"/"
694#ifdef LIBDIR_BASENAME
700 const ptrdiff_t libdir_len = (ptrdiff_t)
sizeof(libdir)
702 static const char bindir[] =
"/bin";
703 const ptrdiff_t bindir_len = (ptrdiff_t)
sizeof(bindir) - 1;
705 const char *p2 = NULL;
707#ifdef ENABLE_MULTIARCH
710 if (p - libpath >= bindir_len && !
STRNCASECMP(p - bindir_len, bindir, bindir_len)) {
716 else if (p - libpath >= libdir_len && !strncmp(p - libdir_len, libdir, libdir_len)) {
717 archlibdir =
rb_str_subseq(sopath, 0, (p2 ? p2 : p) - libpath);
721#ifdef ENABLE_MULTIARCH
728 if (p)
goto multiarch;
732 baselen = p - libpath;
737 rb_str_resize(sopath, baselen);
738 libpath = RSTRING_PTR(sopath);
739#define PREFIX_PATH() sopath
740#define BASEPATH() rb_str_buf_cat(rb_str_buf_new(baselen+len), libpath, baselen)
741#define RUBY_RELATIVE(path, len) rb_str_buf_cat(BASEPATH(), (path), (len))
743 const size_t exec_prefix_len = strlen(ruby_exec_prefix);
744#define RUBY_RELATIVE(path, len) rubylib_path_new((path), (len))
745#define PREFIX_PATH() RUBY_RELATIVE(ruby_exec_prefix, exec_prefix_len)
747 rb_gc_register_address(&ruby_prefix_path);
748 ruby_prefix_path = PREFIX_PATH();
750 if (!archlibdir) archlibdir = ruby_prefix_path;
751 rb_gc_register_address(&ruby_archlibdir_path);
752 ruby_archlibdir_path = archlibdir;
754 load_path = rb_root_box()->load_path;
756 ruby_push_include(getenv(
"RUBYLIB"), identical_path);
758 id_initial_load_path_mark = INITIAL_LOAD_PATH_MARK;
760 size_t len = strlen(paths);
761 VALUE path = RUBY_RELATIVE(paths,
len);
762 rb_ivar_set(path, id_initial_load_path_mark, path);
770add_modules(
VALUE *req_list,
const char *mod)
772 VALUE list = *req_list;
783require_libraries(
VALUE *req_list)
785 VALUE list = *req_list;
786 VALUE self = rb_vm_top_self();
793 rb_enc_associate(feature, extenc);
796 rb_funcallv(self, require, 1, &feature);
802require_libraries_in_main_box(
VALUE *req_list)
804 const rb_box_t *main_box = rb_main_box();
805 VALUE list = *req_list;
812 rb_enc_associate(feature, extenc);
815 rb_funcallv(main_box->box_object, require, 1, &feature);
827process_sflag(
int sflag)
845 if (s[1] ==
'-' && s[2] ==
'\0')
850 for (p = s + 1; *p; p++) {
859 else if (*p !=
'_' && !
ISALNUM(*p)) {
862 rb_str_new2(
"invalid name for global variable - ");
863 if (!(p = strchr(p,
'='))) {
869 name_error[1] = args[-1];
875 for (p = s + 1; *p; ++p) {
891static long proc_options(
long argc,
char **argv, ruby_cmdline_options_t *opt,
int envopt);
894moreswitches(
const char *s, ruby_cmdline_options_t *opt,
int envopt)
899 VALUE argstr, argary;
902 VALUE src_enc_name = opt->src.enc.name;
903 VALUE ext_enc_name = opt->ext.enc.name;
904 VALUE int_enc_name = opt->intern.enc.name;
907 long backtrace_length_limit = opt->backtrace_length_limit;
908 const char *crash_report = opt->crash_report;
913 opt->src.enc.name = opt->ext.enc.name = opt->intern.enc.name = 0;
915 const int hyphen = *s !=
'-';
919 p = RSTRING_PTR(argstr);
920 if (hyphen) *p =
'-';
921 memcpy(p + hyphen, s,
len + 1);
927 while (*p && !
ISSPACE(*p)) ++p;
932 argc = RSTRING_LEN(argary) /
sizeof(ap);
938 MEMMOVE(argv, RSTRING_PTR(argary),
char *, argc);
940 while ((i = proc_options(argc, argv, opt, envopt)) > 1 && envopt && (argc -= i) > 0) {
952 opt->src.enc.name = src_enc_name;
955 opt->ext.enc.name = ext_enc_name;
958 opt->intern.enc.name = int_enc_name;
960 FEATURE_SET_RESTORE(opt->features, feat);
961 FEATURE_SET_RESTORE(opt->warn, warn);
962 if (BACKTRACE_LENGTH_LIMIT_VALID_P(backtrace_length_limit)) {
963 opt->backtrace_length_limit = backtrace_length_limit;
966 opt->crash_report = crash_report;
972 rb_str_resize(argary, 0);
973 rb_str_resize(argstr, 0);
977name_match_p(
const char *name,
const char *str,
size_t len)
979 if (
len == 0)
return 0;
981 while (
TOLOWER(*str) == *name) {
982 if (!--
len)
return 1;
986 if (*str !=
'-' && *str !=
'_')
return 0;
988 if (*name !=
'-' && *name !=
'_')
return 0;
989 if (!*++name)
return 1;
991 if (--
len == 0)
return 1;
995#define NAME_MATCH_P(name, str, len) \
996 ((len) < (int)sizeof(name) && name_match_p((name), (str), (len)))
998#define UNSET_WHEN(name, bit, str, len) \
999 if (NAME_MATCH_P((name), (str), (len))) { \
1000 *(unsigned int *)arg &= ~(bit); \
1004#define SET_WHEN(name, bit, str, len) \
1005 if (NAME_MATCH_P((name), (str), (len))) { \
1006 *(unsigned int *)arg |= (bit); \
1010#define LITERAL_NAME_ELEMENT(name) #name
1013feature_option(
const char *str,
int len,
void *arg,
const unsigned int enable)
1015 static const char list[] = EACH_FEATURES(LITERAL_NAME_ELEMENT,
", ");
1017 unsigned int mask = ~0
U;
1018 unsigned int set = 0
U;
1019#if AMBIGUOUS_FEATURE_NAMES
1021# define FEATURE_FOUND ++matched
1023# define FEATURE_FOUND goto found
1025#define SET_FEATURE(bit) \
1026 if (NAME_MATCH_P(#bit, str, len)) {set |= mask = FEATURE_BIT(bit); FEATURE_FOUND;}
1027 EACH_FEATURES(SET_FEATURE, ;);
1028 if (NAME_MATCH_P(
"jit", str,
len)) {
1029 set |= mask = FEATURE_BIT(jit);
1032 if (NAME_MATCH_P(
"all", str,
len)) {
1034 mask &= ~feature_jit_mask | FEATURE_BIT(jit);
1037#if AMBIGUOUS_FEATURE_NAMES
1038 if (matched == 1)
goto found;
1040 VALUE mesg = rb_sprintf(
"ambiguous feature: '%.*s' (",
len, str);
1041#define ADD_FEATURE_NAME(bit) \
1042 if (FEATURE_BIT(bit) & set) { \
1043 rb_str_cat_cstr(mesg, #bit); \
1044 if (--matched) rb_str_cat_cstr(mesg, ", "); \
1046 EACH_FEATURES(ADD_FEATURE_NAME, ;);
1049#undef ADD_FEATURE_NAME
1054 rb_warn(
"unknown argument for --%s: '%.*s'",
1055 enable ?
"enable" :
"disable",
len, str);
1056 rb_warn(
"features are [%.*s].", (
int)strlen(list), list);
1060 FEATURE_SET_TO(*argp, mask, (mask & enable));
1061 if (NAME_MATCH_P(
"frozen_string_literal", str,
len)) {
1062 FEATURE_SET_TO(*argp, FEATURE_BIT(frozen_string_literal_set), FEATURE_BIT(frozen_string_literal_set));
1068enable_option(
const char *str,
int len,
void *arg)
1070 feature_option(str,
len, arg, ~0
U);
1074disable_option(
const char *str,
int len,
void *arg)
1076 feature_option(str,
len, arg, 0
U);
1080int ruby_env_debug_option(
const char *str,
int len,
void *arg);
1083debug_option(
const char *str,
int len,
void *arg)
1085 static const char list[] = EACH_DEBUG_FEATURES(LITERAL_NAME_ELEMENT,
", ");
1087#define SET_WHEN_DEBUG(bit) \
1088 if (NAME_MATCH_P(#bit, str, len)) { \
1089 FEATURE_SET(*argp, DEBUG_BIT(bit)); \
1092 EACH_DEBUG_FEATURES(SET_WHEN_DEBUG, ;);
1096 rb_warn(
"unknown argument for --debug: '%.*s'",
len, str);
1097 rb_warn(
"debug features are [%.*s].", (
int)strlen(list), list);
1101memtermspn(
const char *str,
char term,
int len)
1104 if (
len <= 0)
return 0;
1105 const char *next = memchr(str, term,
len);
1106 return next ? (int)(next - str) :
len;
1109static const char additional_opt_sep =
'+';
1112dump_additional_option_flag(
const char *str,
int len,
unsigned int bits,
bool set)
1114#define SET_DUMP_OPT(bit) if (NAME_MATCH_P(#bit, str, len)) { \
1115 return set ? (bits | DUMP_BIT(opt_ ## bit)) : (bits & ~DUMP_BIT(opt_ ## bit)); \
1117 SET_DUMP_OPT(error_tolerant);
1118 SET_DUMP_OPT(comment);
1119 SET_DUMP_OPT(optimize);
1121 rb_warn(
"don't know how to dump with%s '%.*s'", set ?
"" :
"out",
len, str);
1126dump_additional_option(
const char *str,
int len,
unsigned int bits)
1129 for (;
len-- > 0 && *str++ == additional_opt_sep;
len -= w, str += w) {
1130 w = memtermspn(str, additional_opt_sep,
len);
1132 if (*str ==
'-' || *str ==
'+') {
1133 set = *str++ ==
'+';
1137 int n = memtermspn(str,
'-', w);
1138 if (str[n] ==
'-') {
1139 if (NAME_MATCH_P(
"with", str, n)) {
1143 else if (NAME_MATCH_P(
"without", str, n)) {
1150 bits = dump_additional_option_flag(str, w, bits, set);
1156dump_option(
const char *str,
int len,
void *arg)
1158 static const char list[] = EACH_DUMPS(LITERAL_NAME_ELEMENT,
", ");
1159 unsigned int *bits_ptr = (
unsigned int *)arg;
1160 if (*str ==
'+' || *str ==
'-') {
1161 bool set = *str++ ==
'+';
1162 *bits_ptr = dump_additional_option_flag(str, --
len, *bits_ptr, set);
1165 int w = memtermspn(str, additional_opt_sep,
len);
1167#define SET_WHEN_DUMP(bit) \
1168 if (NAME_MATCH_P(#bit "-", (str), (w))) { \
1169 *bits_ptr = dump_additional_option(str + w, len - w, *bits_ptr | DUMP_BIT(bit)); \
1172 EACH_DUMPS(SET_WHEN_DUMP, ;);
1173 rb_warn(
"don't know how to dump '%.*s',",
len, str);
1174 rb_warn(
"but only [%.*s].", (
int)strlen(list), list);
1178set_option_encoding_once(
const char *
type,
VALUE *name,
const char *e,
long elen)
1182 if (!elen) elen = strlen(e);
1188 "%s already set to %"PRIsVALUE,
type, *name);
1193#define set_internal_encoding_once(opt, e, elen) \
1194 set_option_encoding_once("default_internal", &(opt)->intern.enc.name, (e), (elen))
1195#define set_external_encoding_once(opt, e, elen) \
1196 set_option_encoding_once("default_external", &(opt)->ext.enc.name, (e), (elen))
1197#define set_source_encoding_once(opt, e, elen) \
1198 set_option_encoding_once("source", &(opt)->src.enc.name, (e), (elen))
1200#define yjit_opt_match_noarg(s, l, name) \
1201 opt_match(s, l, name) && (*(s) ? (rb_warn("argument to --yjit-" name " is ignored"), 1) : 1)
1202#define yjit_opt_match_arg(s, l, name) \
1203 opt_match(s, l, name) && (*(s) && *(s+1) ? 1 : (rb_raise(rb_eRuntimeError, "--yjit-" name " needs an argument"), 0))
1207setup_yjit_options(
const char *s)
1210 bool rb_yjit_parse_option(
const char* s);
1211 bool success = rb_yjit_parse_option(s);
1219 "invalid YJIT option '%s' (--help will show valid yjit options)",
1227setup_zjit_options(
const char *s)
1230 extern bool rb_zjit_parse_option(
const char *s);
1232 if (!rb_zjit_parse_option(s)) {
1233 rb_raise(
rb_eRuntimeError,
"invalid ZJIT option '%s' (--help will show valid zjit options)", s);
1252proc_W_option(ruby_cmdline_options_t *opt,
const char *s,
int *warning)
1255 unsigned int bits = 0;
1256 static const char no_prefix[] =
"no-";
1257 int enable = strncmp(s += 2, no_prefix,
sizeof(no_prefix)-1) != 0;
1258 if (!enable) s +=
sizeof(no_prefix)-1;
1259 size_t len = strlen(s);
1260 if (NAME_MATCH_P(
"deprecated", s,
len)) {
1263 else if (NAME_MATCH_P(
"experimental", s,
len)) {
1266 else if (NAME_MATCH_P(
"performance", s,
len)) {
1269 else if (NAME_MATCH_P(
"strict_unused_block", s,
len)) {
1273 rb_warn(
"unknown warning category: '%s'", s);
1275 if (bits) FEATURE_SET_TO(opt->warn, bits, enable ? bits : 0);
1288 if (!opt->warning) {
1304 FEATURE_SET_TO(opt->warn, RB_WARN_CATEGORY_DEFAULT_BITS, 0);
1310 FEATURE_SET(opt->warn, RB_WARN_CATEGORY_DEFAULT_BITS);
1319proc_e_option(ruby_cmdline_options_t *opt,
const char *s,
long argc,
char **argv)
1329 if (!opt->e_script) {
1331 if (opt->script == 0)
1341proc_K_option(ruby_cmdline_options_t *opt,
const char *s)
1344 const char *enc_name = 0;
1347 enc_name =
"EUC-JP";
1350 enc_name =
"Windows-31J";
1355 case 'N':
case 'n':
case 'A':
case 'a':
1356 enc_name =
"ASCII-8BIT";
1361 if (!opt->ext.enc.name)
1362 opt->ext.enc.name = opt->src.enc.name;
1371proc_0_option(ruby_cmdline_options_t *opt,
const char *s)
1381 else if (v == 0 && numlen >= 2) {
1382 rb_rs = rb_fstring_lit(
"");
1393proc_encoding_option(ruby_cmdline_options_t *opt,
const char *s,
const char *opt_name)
1396# define set_encoding_part(type) \
1397 if (!(p = strchr(s, ':'))) { \
1398 set_##type##_encoding_once(opt, s, 0); \
1402 set_##type##_encoding_once(opt, s, p-s); \
1404 set_encoding_part(external);
1405 if (!*(s = ++p))
return;
1406 set_encoding_part(internal);
1407 if (!*(s = ++p))
return;
1408#if defined ALLOW_DEFAULT_SOURCE_ENCODING && ALLOW_DEFAULT_SOURCE_ENCODING
1409 set_encoding_part(source);
1410 if (!*(s = ++p))
return;
1413# undef set_encoding_part
1418proc_long_options(ruby_cmdline_options_t *opt,
const char *s,
long argc,
char **argv,
int envopt)
1422# define is_option_end(c, allow_hyphen) \
1423 (!(c) || ((allow_hyphen) && (c) == '-') || (c) == '=')
1424# define check_envopt(name, allow_envopt) \
1425 (((allow_envopt) || !envopt) ? (void)0 : \
1426 rb_raise(rb_eRuntimeError, "invalid switch in RUBYOPT: --" name))
1427# define need_argument(name, s, needs_arg, next_arg) \
1428 ((*(s) ? !*++(s) : (next_arg) && (argc <= 1 || !((s) = argv[1]) || (--argc, ++argv, 0))) && (needs_arg) ? \
1429 rb_raise(rb_eRuntimeError, "missing argument for --" name) \
1431# define is_option_with_arg(name, allow_hyphen, allow_envopt) \
1432 is_option_with_optarg(name, allow_hyphen, allow_envopt, Qtrue, Qtrue)
1433# define is_option_with_optarg(name, allow_hyphen, allow_envopt, needs_arg, next_arg) \
1434 (strncmp((name), s, n = sizeof(name) - 1) == 0 && is_option_end(s[n], (allow_hyphen)) && \
1435 (s[n] != '-' || (s[n] && s[n+1])) ? \
1436 (check_envopt(name, (allow_envopt)), s += n, \
1437 need_argument(name, s, needs_arg, next_arg), 1) : 0)
1439 if (strcmp(
"copyright", s) == 0) {
1440 if (envopt)
goto noenvopt_long;
1441 opt->dump |= DUMP_BIT(copyright);
1452 else if (is_option_with_arg(
"enable",
Qtrue,
Qtrue)) {
1455 else if (is_option_with_arg(
"disable",
Qtrue,
Qtrue)) {
1458 else if (is_option_with_arg(
"encoding",
Qfalse,
Qtrue)) {
1459 proc_encoding_option(opt, s,
"--encoding");
1461 else if (is_option_with_arg(
"internal-encoding",
Qfalse,
Qtrue)) {
1462 set_internal_encoding_once(opt, s, 0);
1464 else if (is_option_with_arg(
"external-encoding",
Qfalse,
Qtrue)) {
1465 set_external_encoding_once(opt, s, 0);
1467 else if (is_option_with_arg(
"parser",
Qfalse,
Qtrue)) {
1468 if (strcmp(
"prism", s) == 0) {
1469 rb_ruby_default_parser_set(RB_DEFAULT_PARSER_PRISM);
1471 else if (strcmp(
"parse.y", s) == 0) {
1472 rb_ruby_default_parser_set(RB_DEFAULT_PARSER_PARSE_Y);
1478#if defined ALLOW_DEFAULT_SOURCE_ENCODING && ALLOW_DEFAULT_SOURCE_ENCODING
1479 else if (is_option_with_arg(
"source-encoding",
Qfalse,
Qtrue)) {
1480 set_source_encoding_once(opt, s, 0);
1483 else if (strcmp(
"version", s) == 0) {
1484 if (envopt)
goto noenvopt_long;
1485 opt->dump |= DUMP_BIT(version);
1487 else if (strcmp(
"verbose", s) == 0) {
1491 else if (strcmp(
"jit", s) == 0) {
1492#if USE_YJIT || USE_ZJIT
1493 FEATURE_SET(opt->features, FEATURE_BIT(jit));
1495 rb_warn(
"Ruby was built without JIT support");
1498 else if (is_option_with_optarg(
"yjit",
'-',
true,
false,
false)) {
1500 FEATURE_SET(opt->features, FEATURE_BIT(yjit));
1501 setup_yjit_options(s);
1503 rb_warn(
"Ruby was built without YJIT support."
1504 " You may need to install rustc to build Ruby with YJIT.");
1507 else if (is_option_with_optarg(
"zjit",
'-',
true,
false,
false)) {
1509 FEATURE_SET(opt->features, FEATURE_BIT(zjit));
1510 setup_zjit_options(s);
1512 rb_warn(
"Ruby was built without ZJIT support."
1513 " You may need to install rustc to build Ruby with ZJIT.");
1516 else if (strcmp(
"yydebug", s) == 0) {
1517 if (envopt)
goto noenvopt_long;
1518 opt->dump |= DUMP_BIT(yydebug);
1523 else if (strcmp(
"help", s) == 0) {
1524 if (envopt)
goto noenvopt_long;
1525 opt->dump |= DUMP_BIT(help);
1528 else if (is_option_with_arg(
"backtrace-limit",
Qfalse,
Qtrue)) {
1530 long n = strtol(s, &e, 10);
1531 if (
errno == ERANGE || !BACKTRACE_LENGTH_LIMIT_VALID_P(n) || *e) {
1535 opt->backtrace_length_limit = n;
1538 else if (is_option_with_arg(
"crash-report",
true,
true)) {
1539 opt->crash_report = s;
1543 "invalid option --%s (-h will show valid options)", s);
1545 return argc0 - argc + 1;
1549# undef is_option_end
1551# undef need_argument
1552# undef is_option_with_arg
1553# undef is_option_with_optarg
1558proc_options(
long argc,
char **argv, ruby_cmdline_options_t *opt,
int envopt)
1560 long n, argc0 = argc;
1562 int warning = opt->warning;
1564 if (argc <= 0 || !argv)
1567 for (argc--, argv++; argc > 0; argc--, argv++) {
1568 const char *
const arg = argv[0];
1569 if (!arg || arg[0] !=
'-' || !arg[1])
1576 if (envopt)
goto noenvopt;
1577 opt->do_split = TRUE;
1582 if (envopt)
goto noenvopt;
1583 opt->do_print = TRUE;
1586 if (envopt)
goto noenvopt;
1587 opt->do_loop = TRUE;
1598 if (envopt)
goto noenvopt;
1599 opt->dump |= DUMP_BIT(yydebug);
1608 opt->dump |= DUMP_BIT(version_v);
1611 if (!opt->warning) {
1615 FEATURE_SET(opt->warn, RB_WARN_CATEGORY_DEFAULT_BITS);
1620 if (!(s = proc_W_option(opt, s, &warning)))
break;
1624 if (envopt)
goto noenvopt;
1625 opt->dump |= DUMP_BIT(syntax);
1630 if (envopt)
goto noenvopt;
1632 if (!opt->sflag) opt->sflag = 1;
1637 if (envopt)
goto noenvopt;
1638 opt->dump |= DUMP_BIT(usage);
1642 if (envopt)
goto noenvopt;
1643 opt->do_line = TRUE;
1649 if (envopt)
goto noenvopt;
1651 opt->do_search = TRUE;
1656 if (envopt)
goto noenvopt;
1657 if (!(n = proc_e_option(opt, s, argc, argv)))
break;
1666 add_modules(&opt->req_list, s);
1668 else if (argc > 1) {
1669 add_modules(&opt->req_list, argv[1]);
1675 if (envopt)
goto noenvopt;
1677 ruby_set_inplace_mode(s + 1);
1681 if (envopt)
goto noenvopt;
1685 if (*s && chdir(s) < 0) {
1686 rb_fatal(
"Can't chdir to %s", s);
1692 if (envopt)
goto noenvopt;
1693 if (!*++s && (!--argc || !(s = *++argv) || !*s)) {
1694 rb_fatal(
"Can't chdir");
1697 rb_fatal(
"Can't chdir to %s", s);
1702 if (envopt)
goto noenvopt;
1709 if (!*++s && (!--argc || !(s = *++argv))) {
1712 proc_encoding_option(opt, s,
"-E");
1716 set_internal_encoding_once(opt,
"UTF-8", 0);
1721 if (!(s = proc_K_option(opt, s)))
break;
1727 ruby_incpush_expand(s);
1728 else if (argc > 1) {
1729 ruby_incpush_expand(argv[1]);
1735 if (envopt)
goto noenvopt;
1736 if (!(s = proc_0_option(opt, s)))
break;
1740 if (!s[1] || (s[1] ==
'\r' && !s[2])) {
1746 if (!(n = proc_long_options(opt, s, argc, argv, envopt)))
goto switch_end;
1758 const char *e = s + strlen(s);
1759 int r = rb_enc_precise_mbclen(s, e, enc);
1760 unsigned int c = (
unsigned char)*s;
1762 c = rb_enc_mbc_to_codepoint(s, e, enc);
1763 if (ONIGENC_IS_CODE_GRAPH(enc, c) ||
1764 ((s = ruby_escaped_char(c)) != 0 &&
1765 (r = (
int)strlen(s), 1))) {
1767 "invalid option -%.*s (-h will show valid options)",
1772 "invalid option -\\x%.2x (-h will show valid options)",
1789 if (warning) opt->warning = warning;
1790 return argc0 - argc;
1794void Init_builtin_features(
void);
1797ruby_init_prelude(
void)
1799 Init_builtin_features();
1802void rb_call_builtin_inits(
void);
1806#if RBIMPL_HAS_ATTRIBUTE(weak)
1810Init_extra_exts(
void)
1815ruby_opt_init(ruby_cmdline_options_t *opt)
1817 rb_warning_category_update(opt->warn.mask, opt->warn.set);
1819 if (opt->dump & dump_exit_bits)
return;
1823 if (getenv(
"RUBY_GC_HEAP_INIT_SLOTS")) {
1824 rb_warn_deprecated(
"The environment variable RUBY_GC_HEAP_INIT_SLOTS",
1825 "environment variables RUBY_GC_HEAP_%d_INIT_SLOTS");
1831 GET_VM()->running = 0;
1832 rb_call_builtin_inits();
1833 GET_VM()->running = 1;
1834 memset(ruby_vm_redefined_flag, 0,
sizeof(ruby_vm_redefined_flag));
1839 rb_yjit_init_builtin_cmes();
1842 extern void rb_zjit_init_builtin_cmes(
void);
1843 rb_zjit_init_builtin_cmes();
1850 if (rb_box_available()) {
1851 rb_initialize_mandatory_boxes();
1856 if (FEATURE_SET_P(opt->features, gems)) {
1857 rb_box_gem_flags_t gem_flags = {
1858 .gem = FEATURE_SET_P(opt->features, gems),
1859 .error_highlight = opt->features.set & FEATURE_BIT(error_highlight),
1860 .did_you_mean = opt->features.set & FEATURE_BIT(did_you_mean),
1861 .syntax_suggest = opt->features.set & FEATURE_BIT(syntax_suggest)
1864 if (rb_box_available()) {
1865 rb_vm_call_cfunc_in_box(
Qnil, rb_define_gem_modules, (
VALUE)&gem_flags,
Qnil,
1867 rb_vm_call_cfunc_in_box(
Qnil, rb_define_gem_modules, (
VALUE)&gem_flags,
Qnil,
1870 rb_box_set_gem_flags(&gem_flags);
1873 rb_define_gem_modules((
VALUE)&gem_flags,
Qnil);
1879 ruby_init_prelude();
1883 rb_yjit_init(opt->yjit);
1886 extern void rb_zjit_init(
bool);
1887 rb_zjit_init(opt->zjit);
1891 if (rb_box_available()) {
1892 require_libraries_in_main_box(&opt->req_list);
1895 require_libraries(&opt->req_list);
1900opt_enc_index(
VALUE enc_name)
1902 const char *s = RSTRING_PTR(enc_name);
1903 int i = rb_enc_find_index(s);
1908 else if (rb_enc_dummy_p(rb_enc_from_index(i))) {
1914#define rb_progname (GET_VM()->progname)
1915#define rb_orig_progname (GET_VM()->orig_progname)
1931#define rb_define_readonly_boolean(name, val) \
1932 rb_define_virtual_variable((name), (val) ? true_value : false_value, 0)
1941 rb_raise(
rb_eTypeError,
"$_ value need to be String (%s given)",
2023setup_pager_env(
void)
2025 if (!getenv(
"LESS")) {
2027 ruby_setenv(
"LESS",
"-R +/^[A-Z].*");
2035 HANDLE h = GetStdHandle(STD_OUTPUT_HANDLE);
2037 if (!GetConsoleMode(h, &m))
return 0;
2038# ifndef ENABLE_VIRTUAL_TERMINAL_PROCESSING
2039# define ENABLE_VIRTUAL_TERMINAL_PROCESSING 0x4
2041 if (!(m & ENABLE_VIRTUAL_TERMINAL_PROCESSING))
return 0;
2044#elif !defined(HAVE_WORKING_FORK)
2045# define tty_enabled() 0
2049copy_str(
VALUE str, rb_encoding *enc,
bool intern)
2054 return rb_enc_associate(
rb_str_dup(str), enc);
2059#if USE_YJIT || USE_ZJIT
2062env_var_truthy(
const char *name)
2064 const char *value = getenv(name);
2068 if (strcmp(value,
"1") == 0)
2070 if (strcmp(value,
"true") == 0)
2072 if (strcmp(value,
"yes") == 0)
2079rb_pid_t rb_fork_ruby(
int *status);
2082show_help(
const char *progname,
int help)
2084 int tty = isatty(1);
2087 const char *pager_env = getenv(
"RUBY_PAGER");
2088 if (!pager_env) pager_env = getenv(
"PAGER");
2089 if (pager_env && *pager_env && isatty(0)) {
2090 const char *columns_env = getenv(
"COLUMNS");
2091 if (columns_env) columns = atoi(columns_env);
2093#ifdef HAVE_WORKING_FORK
2096 rb_pid_t pid = rb_fork_ruby(NULL);
2101 else if (pid == 0) {
2119 int oldout = dup(1);
2120 int olderr = dup(2);
2121 int fd =
RFILE(port)->fptr->fd;
2122 tty = tty_enabled();
2125 usage(progname, 1, tty, columns);
2135 usage(progname, help, tty, columns);
2139process_script(ruby_cmdline_options_t *opt)
2143 VALUE parser = rb_parser_new();
2144 const unsigned int dump = opt->dump;
2146 if (dump & DUMP_BIT(yydebug)) {
2147 rb_parser_set_yydebug(parser,
Qtrue);
2150 if ((dump & dump_exit_bits) && (dump & DUMP_BIT(opt_error_tolerant))) {
2151 rb_parser_error_tolerant(parser);
2154 if (opt->e_script) {
2155 VALUE progname = rb_progname;
2156 rb_parser_set_context(parser, 0, TRUE);
2160 rb_parser_set_options(parser, opt->do_print, opt->do_loop,
2161 opt->do_line, opt->do_split);
2162 ast_value = rb_parser_compile_string(parser, opt->script, opt->e_script, 1);
2166 int xflag = opt->xflag;
2167 f = open_load_file(opt->script_name, &xflag);
2168 opt->xflag = xflag != 0;
2169 rb_parser_set_context(parser, 0, f ==
rb_stdin);
2170 ast_value = load_file(parser, opt->script_name, f, 1, opt);
2172 ast = rb_ruby_ast_data_get(ast_value);
2173 if (!ast->body.root) {
2174 rb_ast_dispose(ast);
2181prism_script_command_line(ruby_cmdline_options_t *opt)
2183 uint8_t command_line = 0;
2189 return command_line;
2193prism_script_shebang_callback(
pm_options_t *options,
const uint8_t *source,
size_t length,
void *data)
2195 ruby_cmdline_options_t *opt = (ruby_cmdline_options_t *) data;
2198 char *switches = malloc(length + 1);
2199 memcpy(switches, source, length);
2200 switches[length] =
'\0';
2202 int no_src_enc = !opt->src.enc.name;
2203 int no_ext_enc = !opt->ext.enc.name;
2204 int no_int_enc = !opt->intern.enc.name;
2206 moreswitches(switches, opt, 0);
2209 pm_options_command_line_set(options, prism_script_command_line(opt));
2211 if (no_src_enc && opt->src.enc.name) {
2212 opt->src.enc.index = opt_enc_index(opt->src.enc.name);
2215 if (no_ext_enc && opt->ext.enc.name) {
2216 opt->ext.enc.index = opt_enc_index(opt->ext.enc.name);
2218 if (no_int_enc && opt->intern.enc.name) {
2219 opt->intern.enc.index = opt_enc_index(opt->intern.enc.name);
2233 pm_options_line_set(options, 1);
2234 pm_options_main_script_set(options,
true);
2236 const bool read_stdin = (strcmp(opt->script,
"-") == 0);
2241 if (opt->src.enc.name != 0) {
2245 uint8_t command_line = prism_script_command_line(opt);
2249 pm_options_command_line_set(options, command_line);
2250 pm_options_filepath_set(options,
"-");
2251 pm_options_shebang_callback_set(options, prism_script_shebang_callback, (
void *) opt);
2254 error = pm_parse_stdin(result);
2263 else if (opt->e_script) {
2265 pm_options_command_line_set(options, command_line);
2268 result->
node.coverage_enabled = 0;
2269 error = pm_parse_string(result, opt->e_script,
rb_str_new2(
"-e"), NULL);
2272 VALUE script_name = rb_str_encode_ospath(opt->script_name);
2274 pm_options_command_line_set(options, command_line);
2275 pm_options_shebang_callback_set(options, prism_script_shebang_callback, (
void *) opt);
2277 error = pm_load_file(result, script_name,
true);
2284 error = pm_parse_file(result, opt->script_name, NULL);
2289 if (
RTEST(rb_get_coverages())) {
2290 result->
node.coverage_enabled = 1;
2297 int xflag = opt->xflag;
2298 VALUE file = open_load_file(script_name, &xflag);
2303 if ((parser->
start + offset < parser->end) && parser->
start[offset] ==
'\r') offset++;
2304 if ((parser->
start + offset < parser->end) && parser->
start[offset] ==
'\n') offset++;
2311 if (!
NIL_P(error)) {
2312 pm_parse_result_free(result);
2322 pm_prettyprint(&output_buffer, &result->
parser, result->
node.ast_node);
2324 pm_buffer_free(&output_buffer);
2329process_options_global_setup(
const ruby_cmdline_options_t *opt,
const rb_iseq_t *iseq)
2331 if (OPT_BACKTRACE_LENGTH_LIMIT_VALID_P(opt)) {
2332 rb_backtrace_length_limit = opt->backtrace_length_limit;
2342 rb_define_readonly_boolean(
"$-p", opt->do_print);
2343 rb_define_readonly_boolean(
"$-l", opt->do_line);
2344 rb_define_readonly_boolean(
"$-a", opt->do_split);
2346 rb_gvar_ractor_local(
"$-p");
2347 rb_gvar_ractor_local(
"$-l");
2348 rb_gvar_ractor_local(
"$-a");
2350 if ((rb_e_script = opt->e_script) != 0) {
2352 rb_vm_register_global_object(opt->e_script);
2355 rb_execution_context_t *ec = GET_EC();
2356 VALUE script = (opt->e_script ? opt->e_script :
Qnil);
2357 rb_exec_event_hook_script_compiled(ec, iseq, script);
2361process_options(
int argc,
char **argv, ruby_cmdline_options_t *opt)
2366 pm_parse_result_t prism;
2368#define dispose_result() \
2369 (result.ast ? rb_ast_dispose(result.ast) : pm_parse_result_free(&result.prism))
2371 const rb_iseq_t *iseq;
2372 rb_encoding *enc, *lenc;
2374 rb_encoding *ienc = 0;
2378 char fbuf[MAXPATHLEN];
2379 int i = (int)proc_options(argc, argv, opt, 0);
2380 unsigned int dump = opt->dump & dump_exit_bits;
2381 const rb_box_t *box = rb_root_box();
2382 const long loaded_before_enc =
RARRAY_LEN(box->loaded_features);
2384 if (opt->dump & (DUMP_BIT(usage)|DUMP_BIT(help))) {
2385 const char *
const progname =
2386 (argc > 0 && argv && argv[0] ? argv[0] :
2387 origarg.argc > 0 && origarg.argv && origarg.argv[0] ? origarg.argv[0] :
2389 show_help(progname, (opt->dump & DUMP_BIT(help)));
2396 if (FEATURE_SET_P(opt->features, rubyopt) && (s = getenv(
"RUBYOPT"))) {
2397 moreswitches(s, opt, 1);
2400 if (opt->src.enc.name)
2404 rb_warning(
"-K is specified; it is for 1.8 compatibility and may cause odd behavior");
2406 if (!(FEATURE_SET_BITS(opt->features) & feature_jit_mask)) {
2408 if (!FEATURE_USED_P(opt->features, yjit) && env_var_truthy(
"RUBY_YJIT_ENABLE")) {
2409 FEATURE_SET(opt->features, FEATURE_BIT(yjit));
2413 if (!FEATURE_USED_P(opt->features, zjit) && env_var_truthy(
"RUBY_ZJIT_ENABLE")) {
2414 FEATURE_SET(opt->features, FEATURE_BIT(zjit));
2419 extern void rb_zjit_prepare_options();
2420 rb_zjit_prepare_options();
2424 if (MULTI_BITS_P(FEATURE_SET_BITS(opt->features) & feature_jit_mask)) {
2425 rb_warn(
"Only one JIT can be enabled at the same time. Exiting");
2430 if (FEATURE_SET_P(opt->features, yjit)) {
2431 bool rb_yjit_option_disable(
void);
2432 opt->yjit = !rb_yjit_option_disable();
2436 if (FEATURE_SET_P(opt->features, zjit)) {
2437 bool rb_zjit_option_enable(
void);
2438 opt->zjit = rb_zjit_option_enable();
2442 ruby_mn_threads_params();
2443 Init_ruby_description(opt);
2445 if (opt->dump & (DUMP_BIT(version) | DUMP_BIT(version_v))) {
2447 if (opt->dump & DUMP_BIT(version))
return Qtrue;
2449 if (opt->dump & DUMP_BIT(copyright)) {
2454 if (!opt->e_script) {
2461 opt->script = argv[0];
2462 if (!opt->script || opt->script[0] ==
'\0') {
2465 else if (opt->do_search) {
2466 const char *path = getenv(
"RUBYPATH");
2470 opt->script = dln_find_file_r(argv[0], path, fbuf,
sizeof(fbuf));
2473 opt->script = dln_find_file_r(argv[0], getenv(
PATH_ENV), fbuf,
sizeof(fbuf));
2476 opt->script = argv[0];
2481 if (opt->script[0] ==
'-' && !opt->script[1]) {
2482 forbid_setid(
"program input from stdin");
2487 opt->script = RSTRING_PTR(opt->script_name);
2490 translit_char_bin(RSTRING_PTR(opt->script_name),
'\\',
'/');
2493 ruby_gc_set_params();
2498 rb_enc_associate(rb_progname, lenc);
2500 if (opt->ext.enc.name != 0) {
2501 opt->ext.enc.index = opt_enc_index(opt->ext.enc.name);
2503 if (opt->intern.enc.name != 0) {
2504 opt->intern.enc.index = opt_enc_index(opt->intern.enc.name);
2506 if (opt->src.enc.name != 0) {
2507 opt->src.enc.index = opt_enc_index(opt->src.enc.name);
2508 src_encoding_index = opt->src.enc.index;
2510 if (opt->ext.enc.index >= 0) {
2511 enc = rb_enc_from_index(opt->ext.enc.index);
2514 enc = IF_UTF8_PATH(uenc, lenc);
2516 rb_enc_set_default_external(rb_enc_from_encoding(enc));
2517 if (opt->intern.enc.index >= 0) {
2518 enc = rb_enc_from_index(opt->intern.enc.index);
2519 rb_enc_set_default_internal(rb_enc_from_encoding(enc));
2520 opt->intern.enc.index = -1;
2525 rb_enc_associate(opt->script_name, IF_UTF8_PATH(uenc, lenc));
2528 opt->script_name = str_conv_enc(opt->script_name, uenc, lenc);
2529 opt->script = RSTRING_PTR(opt->script_name);
2533 if (IF_UTF8_PATH(uenc != lenc, 1)) {
2535 VALUE load_path = box->load_path;
2536 const ID id_initial_load_path_mark = INITIAL_LOAD_PATH_MARK;
2537 int modifiable = FALSE;
2539 rb_get_expanded_load_path();
2540 for (i = 0; i <
RARRAY_LEN(load_path); ++i) {
2542 int mark = rb_attr_get(path, id_initial_load_path_mark) == path;
2545 if (newpath == path)
continue;
2548 if (!(path = copy_str(path, lenc, !mark)))
continue;
2550 if (mark)
rb_ivar_set(path, id_initial_load_path_mark, path);
2562 VALUE loaded_features = box->loaded_features;
2563 bool modified =
false;
2564 for (
long i = loaded_before_enc; i <
RARRAY_LEN(loaded_features); ++i) {
2566 if (!(path = copy_str(path, IF_UTF8_PATH(uenc, lenc),
true)))
continue;
2578 if (opt->features.mask & COMPILATION_FEATURES) {
2580#define SET_COMPILE_OPTION(h, o, name) \
2581 rb_hash_aset((h), ID2SYM(rb_intern_const(#name)), \
2582 RBOOL(FEATURE_SET_P(o->features, name)))
2584 if (FEATURE_SET_P(opt->features, frozen_string_literal_set)) {
2585 SET_COMPILE_OPTION(option, opt, frozen_string_literal);
2587 SET_COMPILE_OPTION(option, opt, debug_frozen_string_literal);
2588 rb_funcallv(rb_cISeq,
rb_intern_const(
"compile_option="), 1, &option);
2589#undef SET_COMPILE_OPTION
2592 opt->sflag = process_sflag(opt->sflag);
2594 if (opt->e_script) {
2596 if (opt->src.enc.index >= 0) {
2597 eenc = rb_enc_from_index(opt->src.enc.index);
2602 if (ienc) eenc = ienc;
2607 opt->e_script = str_conv_enc(opt->e_script, uenc, eenc);
2610 rb_enc_associate(opt->e_script, eenc);
2613 if (!rb_ruby_prism_p()) {
2614 ast_value = process_script(opt);
2615 if (!(result.ast = rb_ruby_ast_data_get(ast_value)))
return Qfalse;
2618 prism_script(opt, &result.prism);
2621 if ((dump & DUMP_BIT(yydebug)) && !(dump &= ~DUMP_BIT(yydebug))) {
2626 if (opt->ext.enc.index >= 0) {
2627 enc = rb_enc_from_index(opt->ext.enc.index);
2630 enc = IF_UTF8_PATH(uenc, lenc);
2632 rb_enc_set_default_external(rb_enc_from_encoding(enc));
2633 if (opt->intern.enc.index >= 0) {
2635 enc = rb_enc_from_index(opt->intern.enc.index);
2636 rb_enc_set_default_internal(rb_enc_from_encoding(enc));
2640 rb_enc_set_default_internal(
Qnil);
2641 rb_stdio_set_default_encoding();
2643 opt->sflag = process_sflag(opt->sflag);
2646 if (dump & DUMP_BIT(syntax)) {
2647 printf(
"Syntax OK\n");
2648 dump &= ~DUMP_BIT(syntax);
2655 if (dump & DUMP_BIT(parsetree)) {
2658 int comment = opt->dump & DUMP_BIT(opt_comment);
2659 tree = rb_parser_dump_tree(result.ast->body.root, comment);
2662 tree = prism_dump_tree(&result.prism);
2666 dump &= ~DUMP_BIT(parsetree);
2675 if (!opt->e_script && strcmp(opt->script,
"-")) {
2676 path = rb_realpath_internal(
Qnil, opt->script_name, 1);
2679 path = str_conv_enc(path, uenc, lenc);
2683 rb_enc_copy(path, opt->script_name);
2688 GetBindingPtr(
rb_const_get(rb_cObject, rb_intern(
"TOPLEVEL_BINDING")), toplevel_binding);
2689 const struct rb_block *base_block = toplevel_context(toplevel_binding);
2690 const rb_iseq_t *parent = vm_block_iseq(base_block);
2691 bool optimize = (opt->dump & DUMP_BIT(opt_optimize)) != 0;
2696 iseq = pm_iseq_new_main(&pm->
node, opt->script_name, path, parent, optimize, &error_state);
2698 pm_parse_result_free(pm);
2702 rb_jump_tag(error_state);
2706 rb_ast_t *ast = result.ast;
2707 iseq = rb_iseq_new_main(ast_value, opt->script_name, path, parent, optimize);
2708 rb_ast_dispose(ast);
2712 if (dump & DUMP_BIT(insns)) {
2713 rb_io_write(
rb_stdout, rb_iseq_disasm((
const rb_iseq_t *)iseq));
2715 dump &= ~DUMP_BIT(insns);
2716 if (!dump)
return Qtrue;
2718 if (opt->dump & dump_exit_bits)
return Qtrue;
2720 process_options_global_setup(opt, iseq);
2726warn_cr_in_shebang(
const char *str,
long len)
2728 if (
len > 1 && str[
len-1] ==
'\n' && str[
len-2] ==
'\r') {
2729 rb_warn(
"shebang line ending with \\r may cause problems");
2733#define warn_cr_in_shebang(str, len) (void)0
2736void rb_reset_argf_lineno(
long n);
2742 ruby_cmdline_options_t *opt;
2746void rb_set_script_lines_for(
VALUE vparser,
VALUE path);
2749load_file_internal(
VALUE argp_v)
2752 VALUE parser = argp->parser;
2753 VALUE orig_fname = argp->fname;
2754 int script = argp->script;
2755 ruby_cmdline_options_t *opt = argp->opt;
2762 CONST_ID(set_encoding,
"set_encoding");
2768 int no_src_enc = !opt->src.enc.name;
2769 int no_ext_enc = !opt->ext.enc.name;
2770 int no_int_enc = !opt->intern.enc.name;
2773 rb_funcall(f, set_encoding, 1, rb_enc_from_encoding(enc));
2781 if (
len > 2 && str[0] ==
'#' && str[1] ==
'!') {
2782 if (line_start == 1) warn_cr_in_shebang(str,
len);
2796 warn_cr_in_shebang(str,
len);
2799 goto search_shebang;
2804 if (*str ==
'\n') *str-- =
'\0';
2805 if (*str ==
'\r') *str-- =
'\0';
2807 if ((p = strstr(p,
" -")) != 0) {
2809 moreswitches(p + 1, opt, 0);
2815 else if (!
NIL_P(c)) {
2819 if (no_src_enc && opt->src.enc.name) {
2820 opt->src.enc.index = opt_enc_index(opt->src.enc.name);
2821 src_encoding_index = opt->src.enc.index;
2823 if (no_ext_enc && opt->ext.enc.name) {
2824 opt->ext.enc.index = opt_enc_index(opt->ext.enc.name);
2826 if (no_int_enc && opt->intern.enc.name) {
2827 opt->intern.enc.index = opt_enc_index(opt->intern.enc.name);
2830 else if (!
NIL_P(c)) {
2836 rb_reset_argf_lineno(0);
2839 if (opt->src.enc.index >= 0) {
2840 enc = rb_enc_from_index(opt->src.enc.index);
2848 rb_parser_set_options(parser, opt->do_print, opt->do_loop,
2849 opt->do_line, opt->do_split);
2851 rb_set_script_lines_for(parser, orig_fname);
2855 rb_enc_associate(f, enc);
2856 return rb_parser_compile_string_path(parser, orig_fname, f, line_start);
2859 ast_value = rb_parser_compile_file_path(parser, orig_fname, f, line_start);
2860 rb_funcall(f, set_encoding, 1, rb_parser_encoding(parser));
2861 if (script && rb_parser_end_seen_p(parser)) {
2882disable_nonblock(
int fd)
2884#if defined(HAVE_FCNTL) && defined(F_SETFL)
2885 if (fcntl(fd, F_SETFL, 0) < 0) {
2886 const int e =
errno;
2889 if (e == ENOTSUP)
return 0;
2891# if defined B_UNSUPPORTED
2892 if (e == B_UNSUPPORTED)
return 0;
2901open_load_file(
VALUE fname_v,
int *xflag)
2903 const char *fname = (fname_v = rb_str_encode_ospath(fname_v),
2905 long flen = RSTRING_LEN(fname_v);
2909 if (flen == 1 && fname[0] ==
'-') {
2916 const int MODE_TO_LOAD = O_RDONLY | (
2917#if defined O_NONBLOCK && HAVE_FCNTL
2919 !(O_NONBLOCK & O_ACCMODE) ? O_NONBLOCK :
2921#if defined O_NDELAY && HAVE_FCNTL
2922 !(O_NDELAY & O_ACCMODE) ? O_NDELAY :
2925 int mode = MODE_TO_LOAD;
2926#if defined DOSISH || defined __CYGWIN__
2927# define isdirsep(x) ((x) == '/' || (x) == '\\')
2929 static const char exeext[] =
".exe";
2930 enum {extlen =
sizeof(exeext)-1};
2931 if (flen > extlen && !isdirsep(fname[flen-extlen-1]) &&
2932 STRNCASECMP(fname+flen-extlen, exeext, extlen) == 0) {
2941 if (!rb_gc_for_fd(e)) {
2942 rb_load_fail(fname_v, strerror(e));
2945 rb_load_fail(fname_v, strerror(
errno));
2950 if (MODE_TO_LOAD != O_RDONLY && (e = disable_nonblock(fd)) != 0) {
2952 rb_load_fail(fname_v, strerror(e));
2955 e = ruby_is_fd_loadable(fd);
2959 rb_load_fail(fname_v, strerror(e));
2975restore_load_file(
VALUE arg)
2987load_file(
VALUE parser,
VALUE fname,
VALUE f,
int script, ruby_cmdline_options_t *opt)
2990 arg.parser = parser;
2992 arg.script = script;
2996 restore_load_file, (
VALUE)&arg);
3010 ast_value = rb_parser_load_file(rb_parser_new(), fname_v);
3011 return (
void *)rb_ruby_ast_data_get(ast_value);
3015rb_parser_load_file(
VALUE parser,
VALUE fname_v)
3017 ruby_cmdline_options_t opt;
3019 VALUE f = open_load_file(fname_v, &xflag);
3020 cmdline_options_init(&opt)->xflag = xflag != 0;
3021 return load_file(parser, fname_v, f, 0, &opt);
3036proc_argv0(
VALUE process)
3038 return rb_orig_progname;
3063 return ruby_setproctitle(title);
3067ruby_setproctitle(
VALUE title)
3077 if (origarg.argv == 0)
3084external_str_new_cstr(
const char *p)
3096set_progname(
VALUE name)
3098 rb_orig_progname = rb_progname = name;
3099 rb_vm_set_progname(rb_progname);
3121init_ids(ruby_cmdline_options_t *opt)
3123 rb_uid_t uid = getuid();
3124 rb_uid_t euid = geteuid();
3125 rb_gid_t gid = getgid();
3126 rb_gid_t egid = getegid();
3128 if (uid != euid) opt->setids |= 1;
3129 if (egid != gid) opt->setids |= 2;
3134forbid_setid(
const char *s,
const ruby_cmdline_options_t *opt)
3136 if (opt->setids & 1)
3138 if (opt->setids & 2)
3143verbose_getter(
ID id,
VALUE *ptr)
3155opt_W_getter(
ID id,
VALUE *dmy)
3172debug_getter(
ID id,
VALUE *dmy)
3193 rb_gvar_ractor_local(
"$VERBOSE");
3194 rb_gvar_ractor_local(
"$-v");
3195 rb_gvar_ractor_local(
"$-w");
3196 rb_gvar_ractor_local(
"$-W");
3197 rb_gvar_ractor_local(
"$DEBUG");
3198 rb_gvar_ractor_local(
"$-d");
3222 for (i = 0; i < argc; i++) {
3223 VALUE arg = external_str_new_cstr(argv[i]);
3233 ruby_cmdline_options_t opt;
3235 const char *script_name = (argc > 0 && argv[0]) ? argv[0] :
ruby_engine;
3237 if (!origarg.argv || origarg.argc <= 0) {
3238 origarg.argc = argc;
3239 origarg.argv = argv;
3241 set_progname(external_str_new_cstr(script_name));
3243 rb_vm_register_global_object(
rb_argv0);
3245#ifndef HAVE_SETPROCTITLE
3246 ruby_init_setproctitle(argc, argv);
3249 if (getenv(
"RUBY_FREE_AT_EXIT")) {
3250 rb_free_at_exit =
true;
3254 iseq = process_options(argc, argv, cmdline_options_init(&opt));
3256 if (opt.crash_report && *opt.crash_report) {
3257 void ruby_set_crash_report(
const char *
template);
3258 ruby_set_crash_report(opt.crash_report);
3261 return (
void*)(
struct RData*)iseq;
3265fill_standard_fds(
void)
3267 int f0, f1, f2, fds[2];
3269 f0 = fstat(0, &buf) == -1 &&
errno == EBADF;
3270 f1 = fstat(1, &buf) == -1 &&
errno == EBADF;
3271 f2 = fstat(2, &buf) == -1 &&
errno == EBADF;
3273 if (pipe(fds) == 0) {
3282 if (pipe(fds) == 0) {
3284 if (f1 && fds[1] != 1)
3286 if (f2 && fds[1] != 2)
3288 if (fds[1] != 1 && fds[1] != 2)
3298 rb_w32_sysinit(argc, argv);
3300 if (*argc >= 0 && *argv) {
3301 origarg.argc = *argc;
3302 origarg.argv = *argv;
3304 fill_standard_fds();
3307#ifdef RUBY_ASAN_ENABLED
3308RUBY_SYMBOL_EXPORT_BEGIN
3309const char ruby_asan_default_options[] =
"use_sigaltstack=0:detect_leaks=0";
3310RUBY_SYMBOL_EXPORT_END
#define RUBY_ASSERT(...)
Asserts that the given expression is truthy if and only if RUBY_DEBUG is truthy.
#define ISSPACE
@old{rb_isspace}
#define STRNCASECMP
@old{st_locale_insensitive_strncasecmp}
#define TOLOWER
@old{rb_tolower}
#define ISALNUM
@old{rb_isalnum}
#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.
#define RUBY_EXTERN
Declaration of externally visible global variables.
#define PATH_SEP_CHAR
Identical to PATH_SEP, except it is of type char.
#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 rb_str_cat2
Old name of rb_str_cat_cstr.
#define UNREACHABLE
Old name of RBIMPL_UNREACHABLE.
#define OBJ_FREEZE
Old name of RB_OBJ_FREEZE.
#define ECONV_UNDEF_REPLACE
Old name of RUBY_ECONV_UNDEF_REPLACE.
#define UNREACHABLE_RETURN
Old name of RBIMPL_UNREACHABLE_RETURN.
#define SIZET2NUM
Old name of RB_SIZE2NUM.
#define ENCODING_GET(obj)
Old name of RB_ENCODING_GET.
#define ECONV_INVALID_REPLACE
Old name of RUBY_ECONV_INVALID_REPLACE.
#define ASSUME
Old name of RBIMPL_ASSUME.
#define Qtrue
Old name of RUBY_Qtrue.
#define Qnil
Old name of RUBY_Qnil.
#define Qfalse
Old name of RUBY_Qfalse.
#define ENC_CODERANGE_BROKEN
Old name of RUBY_ENC_CODERANGE_BROKEN.
#define NIL_P
Old name of RB_NIL_P.
#define scan_oct(s, l, e)
Old name of ruby_scan_oct.
#define CONST_ID
Old name of RUBY_CONST_ID.
#define rb_str_new4
Old name of rb_str_new_frozen.
void ruby_script(const char *name)
Sets the current script name to this value.
void ruby_set_argv(int argc, char **argv)
Sets argv that ruby understands.
void ruby_set_script_name(VALUE name)
Sets the current script name to this value.
void ruby_init_loadpath(void)
Sets up $LOAD_PATH.
void * ruby_process_options(int argc, char **argv)
Identical to ruby_options(), except it raises ruby-level exceptions on failure.
void ruby_prog_init(void)
Defines built-in variables.
void ruby_incpush(const char *path)
Appends the given path to the end of the load path.
#define ruby_debug
This variable controls whether the interpreter is in debug mode.
void rb_category_warn(rb_warning_category_t category, const char *fmt,...)
Identical to rb_category_warning(), except it reports unless $VERBOSE is nil.
void rb_exc_raise(VALUE mesg)
Raises an exception in the current thread.
#define ruby_verbose
This variable controls whether the interpreter is in debug mode.
VALUE rb_eTypeError
TypeError exception.
VALUE rb_eNameError
NameError exception.
VALUE rb_eRuntimeError
RuntimeError exception.
VALUE * rb_ruby_verbose_ptr(void)
This is an implementation detail of ruby_verbose.
void rb_warn(const char *fmt,...)
Identical to rb_warning(), except it reports unless $VERBOSE is nil.
VALUE rb_exc_new_str(VALUE etype, VALUE str)
Identical to rb_exc_new_cstr(), except it takes a Ruby's string instead of C's.
void rb_enc_raise(rb_encoding *enc, VALUE exc, const char *fmt,...)
Identical to rb_raise(), except it additionally takes an encoding.
void rb_loaderror(const char *fmt,...)
Raises an instance of rb_eLoadError.
VALUE * rb_ruby_debug_ptr(void)
This is an implementation detail of ruby_debug.
VALUE rb_eSecurityError
SecurityError exception.
void rb_warning(const char *fmt,...)
Issues a warning.
@ RB_WARN_CATEGORY_STRICT_UNUSED_BLOCK
Warning is for checking unused block strictly.
@ RB_WARN_CATEGORY_DEPRECATED
Warning is for deprecated features.
@ RB_WARN_CATEGORY_EXPERIMENTAL
Warning is for experimental features.
@ RB_WARN_CATEGORY_PERFORMANCE
Warning is for performance issues (not enabled by -w).
VALUE rb_mProcess
Process module.
VALUE rb_class_new_instance(int argc, const VALUE *argv, VALUE klass)
Allocates, then initialises an instance of the given class.
VALUE rb_stdin
STDIN constant.
VALUE rb_obj_freeze(VALUE obj)
Just calls rb_obj_freeze_inline() inside.
VALUE rb_stdout
STDOUT constant.
VALUE rb_cString
String class.
void ruby_show_copyright(void)
Prints the copyright notice of the CRuby interpreter to stdout.
void ruby_sysinit(int *argc, char ***argv)
Initializes the process for libruby.
void ruby_show_version(void)
Prints the version information of the CRuby interpreter to stdout.
rb_encoding * rb_utf8_encoding(void)
Queries the encoding that represents UTF-8.
rb_encoding * rb_ascii8bit_encoding(void)
Queries the encoding that represents ASCII-8BIT a.k.a.
rb_encoding * rb_default_internal_encoding(void)
Queries the "default internal" encoding.
rb_encoding * rb_default_external_encoding(void)
Queries the "default external" encoding.
rb_encoding * rb_locale_encoding(void)
Queries the encoding that represents the current locale.
VALUE rb_str_conv_enc(VALUE str, rb_encoding *from, rb_encoding *to)
Encoding conversion main routine.
VALUE rb_str_conv_enc_opts(VALUE str, rb_encoding *from, rb_encoding *to, int ecflags, VALUE ecopts)
Identical to rb_str_conv_enc(), except it additionally takes IO encoder options.
VALUE rb_enc_interned_str(const char *ptr, long len, rb_encoding *enc)
Identical to rb_enc_str_new(), except it returns a "f"string.
VALUE rb_funcall_passing_block(VALUE recv, ID mid, int argc, const VALUE *argv)
Identical to rb_funcallv_public(), except you can pass the passed block.
VALUE rb_funcall(VALUE recv, ID mid, int n,...)
Calls a method.
VALUE rb_ary_shift(VALUE ary)
Destructively deletes an element from the beginning of the passed array and returns what was deleted.
void rb_ary_modify(VALUE ary)
Declares that the array is about to be modified.
VALUE rb_ary_replace(VALUE copy, VALUE orig)
Replaces the contents of the former object with the contents of the latter.
VALUE rb_ary_hidden_new(long capa)
Allocates a hidden (no class) empty array.
VALUE rb_ary_clear(VALUE ary)
Destructively removes everything form an array.
VALUE rb_ary_push(VALUE ary, VALUE elem)
Special case of rb_ary_cat() that it adds only one element.
VALUE rb_hash_new(void)
Creates a new, empty hash object.
VALUE rb_io_gets(VALUE io)
Reads a "line" from the given IO.
VALUE rb_io_ungetbyte(VALUE io, VALUE b)
Identical to rb_io_ungetc(), except it doesn't take the encoding of the passed IO into account.
VALUE rb_io_getbyte(VALUE io)
Reads a byte from the given IO.
VALUE rb_io_fdopen(int fd, int flags, const char *path)
Creates an IO instance whose backend is the given file descriptor.
void rb_update_max_fd(int fd)
Informs the interpreter that the passed fd can be the max.
int rb_cloexec_open(const char *pathname, int flags, mode_t mode)
Opens a file that closes on exec.
VALUE rb_fs
The field separator character for inputs, or the $;.
VALUE rb_output_rs
The record separator character for outputs, or the $\\endiskip.
int rb_pipe(int *pipes)
This is an rb_cloexec_pipe() + rb_update_max_fd() combo.
VALUE rb_io_close(VALUE io)
Closes the IO.
void rb_lastline_set(VALUE str)
Updates $_.
VALUE rb_lastline_get(void)
Queries the last line, or the $_.
rb_pid_t rb_waitpid(rb_pid_t pid, int *status, int flags)
Waits for a process, with releasing GVL.
VALUE rb_f_exec(int argc, const VALUE *argv)
Replaces the current process by running the given external command.
VALUE rb_reg_new(const char *src, long len, int opts)
Creates a new Regular expression.
#define rb_utf8_str_new_cstr(str)
Identical to rb_str_new_cstr, except it generates a string of "UTF-8" encoding.
#define rb_str_new_lit(str)
Identical to rb_str_new_static(), except it cannot take string variables.
VALUE rb_str_tmp_new(long len)
Allocates a "temporary" string.
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...
#define rb_str_new(str, len)
Allocates an instance of rb_cString.
VALUE rb_str_new_frozen(VALUE str)
Creates a frozen copy of the string, if necessary.
VALUE rb_str_dup(VALUE str)
Duplicates a string.
VALUE rb_str_cat(VALUE dst, const char *src, long srclen)
Destructively appends the passed contents to the string.
#define rb_external_str_new_cstr(str)
Identical to rb_str_new_cstr, except it generates a string of "defaultexternal" encoding.
void rb_str_set_len(VALUE str, long len)
Overwrites the length of the string.
#define rb_strlen_lit(str)
Length of a string literal.
VALUE rb_str_freeze(VALUE str)
This is the implementation of String#freeze.
#define rb_str_cat_cstr(buf, str)
Identical to rb_str_cat(), except it assumes the passed pointer is a pointer to a C string.
#define rb_utf8_str_new(str, len)
Identical to rb_str_new, except it generates a string of "UTF-8" encoding.
void rb_str_modify_expand(VALUE str, long capa)
Identical to rb_str_modify(), except it additionally expands the capacity of the receiver.
#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_const_get(VALUE space, ID name)
Identical to rb_const_defined(), except it returns the actual defined value.
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.
static ID rb_intern_const(const char *str)
This is a "tiny optimisation" over rb_intern().
void rb_define_global_const(const char *name, VALUE val)
Identical to rb_define_const(), except it defines that of "global", i.e.
rb_gvar_setter_t rb_gvar_readonly_setter
This function just raises rb_eNameError.
VALUE rb_gv_set(const char *name, VALUE val)
Assigns to a global variable.
@ RUBY_IO_READABLE
IO::READABLE
VALUE rb_io_wait(VALUE io, VALUE events, VALUE timeout)
Blocks until the passed IO is ready for the passed events.
int len
Length of the buffer.
void ruby_each_words(const char *str, void(*func)(const char *word, int len, void *argv), void *argv)
Scans the passed string, with calling the callback function every time it encounters a "word".
const char ruby_engine[]
This is just "ruby" for us.
const int ruby_patchlevel
This is a monotonic increasing integer that describes specific "patch" level.
#define RB_INT2NUM
Just another name of rb_int2num_inline.
#define RB_ALLOCV_N(type, v, n)
Allocates a memory region, possibly on stack.
#define MEMZERO(p, type, n)
Handy macro to erase a region of memory.
#define RB_ALLOCV_END(v)
Polite way to declare that the given array is not used any longer.
#define MEMMOVE(p1, p2, type, n)
Handy macro to call memmove.
void rb_define_hooked_variable(const char *q, VALUE *w, type *e, void_type *r)
Define a function-backended global variable.
VALUE type(ANYARGS)
ANYARGS-ed function type.
void rb_define_virtual_variable(const char *q, type *w, void_type *e)
Define a function-backended global variable.
VALUE rb_ensure(type *q, VALUE w, type *e, VALUE r)
An equivalent of ensure clause.
static const uint8_t PM_OPTIONS_COMMAND_LINE_E
A bit representing whether or not the command line -e option was set.
static const uint8_t PM_OPTIONS_COMMAND_LINE_L
A bit representing whether or not the command line -l option was set.
struct pm_options pm_options_t
The options that can be passed to the parser.
static const uint8_t PM_OPTIONS_COMMAND_LINE_A
A bit representing whether or not the command line -a option was set.
static const uint8_t PM_OPTIONS_COMMAND_LINE_N
A bit representing whether or not the command line -n option was set.
static const uint8_t PM_OPTIONS_COMMAND_LINE_X
A bit representing whether or not the command line -x option was set.
static const uint8_t PM_OPTIONS_COMMAND_LINE_P
A bit representing whether or not the command line -p option was set.
struct pm_parser pm_parser_t
The parser used to parse Ruby source.
#define RARRAY_LEN
Just another name of rb_array_len.
static void RARRAY_ASET(VALUE ary, long i, VALUE v)
Assigns an object in an array.
#define RARRAY_AREF(a, i)
#define RARRAY_CONST_PTR
Just another name of rb_array_const_ptr.
#define RFILE(obj)
Convenient casting macro.
#define StringValuePtr(v)
Identical to StringValue, except it returns a char*.
static int RSTRING_LENINT(VALUE str)
Identical to RSTRING_LEN(), except it differs for the return type.
#define RSTRING_GETMEM(str, ptrvar, lenvar)
Convenient macro to obtain the contents and length at once.
#define StringValueCStr(v)
Identical to StringValuePtr, except it additionally checks for the contents for viability as a C stri...
VALUE rb_argv0
The value of $0 at process bootup.
void * rb_load_file_str(VALUE file)
Identical to rb_load_file(), except it takes the argument as a Ruby's string instead of C's.
void * rb_load_file(const char *file)
Loads the given file.
#define rb_argv
Just another name of rb_get_argv.
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 RTEST
This is an old name of RB_TEST.
#define _(args)
This was a transition path from K&R to ANSI.
A pm_buffer_t is a simple memory buffer that stores data in a contiguous block of memory.
size_t length
The length of the buffer in bytes.
char * value
A pointer to the start of the buffer.
const uint8_t * start
A pointer to the start location of the range in the source.
pm_scope_node_t node
The resulting scope node that will hold the generated AST.
pm_parser_t parser
The parser that will do the actual parsing.
pm_options_t options
The options that will be passed to the parser.
pm_location_t data_loc
An optional location that represents the location of the END marker and the rest of the content of th...
const uint8_t * start
The pointer to the start of the source.
uintptr_t ID
Type that represents a Ruby identifier such as a variable name.
uintptr_t VALUE
Type that represents a Ruby object.
static bool RB_TYPE_P(VALUE obj, enum ruby_value_type t)
Queries if the given object is of given type.