.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-store-add-file" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix store add-file\fR - add a regular file to the Nix store
.SH Synopsis
\fCnix store add-file\fR [\fIoption\fR\[u2026]] \fIpath\fR
.SH Description
Copy the regular file \fIpath\fR to the Nix store, and print the resulting
store path on standard output.
.RS
.PP
\fBWarning\fR
.PP
The resulting store path is not registered as a garbage
collector root, so it could be deleted before you have a
chance to register it.
.RE
.SH Examples
Add a regular file to the store:
.LP
.EX
# echo foo > bar

# nix store add-file ./bar
/nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar

# cat /nix/store/cbv2s4bsvzjri77s2gb8g8bpcb6dpa8w-bar
foo
.EE
.SH Options
.IP "\(bu" 2
\fC--dry-run\fR
.br
Show what this command would do without doing it.
.IP "\(bu" 2
\fC--name\fR / \fC-n\fR \fIname\fR
.br
Override the name component of the store path. It defaults to the base name of \fIpath\fR.