2023-06-10 15:54:02 +00:00
|
|
|
# wafHook {#wafhook}
|
2022-10-13 13:36:04 +00:00
|
|
|
|
2023-07-17 02:24:31 +00:00
|
|
|
[Waf](https://waf.io) is a Python-based software building system.
|
|
|
|
|
|
|
|
|
|
In Nixpkgs, `wafHook` overrides the default configure, build, and install phases.
|
|
|
|
|
|
2023-08-24 04:20:00 +00:00
|
|
|
## Variables controlling wafHook {#variablesControllingWafHook}
|
2023-07-17 02:24:31 +00:00
|
|
|
|
|
|
|
|
### `wafPath` {#wafPath}
|
|
|
|
|
|
|
|
|
|
Location of the `waf` tool. It defaults to `./waf`, to honor software projects that include it directly inside their source trees.
|
|
|
|
|
|
|
|
|
|
If `wafPath` doesn't exist, then `wafHook` will copy the `waf` provided from Nixpkgs to it.
|
|
|
|
|
|
|
|
|
|
### `wafConfigureFlags` {#wafConfigureFlags}
|
|
|
|
|
|
|
|
|
|
Controls the flags passed to waf tool during configure phase.
|
|
|
|
|
|
|
|
|
|
### `wafFlags` {#wafFlags}
|
|
|
|
|
|
|
|
|
|
Controls the flags passed to waf tool during build and install phases.
|
|
|
|
|
|
|
|
|
|
### `dontAddWafCrossFlags` {#dontAddWafCrossFlags}
|
|
|
|
|
|
|
|
|
|
When set to `true`, don't add cross compilation flags during configure phase.
|
|
|
|
|
|
|
|
|
|
### `dontUseWafConfigure` {#dontUseWafConfigure}
|
|
|
|
|
|
|
|
|
|
When set to true, don't use the predefined `wafConfigurePhase`.
|
|
|
|
|
|
|
|
|
|
### `dontUseWafBuild` {#dontUseWafBuild}
|
|
|
|
|
|
|
|
|
|
When set to true, don't use the predefined `wafBuildPhase`.
|
|
|
|
|
|
|
|
|
|
### `dontUseWafInstall` {#dontUseWafInstall}
|
|
|
|
|
|
|
|
|
|
When set to true, don't use the predefined `wafInstallPhase`.
|
|
|
|
|
|
|
|
|
|
### Variables honored by wafHook {#variablesHonoredByWafHook}
|
|
|
|
|
|
|
|
|
|
The following variables commonly used by `stdenv.mkDerivation` are also honored by `wafHook`.
|
|
|
|
|
|
|
|
|
|
- `prefixKey`
|
|
|
|
|
- `configureTargets`
|
|
|
|
|
- `enableParallelBuilding`
|
|
|
|
|
- `enableParallelInstalling`
|
|
|
|
|
- `buildFlags`
|
|
|
|
|
- `buildTargets`
|
|
|
|
|
- `installFlags`
|
|
|
|
|
- `installTargets`
|
