2025-07-03 18:57:48 +00:00
|
|
|
= zilch-cli-ninja(1)
|
|
|
|
|
Puck Meerburg
|
|
|
|
|
v0.0.1
|
|
|
|
|
:doctype: manpage
|
|
|
|
|
:manmanual: ZILCH-CLI-NINJA
|
|
|
|
|
:mansource: ZILCH
|
|
|
|
|
:page-pagination: prev
|
|
|
|
|
|
|
|
|
|
== Name
|
|
|
|
|
|
|
|
|
|
zilch-cli-ninja - builds a Nixpkgs package using Ninja, using Zilch
|
|
|
|
|
|
|
|
|
|
== Synopsis
|
|
|
|
|
|
|
|
|
|
*zilch-cli-ninja* [_OPTION_]... _COMMAND_ [_ARG_]...
|
|
|
|
|
|
|
|
|
|
== Description
|
|
|
|
|
|
|
|
|
|
This command uses Zilch to build a Ninja-based project entirely within
|
|
|
|
|
Nix, using content-addressed derivations.
|
|
|
|
|
|
|
|
|
|
This program requires the derivation to build has a configuration file
|
|
|
|
|
written. See the documentation at https://puck.moe/zilch/docs/.
|
|
|
|
|
|
|
|
|
|
== Subcommands
|
|
|
|
|
*build* [_TARGET_]...::
|
|
|
|
|
Build the derivation described by the configuration file, or the
|
2025-10-01 14:59:25 +00:00
|
|
|
target names from its Ninja file, if any are passed as arguments.
|
2025-07-03 18:57:48 +00:00
|
|
|
|
|
|
|
|
*source* [_DIR_]::
|
2025-10-01 14:59:25 +00:00
|
|
|
Write the source of the derivation and its rewrites to the path in
|
|
|
|
|
`override-source`, using _DIR_ (or `src`) for the root if no
|
2025-07-03 18:57:48 +00:00
|
|
|
directory is provided.
|
|
|
|
|
|
|
|
|
|
*diff*::
|
|
|
|
|
Compare the 'canonical' source of the derivation to that in the
|
2025-10-01 14:59:25 +00:00
|
|
|
source directory (the path in `override-source:`, `src`, or the path
|
|
|
|
|
selected by `--source`.)
|
2025-07-03 18:57:48 +00:00
|
|
|
|
|
|
|
|
== Options
|
|
|
|
|
|
|
|
|
|
*-h*::
|
|
|
|
|
*--help*::
|
|
|
|
|
Print a help message.
|
|
|
|
|
|
2025-09-29 15:20:29 +00:00
|
|
|
*-p* _NAME_::
|
|
|
|
|
*--project* _NAME_::
|
2025-10-01 14:59:25 +00:00
|
|
|
Operate only on a rewrite of the derivation. Repeat to operate on a
|
|
|
|
|
rewrite of a rewrite.
|
2025-09-29 15:20:29 +00:00
|
|
|
|
2025-07-03 18:57:48 +00:00
|
|
|
*-s* _DIR_::
|
|
|
|
|
*--source* _DIR_::
|
|
|
|
|
Override the input source for builds. Doesn't reconfigure the build,
|
|
|
|
|
so changes to the build system do not apply.
|
|
|
|
|
|
|
|
|
|
*-f* _PATH_::
|
|
|
|
|
*--config-file* _PATH_::
|
|
|
|
|
The location of the configuration file. Defaults to `zilch.scm`.
|
|
|
|
|
|
|
|
|
|
*-j* _COUNT_::
|
|
|
|
|
*--max-jobs* _COUNT_::
|
|
|
|
|
The maximum amount of builds to run. Defaults to the amount of cores.
|
|
|
|
|
|
|
|
|
|
*-v*::
|
|
|
|
|
*--verbose*::
|
|
|
|
|
Increase the verbosity configured in the Nix daemon.
|
|
|
|
|
|
2025-11-24 18:37:10 +00:00
|
|
|
*-T*::
|
|
|
|
|
*--trust-all*::
|
|
|
|
|
By default, Nix expressions can only access the paths in NIX_PATH,
|
|
|
|
|
plus the source directories and the directory of the configuration.
|
|
|
|
|
Setting this flag drops this restriction, at the cost of Nix
|
|
|
|
|
expressions being able to escape the Nix sandbox easier.
|
|
|
|
|
|
2025-07-03 18:57:48 +00:00
|
|
|
*-L*::
|
|
|
|
|
*--print-build-logs*::
|
|
|
|
|
Print derivation logs as they come in.
|
