The glyim compiler driver (built as glyim-cli) compiles a single .g source file. This page documents the complete command-line surface, verified against the argument parser in crates/glyim-cli.
Target triple, for example aarch64-unknown-linux-gnu. Defaults to the host triple when unset.
--backend <NAME>
enum
llvm
no
Code generation backend: llvm, bytecode, or interp (the MIR interpreter used by --emit run).
--linker <PATH>
path
system linker
no
Override the system linker used to link executables.
--link-flags <FLAGS>
string
none
no
Extra flags passed to the linker.
--lto <KIND>
enum
off
no
Link-time optimization strategy: off, fat, or thin.
--codegen-units <N>
integer
parallelism
no
Number of codegen units (CGUs) for parallel code generation. Defaults to the available parallelism, capped at 16.
--proc-macro-deps <LIST>
string
none
no
Comma-separated proc-macro dependency source files, compiled for the host triple to cdylibs and loaded via dlopen.
--error-format <FMT>
enum
human
no
Diagnostic format: human (miette-rendered) or json (one JSON object per diagnostic).
--time-passes
flag
off
no
Print per-pass timing measurements after compilation.
--self-profile[=FILE]
path
none
no
Record a Chrome-trace profiling event log (FILE, default trace.json); opens in Perfetto.
--with-stdlib
flag
off
no
Prepend the assembled standard library to the input, so println, Vec, Option, Result, String, Box, Rc, and Iterator resolve without explicit use statements.
-A, --allow <LINT>
lint name
none
no
Suppress the named lint. Repeatable.
-W, --warn <LINT>
lint name
none
no
Set the named lint to warning level (the default). Repeatable. glyim -W help lists all lints.
-D, --deny <LINT>
lint name
none
no
Promote the named lint to error level, aborting compilation. Repeatable.
In-compiler module merge and optimize. Requires multi-CGU support, which is not yet implemented; requesting it errors cleanly (regardless of CGU count) rather than silently ignoring the request.
thin
Requires the LLVM backend and the llvm-lto2 tool from the same LLVM distribution the backend was built against. Requesting thin with --backend bytecode is an explicit error.
When the compiler itself panics, the driver catches the unwind and prints a structured ICE (internal compiler error) report instead of a raw Rust backtrace. The report includes the panic message and a backtrace captured at the panic site. A language-oriented error never appears as an ICE; an ICE is always a compiler bug worth reporting.