emilytrau/lix
1
0
Fork 0
forked from lix-project/lix
Code Pull requests Activity
lix/doc/manual/src/glossary.md

105 lines
4.4 KiB
Markdown
Raw Normal View History

Pandoc conversion
2020-07-22 21:17:48 +00:00
# Glossary
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- derivation\
Pandoc conversion
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
Fix some dangling references
2020-07-24 12:31:33 +00:00
using the [`derivation` primitive](expressions/derivations.md). These are
Pandoc conversion
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`).
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- store\
Pandoc conversion
2020-07-22 21:17:48 +00:00
The location in the file system where store objects live. Typically
`/nix/store`.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- store path\
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- store object\
Pandoc conversion
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).
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- substitute\
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- purity\
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- Nix expression\
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- reference\
Pandoc conversion
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.
docs: document set theory symbols These symbols confused me so I wanted to gloss them to help future users. You can see the context here: https://discourse.nixos.org/t/flakes-what-does-mean-big-bundle-of-questions
2021-11-30 16:13:46 +00:00
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- reachable\
Fix some dangling references
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.
Pandoc conversion
2020-07-22 21:17:48 +00:00
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- closure\
Pandoc conversion
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,
Fix some dangling references
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.
docs: document set theory symbols These symbols confused me so I wanted to gloss them to help future users. You can see the context here: https://discourse.nixos.org/t/flakes-what-does-mean-big-bundle-of-questions
2021-11-30 16:13:46 +00:00
Pandoc conversion
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`.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- output path\
Pandoc conversion
2020-07-22 21:17:48 +00:00
A store path produced by a derivation.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- deriver\
Fix some dangling references
2020-07-24 12:31:33 +00:00
The deriver of an *output path* is the store
Pandoc conversion
2020-07-22 21:17:48 +00:00
derivation that built it.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- validity\
Pandoc conversion
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.
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- user environment\
Pandoc conversion
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
Fix some dangling references
2020-07-24 12:31:33 +00:00
are generated automatically by
[`nix-env`](command-ref/nix-env.md). See *profiles*.
Pandoc conversion
2020-07-22 21:17:48 +00:00
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- profile\
Fix some dangling references
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`.
Pandoc conversion
2020-07-22 21:17:48 +00:00
Replace the trailing markdown spaces by a backslash They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-04-23 12:30:42 +00:00
- NAR\
Pandoc conversion
2020-07-22 21:17:48 +00:00
A *N*ix *AR*chive. This is a serialisation of a path in the Nix
Fix some dangling references
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`.
docs: document set theory symbols These symbols confused me so I wanted to gloss them to help future users. You can see the context here: https://discourse.nixos.org/t/flakes-what-does-mean-big-bundle-of-questions
2021-11-30 16:13:46 +00:00
- `∅` \
The empty set symbol. In the context of package history, this denotes a package was not present prior to installation.
- `ε` \
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.
Copy permalink