lix/doc/manual/src/glossary.md

138 lines
6.3 KiB
Markdown
Raw Normal View History

2020-07-22 21:17:48 +00:00
# Glossary
- [derivation]{#gloss-derivation}\
2020-07-22 21:17:48 +00:00
A description of a build action. The result of a derivation is a
store object. Derivations are typically specified in Nix expressions
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`).
- [store]{#gloss-store}\
2020-07-22 21:17:48 +00:00
The location in the file system where store objects live. Typically
`/nix/store`.
From the perspective of the location where Nix is
invoked, the Nix store can be referred to
as a "_local_" or a "_remote_" one:
2022-09-01 20:38:07 +00:00
+ A *local store* exists on the filesystem of
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.
+ 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.
- [binary cache]{#binary-cache}\
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
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).
- [store path]{#gloss-store-path}\
2020-07-22 21:17:48 +00:00
The location in the file system of a store object, i.e., an
immediate child of the Nix store directory.
- [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),
derivation outputs (objects produced by running a build action), or
derivations (files describing a build action).
- [substitute]{#gloss-substitute}\
2020-07-22 21:17:48 +00:00
A substitute is a command invocation stored in the Nix database that
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.
- [substituter]{#gloss-substituter}\
A *substituter* is a store other than `/nix/store` from which Nix will
copy a store path instead of building it. Nix will not copy a store
path from a remote store unless one of the following is true:
- the store object is signed by one of the `trusted-public-keys`
- the substituter is in the `trusted-substituters` list
- the `no-require-sigs` option has been set to disable signature checking
- the store object is a derivation
- the store object is the realisation of a fixed-output derivation
- [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.
- [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.
- [reference]{#gloss-reference}\
2020-07-22 21:17:48 +00:00
A store path `P` is said to have a reference to a store path `Q` if
the store object at `P` contains the path `Q` somewhere. The
*references* of a store path are the set of store paths to which it
has a reference.
2020-07-22 21:17:48 +00:00
A derivation can reference other derivations and sources (but not
output paths), whereas an output path only references other output
paths.
- [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
- [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
its 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.
2020-07-22 21:17:48 +00:00
As an example, if the store object at path `P` contains a reference
to path `Q`, then `Q` is in the closure of `P`. Further, if `Q`
references `R` then `R` is also in the closure of `P`.
- [output path]{#gloss-output-path}\
2020-07-22 21:17:48 +00:00
A store path produced by a derivation.
- [deriver]{#gloss-deriver}\
2020-07-24 12:31:33 +00:00
The deriver of an *output path* is the store
2020-07-22 21:17:48 +00:00
derivation that built it.
- [validity]{#gloss-validity}\
2020-07-22 21:17:48 +00:00
A store path is considered *valid* if it exists in the file system,
is listed in the Nix database as being valid, and if all paths in
its closure are also valid.
- [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
[`nix-env`](command-ref/nix-env.md). See *profiles*.
2020-07-22 21:17:48 +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
- [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`.
- [`∅`]{#gloss-emtpy-set}\
The empty set symbol. In the context of profile history, this denotes a package is not present in a particular version of the profile.
- [`ε`]{#gloss-epsilon}\
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.