mirror of
https://github.com/NixOS/nix.git
synced 2025-11-14 22:42:41 +01:00
36b059748d
Documentation on "classic" commands with many sub-commands are notoriously hard to discover due to lack of overview and anchor links. Additionally the information on common options and environment variables is not accessible offline in man pages, and therefore often overlooked by readers. With this change, each sub-command of nix-store and nix-env gets its own page in the manual (listed in the table of contents), and each own man page. Also, man pages for each subcommand now (again) list common options and environment variables. While this makes each page quite long and some common parameters don't apply, this should still make it easier to navigate as that additional information was not accessible on the command line at all. It is now possible to run 'nix-store --<subcommand> --help` to display help pages for the given subcommand. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
26 lines
725 B
Markdown
26 lines
725 B
Markdown
# Name
|
|
|
|
`nix-store --dump-db` - export Nix database
|
|
|
|
# Synopsis
|
|
|
|
`nix-store` `--dump-db` [*paths…*]
|
|
|
|
# Description
|
|
|
|
The operation `--dump-db` writes a dump of the Nix database to standard
|
|
output. It can be loaded into an empty Nix store using `--load-db`. This
|
|
is useful for making backups and when migrating to different database
|
|
schemas.
|
|
|
|
By default, `--dump-db` will dump the entire Nix database. When one or
|
|
more store paths is passed, only the subset of the Nix database for
|
|
those store paths is dumped. As with `--export`, the user is responsible
|
|
for passing all the store paths for a closure. See `--export` for an
|
|
example.
|
|
|
|
{{#include ./opt-common.md}}
|
|
|
|
{{#include ../opt-common.md}}
|
|
|
|
{{#include ../env-common.md}}
|