add example to nix-store --import

this also features specifying `--store` to give more pointers for
discoverability
This commit is contained in:
Valentin Gagarin 2024-05-15 01:11:14 +02:00
parent 05ad4e8806
commit dcc2a51bac

View file

@ -19,3 +19,21 @@ Nix store, the import fails.
{{#include ../opt-common.md}}
{{#include ../env-common.md}}
# Examples
> **Example**
>
> Given a closure of GNU Hello as a file:
>
> ```shell-session
> $ storePath="$(nix-build '<nixpkgs>' -I nixpkgs=channel:nixpkgs-unstable -A hello --no-out-link)"
> $ nix-store --export $(nix-store --query --requisites $storePath) > hello.closure
> ```
>
> Import the closure into a [remote SSH store](@docroot@/store/types/ssh-store.md) using the [`--store`](@docroot@/command-ref/conf-file.md#conf-store) option:
>
> ```console
> $ nix-store --import --store ssh://alice@itchy.example.org < hello.closure
> ```