diff options
| author | Eelco Dolstra <e.dolstra@tudelft.nl> | 2004-06-28 10:42:57 +0000 |
|---|---|---|
| committer | Eelco Dolstra <e.dolstra@tudelft.nl> | 2004-06-28 10:42:57 +0000 |
| commit | 91dc023665e22eb5637bf08c405e91ac9060c357 (patch) | |
| tree | 566e96b4670653bc9ab68f042e94808dcdcb5b29 /doc/manual | |
| parent | b113edeab780216b0590045b932be685d1399e9b (diff) | |
* Added a switch `--fallback'. From the manual:
Whenever Nix attempts to realise a derivation for which a closure is
already known, but this closure cannot be realised, fall back on
normalising the derivation.
The most common scenario in which this is useful is when we have
registered substitutes in order to perform binary distribution from,
say, a network repository. If the repository is down, the
realisation of the derivation will fail. When this option is
specified, Nix will build the derivation instead. Thus, binary
installation falls back on a source installation. This option is
not the default since it is generally not desirable for a transient
failure in obtaining the substitutes to lead to a full build from
source (with the related consumption of resources).
Diffstat (limited to 'doc/manual')
| -rw-r--r-- | doc/manual/opt-common-syn.xml | 1 | ||||
| -rw-r--r-- | doc/manual/opt-common.xml | 25 |
2 files changed, 26 insertions, 0 deletions
diff --git a/doc/manual/opt-common-syn.xml b/doc/manual/opt-common-syn.xml index f90041863..f848ad249 100644 --- a/doc/manual/opt-common-syn.xml +++ b/doc/manual/opt-common-syn.xml @@ -15,3 +15,4 @@ <arg><option>-k</option></arg> <arg><option>--keep-failed</option></arg> <arg><option>-K</option></arg> +<arg><option>--fallback</option></arg> diff --git a/doc/manual/opt-common.xml b/doc/manual/opt-common.xml index 158e282fd..db8a60eca 100644 --- a/doc/manual/opt-common.xml +++ b/doc/manual/opt-common.xml @@ -147,3 +147,28 @@ </listitem> </varlistentry> + +<varlistentry> + <term><option>--fallback</option></term> + <listitem> + <para> + Whenever Nix attempts to realise a derivation for which a + closure is already known, but this closure cannot be realised, + fall back on normalising the derivation. + </para> + + <para> + The most common scenario in which this is useful is when we have + registered substitutes in order to perform binary distribution + from, say, a network repository. If the repository is down, the + realisation of the derivation will fail. When this option is + specified, Nix will build the derivation instead. Thus, + binary installation falls back on a source installation. This + option is not the default since it is generally not desirable + for a transient failure in obtaining the substitutes to lead to + a full build from source (with the related consumption of + resources). + </para> + </listitem> +</varlistentry> + |