Compatibility Matrix¶

rninja compatibility with Ninja and build systems.

Ninja Compatibility¶

Option	Ninja	rninja	Notes
`-C DIR`	✓	✓	Change directory
`-f FILE`	✓	✓	Build file
`-j N`	✓	✓	Parallel jobs
`-k N`	✓	✓	Keep going
`-l N`	✓	✓	Load limit
`-n`	✓	✓	Dry run
`-v`	✓	✓	Verbose
`-d MODE`	✓	✓	Debug mode
`-t TOOL`	✓	✓	Subtools
`-w FLAG`	✓	✓	Warnings

Tool	Ninja	rninja	Notes
`clean`	✓	✓	Remove outputs
`cleandead`	✓	✓	Remove stale outputs
`compdb`	✓	✓	Compilation database
`deps`	✓	✓	Show dependencies
`graph`	✓	✓	GraphViz output
`query`	✓	✓	Target info
`targets`	✓	✓	List targets
`commands`	✓	✓	Show commands
`recompact`	✓	✓	Compact log
`restat`	✓	✓	Update timestamps
`rules`	✓	✓	List rules
`cache-*`	✗	✓	rninja extension
`daemon-*`	✗	✓	rninja extension

File	Ninja	rninja	Notes
`build.ninja`	✓	✓	Identical
`.ninja_log`	✓	✓	Compatible
`.ninja_deps`	✓	✓	Compatible
`compile_commands.json`	✓	✓	Standard format

Code	Ninja	rninja	Meaning
0	✓	✓	Success
1	✓	✓	Build failed
2	✓	✓	Invalid arguments

cmake -G Ninja -B build
rninja -C build

meson setup build
rninja -C build

gn gen out/Default
rninja -C out/Default

Feature	Support	Notes
Direct	✗	Uses own executor
Via rules_foreign_cc	✓	CMake/Ninja builds

Feature	Support	Notes
Direct	✗	Uses own executor

Platform	Support	Notes
GitHub Actions	✓	Full support, examples provided
GitLab CI	✓	Full support, examples provided
Jenkins	✓	Full support
CircleCI	✓	Full support
Azure Pipelines	✓	Full support
Buildkite	✓	Full support

Platform	Support	Notes
Docker	✓	Official images available
Podman	✓	Compatible with Docker images
Kubernetes	✓	Deployment guides provided

Scenario	Ninja	rninja	Notes
Very long command lines	✓	✓	Uses response files
Unicode paths	✓	✓	UTF-8 support
Symlinks	✓	✓	Followed correctly
Network paths	✓	✓	Supported

# Create symlink
sudo ln -sf $(which rninja) /usr/local/bin/ninja

# Or alias
alias ninja=rninja

# Compare behavior
ninja -n -v > ninja.log 2>&1
rninja -n -v > rninja.log 2>&1
diff ninja.log rninja.log

# Remove symlink
sudo rm /usr/local/bin/ninja
sudo ln -sf $(which ninja.real) /usr/local/bin/ninja