OS Manuals

/usr/share/truffleruby/bin/ruby

High perf implementation of Ruby built with GraalVM 25

From truffleruby 34.0.1-r5 (enterprise-packages), captured 2026-11-08 by running ruby --help (exit 0). permalink

Usage: truffleruby [options] [--] [filepath] [arguments]
  -0[octal]       Set input record separator ($/):
                  -0 for \0; -00 for paragraph mode; -0777 for slurp mode.
  -a              Split each input line ($_) into fields ($F).
  -c              Check syntax (no execution).
  -Cdirpath       Execute program in specified directory.
  -d, --debug     Set debugging flag ($DEBUG) to true.
  -e 'code'       Execute given Ruby code; multiple -e allowed.
  -Eex[:in], --encoding=ex[:in]
                  Set default external and internal encodings.
  -Fpattern       Set input field separator ($;); used with -a.
  -i[extension]   Set ARGF in-place mode;
                  create backup files with given extension.
  -Idirpath       Add specified directory to load paths ($LOAD_PATH);
                  multiple -I allowed.
  -l              Set output record separator ($\) to $/;
                  used for line-oriented output.
  -n              Run program in gets loop.
  -p              Like -n, with printing added.
  -rlibrary       Require the given library.
  -s              Define global variables using switches following program path.
  -S              Search directories found in the PATH environment variable.
  -v              Print version; set $VERBOSE to true.
  -w              Synonym for -W1.
  -W[level=2|:category]
                  Set warning flag ($-W):
                  0 for silent; 1 for moderate; 2 for verbose.
  -x[dirpath]     Execute Ruby code starting from a #!ruby line.
  --backtrace-limit=num
                  Set backtrace limit.
  --copyright     Print Ruby copyright.
  --disable=features
                  Disable features; see list below.
  --enable=features
                  Enable features; see list below.
  --external-encoding=encoding
                  Set default external encoding.
  --help          Print long help message; use -h for short message.
  --internal-encoding=encoding
                  Set default internal encoding.
  --verbose       Set $VERBOSE to true; ignore input from $stdin.
  --version       Print Ruby version.

Features:
  gems            Rubygems (only for debugging, default: enabled).
  error_highlight error_highlight (default: enabled).
  did_you_mean    did_you_mean (default: enabled).
  syntax_suggest  syntax_suggest (default: enabled).
  rubyopt         RUBYOPT environment variable (default: enabled).
  frozen-string-literal
                  Freeze all string literals (default: disabled).

Warning categories:
  deprecated      Deprecated features.
  experimental    Experimental features.
  performance     Performance issues.
  strict_unused_block
                  Warning unused block strictly

Runtime options:
  --native                                     Run using the native launcher with limited access to Java libraries
                                               (default).
  --vm.[option]                                Pass options to the host VM. To see available options, use '--help:vm'.
  --log.file=<String>                          Redirect guest languages logging into a given file.
  --log.[logger].level=<String>                Set language log level to OFF, SEVERE, WARNING, INFO, CONFIG, FINE,
                                               FINER, FINEST or ALL.
  --help                                       Print this help message.
  --help:vm                                    Print options for the host VM.
  --help:engine                                Print engine options.
  --help:compiler                              Print engine compiler options.
  --help:all                                   Print all options.
  --version:graalvm                            Print GraalVM version information and exit.
  --show-version:graalvm                       Print GraalVM version information and continue execution.

Languages:
  [id]        [name]                  [website]
  llvm        LLVM                    https://www.graalvm.org/25.0/reference-manual/llvm/
  ruby        Ruby                    https://github.com/truffleruby/truffleruby

Tools:
  [id]        [name]                  [website]
  agentscript Agent Script
  coverage    Code Coverage           https://www.graalvm.org/tools/code-coverage/
  cpusampler  CPU Sampler             https://www.graalvm.org/tools/profiling/
  cputracer   CPU Tracer              https://www.graalvm.org/tools/profiling/
  dap         Debug Protocol Server   https://www.graalvm.org/tools/dap/
  heap        Heap Dump
  heapmonitor Heap Allocation Monitor
  insight     Insight                 https://www.graalvm.org/tools/graalvm-insight/
  inspect     Chrome Inspector        https://www.graalvm.org/tools/chrome-debugger/
  lsp         Language Server         https://www.graalvm.org/tools/lsp/
  memtracer   Memory Tracer           https://www.graalvm.org/tools/profiling/

  Use --help:[id] for component options.

See http://www.graalvm.org for more information.
Options (33)
OptionDescriptionSource
-0 octalSet input record separator ($/):help
-aSplit each input line ($_) into fields ($F).help
-cCheck syntax (no execution).help
-CdirpathExecute program in specified directory.help
-d, --debugSet debugging flag ($DEBUG) to true.help
-e 'code'Execute given Ruby code;help
-Eex, --encoding :inSet default external and internal encodings.help
-FpatternSet input field separator ($;);help
-i extensionSet ARGF in-place mode;help
-IdirpathAdd specified directory to load paths ($LOAD_PATH);help
-lSet output record separator ($\) to $/;help
-nRun program in gets loop.help
-pLike -n, with printing added.help
-rlibraryRequire the given library.help
-sDefine global variables using switches following program path.help
-SSearch directories found in the PATH environment variable.help
-vPrint version;help
-wSynonym for -W1.help
-W level=2|:categorySet warning flag ($-W): 0 for silent;help
-x dirpathExecute Ruby code starting from a #!ruby line.help
--backtrace-limit numSet backtrace limit.help
--copyrightPrint Ruby copyright.help
--disable featuresDisable features;help
--enable featuresEnable features;help
--external-encoding encodingSet default external encoding.help
--helpPrint long help message;help
--internal-encoding encodingSet default internal encoding.help
--verboseSet $VERBOSE to true;help
--versionPrint Ruby version.help
--nativeRun using the native launcher with limited access to Java libraries (default).help
--vm optionPass options to the host VM.help
--log.file StringRedirect guest languages logging into a given file.help
--log logger].level=<StringSet language log level to OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST or ALL.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.