.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-store" "1" ""
.RS
.PP
\fBWarning\fR 
.br
This program is
.UR @docroot@/development/experimental-features.md#xp-feature-nix-command
\fBexperimental\fR
.UE
and its interface is subject to change.
.RE
.SH Name
.LP
\f(CRnix store\fR - manipulate a Nix store
.SH Synopsis
.LP
\f(CRnix store\fR [\fIoption\fR\[u2026]] \fIsubcommand\fR
.PP
where \fIsubcommand\fR is one of the following:
.IP "\(bu" 3
.UR ./nix3-store-add.md
\f(CRnix store add\fR
.UE
- Add a file or directory to the Nix store
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-add-file.md
\f(CRnix store add-file\fR
.UE
- Deprecated. Use \c
.UR @docroot@/command-ref/new-cli/nix3-store-add.md
\f(CRnix store add --mode flat\fR
.UE
instead.
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-add-path.md
\f(CRnix store add-path\fR
.UE
- Deprecated alias to \c
.UR @docroot@/command-ref/new-cli/nix3-store-add.md
\f(CRnix store add\fR
.UE \c
\&.
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-cat.md
\f(CRnix store cat\fR
.UE
- print the contents of a file in the Nix store on stdout
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-copy-log.md
\f(CRnix store copy-log\fR
.UE
- copy build logs between Nix stores
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-copy-sigs.md
\f(CRnix store copy-sigs\fR
.UE
- copy store path signatures from substituters
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-delete.md
\f(CRnix store delete\fR
.UE
- delete paths from the Nix store
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-diff-closures.md
\f(CRnix store diff-closures\fR
.UE
- show what packages and versions were added and removed between two closures
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-dump-path.md
\f(CRnix store dump-path\fR
.UE
- serialise a store path to stdout in NAR format
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-gc.md
\f(CRnix store gc\fR
.UE
- perform garbage collection on a Nix store
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-info.md
\f(CRnix store info\fR
.UE
- test whether a store can be accessed
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-ls.md
\f(CRnix store ls\fR
.UE
- show information about a path in the Nix store
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-make-content-addressed.md
\f(CRnix store make-content-addressed\fR
.UE
- rewrite a path or closure to content-addressed form
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-optimise.md
\f(CRnix store optimise\fR
.UE
- replace identical files in the store by hard links
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-path-from-hash-part.md
\f(CRnix store path-from-hash-part\fR
.UE
- get a store path from its hash part
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-ping.md
\f(CRnix store ping\fR
.UE
- test whether a store can be accessed
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-prefetch-file.md
\f(CRnix store prefetch-file\fR
.UE
- download a file into the Nix store
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-repair.md
\f(CRnix store repair\fR
.UE
- repair store paths
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-sign.md
\f(CRnix store sign\fR
.UE
- sign store paths with a local key
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
.UR ./nix3-store-verify.md
\f(CRnix store verify\fR
.UE
- verify the integrity of store paths
.SH Options
.SS
Logging-related options
.IP "\(bu" 3
.UR #opt-debug
\f(CR--debug\fR
.UE
.IP
Set the logging verbosity level to \(oqdebug\(cq.
.IP "\(bu" 3
.UR #opt-log-format
\f(CR--log-format\fR
.UE
\fIformat\fR
.IP
Set the format of log output; one of \f(CRraw\fR, \f(CRinternal-json\fR, \f(CRbar\fR or \f(CRbar-with-logs\fR.
.IP "\(bu" 3
.UR #opt-print-build-logs
\f(CR--print-build-logs\fR
.UE
/ \f(CR-L\fR
.IP
Print full build logs on standard error.
.IP "\(bu" 3
.UR #opt-quiet
\f(CR--quiet\fR
.UE
.IP
Decrease the logging verbosity level.
.IP "\(bu" 3
.UR #opt-verbose
\f(CR--verbose\fR
.UE
/ \f(CR-v\fR
.IP
Increase the logging verbosity level.
.SS
Miscellaneous global options
.IP "\(bu" 3
.UR #opt-help
\f(CR--help\fR
.UE
.IP
Show usage information.
.IP "\(bu" 3
.UR #opt-offline
\f(CR--offline\fR
.UE
.IP
Disable substituters and consider all previously downloaded files up-to-date.
.IP "\(bu" 3
.UR #opt-option
\f(CR--option\fR
.UE
\fIname\fR \fIvalue\fR
.IP
Set the Nix configuration setting \fIname\fR to \fIvalue\fR (overriding \f(CRnix.conf\fR).
.IP "\(bu" 3
.UR #opt-refresh
\f(CR--refresh\fR
.UE
.IP
Consider all previously downloaded files out-of-date.
.IP "\(bu" 3
.UR #opt-version
\f(CR--version\fR
.UE
.IP
Show version information.
.RS
.LP
\fBNote\fR
.PP
See \c
.UR @docroot@/command-ref/conf-file.md#command-line-flags
\f(CRman nix.conf\fR
.UE
for overriding configuration settings with command line flags.
.RE