2020-07-22 21:17:48 +00:00
# Glossary
2022-05-25 10:36:46 +00:00
- [derivation]{#gloss-derivation}\
2022-11-06 11:25:21 +00:00
A description of a build task. The result of a derivation is a
2020-07-22 21:17:48 +00:00
store object. Derivations are typically specified in Nix expressions
2022-12-20 13:28:43 +00:00
using the [`derivation` primitive ](./language/derivations.md ). These are
2020-07-22 21:17:48 +00:00
translated into low-level *store derivations* (implicitly by
`nix-env` and `nix-build` , or explicitly by `nix-instantiate` ).
2022-12-20 14:11:31 +00:00
[derivation]: #gloss -derivation
- [store derivation]{#gloss-store-derivation}\
A [derivation] represented as a `.drv` file in the [store].
It has a [store path], like any [store object].
Example: `/nix/store/g946hcz4c8mdvq2g8vxx42z51qb71rvp-git-2.38.1.drv`
See [`nix show-derivation` ](./command-ref/new-cli/nix3-show-derivation.md ) (experimental) for displaying the contents of store derivations.
[store derivation]: #gloss -store-derivation
2023-01-19 14:48:38 +00:00
- [instantiate]{#gloss-instantiate}, instantiation\
Translate a [derivation] into a [store derivation].
See [`nix-instantiate` ](./command-ref/nix-instantiate.md ).
[instantiate]: #gloss -instantiate
2022-12-21 10:39:32 +00:00
- [realise]{#gloss-realise}, realisation\
Ensure a [store path] is [valid][validity].
This means either running the `builder` executable as specified in the corresponding [derivation] or fetching a pre-built [store object] from a [substituter].
2023-03-23 15:27:41 +00:00
See [`nix-build` ](./command-ref/nix-build.md ) and [`nix-store --realise` ](@docroot@/command-ref/nix-store/realise.md ).
2022-12-21 10:39:32 +00:00
See [`nix build` ](./command-ref/new-cli/nix3-build.md ) (experimental).
[realise]: #gloss -realise
2022-09-01 21:41:27 +00:00
- [content-addressed derivation]{#gloss-content-addressed-derivation}\
A derivation which has the
2022-12-20 13:28:43 +00:00
[`__contentAddressed` ](./language/advanced-attributes.md#adv-attr-__contentAddressed )
2022-09-01 21:41:27 +00:00
attribute set to `true` .
2022-09-01 21:09:06 +00:00
2022-09-01 21:41:27 +00:00
- [fixed-output derivation]{#gloss-fixed-output-derivation}\
2022-09-01 21:47:33 +00:00
A derivation which includes the
2022-12-20 13:28:43 +00:00
[`outputHash` ](./language/advanced-attributes.md#adv-attr-outputHash ) attribute.
2022-09-01 21:09:06 +00:00
2022-05-25 10:36:46 +00:00
- [store]{#gloss-store}\
2020-07-22 21:17:48 +00:00
The location in the file system where store objects live. Typically
`/nix/store` .
2022-08-05 17:39:43 +00:00
From the perspective of the location where Nix is
2022-08-08 17:52:31 +00:00
invoked, the Nix store can be referred to
2022-08-05 17:39:43 +00:00
as a "_local_" or a "_remote_" one:
2023-04-05 08:48:59 +00:00
+ A [local store]{#gloss-local-store} exists on the filesystem of
2022-08-05 17:39:43 +00:00
the machine where Nix is invoked. You can use other
local stores by passing the `--store` flag to the
2022-09-01 20:38:07 +00:00
`nix` command. Local stores can be used for building derivations.
2022-08-05 17:39:43 +00:00
+ A *remote store* exists anywhere other than the
local filesystem. One example is the `/nix/store`
directory on another machine, accessed via `ssh` or
served by the `nix-serve` Perl script.
2022-12-20 14:11:31 +00:00
[store]: #gloss -store
2023-04-05 08:48:59 +00:00
[local store]: #gloss -local-store
2022-12-20 14:11:31 +00:00
2022-09-02 01:28:05 +00:00
- [chroot store]{#gloss-chroot-store}\
2023-04-05 08:48:59 +00:00
A [local store] whose canonical path is anything other than `/nix/store` .
2022-09-02 01:28:05 +00:00
2022-09-02 01:27:00 +00:00
- [binary cache]{#gloss-binary-cache}\
2022-08-05 17:39:43 +00:00
A *binary cache* is a Nix store which uses a different format: its
metadata and signatures are kept in `.narinfo` files rather than in a
2023-04-05 08:50:34 +00:00
[Nix database]. This different format simplifies serving store objects
over the network, but cannot host builds. Examples of binary caches
include S3 buckets and the [NixOS binary cache ](https://cache.nixos.org ).
2022-08-05 17:39:43 +00:00
2022-05-25 10:36:46 +00:00
- [store path]{#gloss-store-path}\
2022-11-08 23:31:48 +00:00
The location of a [store object] in the file system, i.e., an
2020-07-22 21:17:48 +00:00
immediate child of the Nix store directory.
2022-12-20 14:11:31 +00:00
Example: `/nix/store/a040m110amc4h71lds2jmr8qrkj2jhxd-git-2.38.1`
[store path]: #gloss -store-path
2022-05-25 10:36:46 +00:00
- [store object]{#gloss-store-object}\
2020-07-22 21:17:48 +00:00
A file that is an immediate child of the Nix store directory. These
can be regular files, but also entire directory trees. Store objects
can be sources (objects copied from outside of the store),
2022-11-06 11:25:21 +00:00
derivation outputs (objects produced by running a build task), or
derivations (files describing a build task).
2020-07-22 21:17:48 +00:00
2022-12-20 14:11:31 +00:00
[store object]: #gloss -store-object
2022-09-01 21:09:06 +00:00
- [input-addressed store object]{#gloss-input-addressed-store-object}\
2022-09-01 22:09:10 +00:00
A store object produced by building a
non-[content-addressed](#gloss-content-addressed-derivation),
2022-09-02 00:48:34 +00:00
non-[fixed-output](#gloss-fixed-output-derivation)
2022-09-01 21:09:06 +00:00
derivation.
- [output-addressed store object]{#gloss-output-addressed-store-object}\
A store object whose store path hashes its content. This
2022-09-01 21:41:27 +00:00
includes derivations, the outputs of
[content-addressed derivations ](#gloss-content-addressed-derivation ),
and the outputs of
[fixed-output derivations ](#gloss-fixed-output-derivation ).
2022-09-01 21:09:06 +00:00
2022-05-25 10:36:46 +00:00
- [substitute]{#gloss-substitute}\
2023-04-05 08:50:34 +00:00
A substitute is a command invocation stored in the [Nix database] that
2020-07-22 21:17:48 +00:00
describes how to build a store object, bypassing the normal build
mechanism (i.e., derivations). Typically, the substitute builds the
store object by downloading a pre-built version of the store object
from some server.
2022-08-05 17:39:43 +00:00
- [substituter]{#gloss-substituter}\
2022-09-01 20:40:39 +00:00
A *substituter* is an additional store from which Nix will
2022-09-02 00:51:56 +00:00
copy store objects it doesn't have. For details, see the
2022-12-20 13:28:43 +00:00
[`substituters` option ](./command-ref/conf-file.md#conf-substituters ).
2022-08-05 17:39:43 +00:00
2022-12-21 10:39:32 +00:00
[substituter]: #gloss -substituter
2022-05-25 10:36:46 +00:00
- [purity]{#gloss-purity}\
2020-07-22 21:17:48 +00:00
The assumption that equal Nix derivations when run always produce
the same output. This cannot be guaranteed in general (e.g., a
builder can rely on external inputs such as the network or the
system time) but the Nix model assumes it.
2023-04-05 08:50:34 +00:00
- Nix database{#gloss-nix-database}\
An SQlite database to track [reference]s between [store object]s.
This is an implementation detail of the [local store].
Default location: `/nix/var/nix/db` .
[Nix database]: #gloss -nix-database
2022-05-25 10:36:46 +00:00
- [Nix expression]{#gloss-nix-expression}\
2020-07-22 21:17:48 +00:00
A high-level description of software packages and compositions
thereof. Deploying software using Nix entails writing Nix
expressions for your packages. Nix expressions are translated to
derivations that are stored in the Nix store. These derivations can
then be built.
2022-05-25 10:36:46 +00:00
- [reference]{#gloss-reference}\
2023-02-07 10:59:18 +00:00
A [store object] `O` is said to have a *reference* to a store object `P` if a [store path] to `P` appears in the contents of `O` .
2021-11-30 16:13:46 +00:00
2023-01-17 11:33:23 +00:00
Store objects can refer to both other store objects and themselves.
References from a store object to itself are called *self-references* .
References other than a self-reference must not form a cycle.
2022-12-20 15:24:13 +00:00
[reference]: #gloss -reference
2020-07-22 21:17:48 +00:00
2022-05-25 10:36:46 +00:00
- [reachable]{#gloss-reachable}\
2020-07-24 12:31:33 +00:00
A store path `Q` is reachable from another store path `P` if `Q`
is in the *closure* of the *references* relation.
2020-07-22 21:17:48 +00:00
2022-05-25 10:36:46 +00:00
- [closure]{#gloss-closure}\
2020-07-22 21:17:48 +00:00
The closure of a store path is the set of store paths that are
directly or indirectly “reachable” from that store path; that is,
2020-07-24 12:31:33 +00:00
it’ s the closure of the path under the *references* relation. For
a package, the closure of its derivation is equivalent to the
build-time dependencies, while the closure of its output path is
equivalent to its runtime dependencies. For correct deployment it
is necessary to deploy whole closures, since otherwise at runtime
files could be missing. The command `nix-store -qR` prints out
closures of store paths.
2021-11-30 16:13:46 +00:00
2023-02-27 11:56:22 +00:00
As an example, if the [store object] at path `P` contains a [reference]
2023-02-27 12:04:54 +00:00
to a store object at path `Q` , then `Q` is in the closure of `P` . Further, if `Q`
2020-07-22 21:17:48 +00:00
references `R` then `R` is also in the closure of `P` .
2023-01-23 23:15:12 +00:00
[closure]: #gloss -closure
2022-05-25 10:36:46 +00:00
- [output path]{#gloss-output-path}\
2022-12-20 14:26:05 +00:00
A [store path] produced by a [derivation].
[output path]: #gloss -output-path
2020-07-22 21:17:48 +00:00
2022-05-25 10:36:46 +00:00
- [deriver]{#gloss-deriver}\
2022-12-21 10:39:32 +00:00
The [store derivation] that produced an [output path].
2020-07-22 21:17:48 +00:00
2022-05-25 10:36:46 +00:00
- [validity]{#gloss-validity}\
2022-12-21 10:39:32 +00:00
A store path is valid if all [store object]s in its [closure] can be read from the [store].
2023-04-05 08:48:59 +00:00
For a [local store], this means:
2022-12-21 10:39:32 +00:00
- The store path leads to an existing [store object] in that [store].
2023-04-05 08:50:34 +00:00
- The store path is listed in the [Nix database] as being valid.
2022-12-21 10:39:32 +00:00
- All paths in the store path's [closure] are valid.
2020-07-22 21:17:48 +00:00
2023-01-23 23:15:12 +00:00
[validity]: #gloss -validity
2022-05-25 10:36:46 +00:00
- [user environment]{#gloss-user-env}\
2020-07-22 21:17:48 +00:00
An automatically generated store object that consists of a set of
symlinks to “active” applications, i.e., other store paths. These
2020-07-24 12:31:33 +00:00
are generated automatically by
2022-12-20 13:28:43 +00:00
[`nix-env` ](./command-ref/nix-env.md ). See *profiles* .
2020-07-22 21:17:48 +00:00
2022-05-25 10:36:46 +00:00
- [profile]{#gloss-profile}\
2020-07-24 12:31:33 +00:00
A symlink to the current *user environment* of a user, e.g.,
`/nix/var/nix/profiles/default` .
2020-07-22 21:17:48 +00:00
2022-12-01 00:57:02 +00:00
- [installable]{#gloss-installable}\
Something that can be realised in the Nix store.
See [installables ](./command-ref/new-cli/nix.md#installables ) for [`nix` commands ](./command-ref/new-cli/nix.md ) (experimental) for details.
2022-05-25 10:36:46 +00:00
- [NAR]{#gloss-nar}\
2020-07-22 21:17:48 +00:00
A *N*ix *AR*chive. This is a serialisation of a path in the Nix
2020-07-24 12:31:33 +00:00
store. It can contain regular files, directories and symbolic
links. NARs are generated and unpacked using `nix-store --dump`
and `nix-store --restore` .
2022-12-20 13:28:43 +00:00
2022-05-25 10:36:46 +00:00
- [`∅`]{#gloss-emtpy-set}\
2021-11-30 18:19:42 +00:00
The empty set symbol. In the context of profile history, this denotes a package is not present in a particular version of the profile.
2022-12-20 13:28:43 +00:00
2022-05-25 10:36:46 +00:00
- [`ε`]{#gloss-epsilon}\
2021-11-30 16:13:46 +00:00
The epsilon symbol. In the context of a package, this means the version is empty. More precisely, the derivation does not have a version attribute.
2022-11-08 23:31:48 +00:00
- [string interpolation]{#gloss-string-interpolation}\
Expanding expressions enclosed in `${ }` within a [string], [path], or [attribute name].
See [String interpolation ](./language/string-interpolation.md ) for details.
[string]: ./language/values.md#type-string
[path]: ./language/values.md#type-path
[attribute name]: ./language/values.md#attribute-set