lix/src/nix/registry-pin.md

39 lines
985 B
Markdown
Raw Normal View History

R""(
# Examples
* Pin `nixpkgs` to its most recent Git revision:
```console
# nix registry pin nixpkgs
```
Afterwards the user registry will have an entry like this:
```console
nix registry list | grep '^user '
user flake:nixpkgs github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a
```
and `nix flake info` will say:
```console
# nix flake info nixpkgs
Resolved URL: github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a
Locked URL: github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a
```
# Description
This command adds an entry to the user registry that maps flake
reference *url* to the corresponding *locked* flake reference, that
is, a flake reference that specifies an exact revision or content
hash. This ensures that until this registry entry is removed, all uses
of *url* will resolve to exactly the same flake.
Entries can be removed using [`nix registry
remove`](./nix3-registry-remove.md).
)""