PBXB64 [options] <input files>
Output Control
| Option | Description |
|---|---|
-o <file> | Set output executable path (default: a.exe) |
-c | Compile only - produce object file (.obj), skip linking |
-S | Stop after assembly generation (.asm) |
--emit-ast, --dump-ast | Emit AST dump to stdout for debugging |
--emit-ir, --dump-ir | Emit IR dump to stdout |
--emit-asm | Emit assembly listing to stdout |
--emit-obj | Force object file emission (alias for -c) |
--emit-map | Emit map file |
--emit-mir | Emit MIR dump to stdout |
--asm:<path> | Save generated assembly to file, then continue compiling and linking |
--dump-tokens | Dump lexer token stream to stdout |
Preprocessor (V8 Enhanced)
| Option | Description |
|---|---|
-E | Preprocess only - output expanded source to stdout |
-I <path> | Add user include search path (checked first) |
-isystem <path> | Add system include path (suppresses warnings) |
-DNAME | Define macro NAME=1 |
-DNAME=value | Define macro with explicit value |
-UNAME | Undefine previously defined macro |
-std=c17 | Enable C17 standard mode (default in V8) |
-ffreestanding | Freestanding environment (no runtime dependencies) |
-fhosted | Hosted C mode (default) |
-fno-builtin | Disable builtin functions |
Optimization Levels
| Option | Description |
|---|---|
-O0 | No optimization (default, fastest compile, debug-friendly) |
-O1 | Basic optimizations: dead code elimination, constant folding |
-O2 | |
-O3 | Maximum optimization (may increase binary size) |
--NoOpt | Disable all optimizations (alias for -O0) |
Diagnostics
| Option | Description |
|---|---|
-Wall | Enable all common warnings |
-Wextra | Enable extra warnings |
-Werror | Treat warnings as errors |
-pedantic | Strict standard compliance |
Target & General Options
| Option | Description |
|---|---|
--target <triple> | Set target triple (default: x86_64-w64-windows-gnu) |
--entry <symbol> | Override default entry point symbol |
-v, --verbose | Verbose output - show compilation steps and paths |
--version | Print compiler version and exit |
-g, --debug | Emit debug information |
--time-stages | Time compilation stages |
V8 Tip: Combine
-E -I core/include/c17 -DDEBUG=1 program.c to inspect preprocessed output with custom macros and headers.