646b892680
Some checks failed
Periodic Merges (6h) / master → staging-nixos (push) Failing after 12m50s
Periodic Merges (6h) / master → staging-next (push) Failing after 12m54s
Periodic Merges (24h) / merge-base(master,staging) → haskell-updates (push) Failing after 11m54s
Periodic Merges (6h) / staging-next → staging (push) Failing after 12m13s
Periodic Merges (24h) / staging-next-25.05 → staging-25.05 (push) Failing after 13m24s
Periodic Merges (24h) / release-25.05 → staging-next-25.05 (push) Failing after 14m28s
25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
# VCPKG {#sec-vcpkg}
|
|
|
|
The `vcpkg-tool` package has a wrapper around the `vcpkg` executable to avoid writing to the nix store.
|
|
The wrapper will also be present in `vcpkg`, unless you specify `vcpkg.override { vcpkg-tool = vcpkg-tool-unwrapped; }`
|
|
|
|
The wrapper has been made in a way so that it will provide default cli arguments but tries not to interfere if the user provides the same arguments.
|
|
The arguments also have corresponding environment variables that can be used as an alternative way of overriding these paths.
|
|
|
|
Run the wrapper with the environment variable `NIX_VCPKG_DEBUG_PRINT_ENVVARS=true` to get a full list of corresponding environment variables.
|
|
|
|
## Nix specific environment variables {#sec-vcpkg-nix-envvars}
|
|
|
|
The wrapper also provides some new nix-specific environment variables that let you control some of the wrapper functionality.
|
|
|
|
- `NIX_VCPKG_WRITABLE_PATH = <path>`
|
|
|
|
Set this environment variable to specify the path where `vcpkg` will store buildtime artifacts.
|
|
This will become the base path for all of the other paths.
|
|
|
|
- `NIX_VCPKG_DEBUG_PRINT_ENVVARS = true | false`
|
|
|
|
Set this to `true` for the wrapper to print the corresponding environment variables for the arguments that will be provided to the unwrapped executable.
|
|
The list of variables will be printed right before invoking `vcpkg`.
|
|
This can be useful if you suspect that the wrapper for some reason was unable to prioritize user-provided cli args over its default ones, or for fixing other issues like typos or unexpanded environment variables.
|