Merge pull request #250778 from NixOS/staging-next

# wafHook {#wafhook}

Overrides the configure, build, and install phases. This will run the “waf” script used by many projects. If `wafPath` (default `./waf`) doesn’t exist, it will copy the version of waf available in Nixpkgs. `wafFlags` can be used to pass flags to the waf script.

[Waf](https://waf.io) is a Python-based software building system.

In Nixpkgs, `wafHook` overrides the default configure, build, and install phases.

## Variables controlling wafHook {#variablesControllingWafHook}

### `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`

- `services.prometheus.exporters` has a new exporter to monitor electrical power consumption based on PowercapRAPL sensor called [Scaphandre](https://github.com/hubblo-org/scaphandre), see [#239803](https://github.com/NixOS/nixpkgs/pull/239803) for more details.

- The MariaDB C client library was upgraded from 3.2.x to 3.3.x. It is recomended to review the [upstream release notes](https://mariadb.com/kb/en/mariadb-connector-c-33-release-notes/).

- The module `services.calibre-server` has new options to configure the `host`, `port`, `auth.enable`, `auth.mode` and `auth.userDb` path, see [#216497](https://github.com/NixOS/nixpkgs/pull/216497/) for more details.

- `services.prometheus.exporters` has a new [exporter](https://github.com/hipages/php-fpm_exporter) to monitor PHP-FPM processes, see [#240394](https://github.com/NixOS/nixpkgs/pull/240394) for more details.

  nativeBuildInputs = [ autoPatchelfHook ];

  setSourceRoot = "sourceRoot=$PWD";

  sourceRoot = ".";

  dontBuild = true;

  nativeBuildInputs = [ cmake pkg-config copyDesktopItems ];

  buildInputs = [ bluez dbus glew glfw imgui ];

  sourceRoot = "./${src.name}/Client";

  sourceRoot = "${src.name}/Client";

  cmakeFlags = [ "-Wno-dev" ];

    sha256 = "1qc58l3rkr37cj6vhf8c7bnwbz93nscyraz7jxqwjq6k4gj0cjw3";

  };

  sourceRoot = "./howl-${version}/src";

  sourceRoot = "howl-${version}/src";

  # The Makefile uses "/usr/local" if not explicitly overridden

  installFlags = [ "PREFIX=$(out)" ];