.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-nar" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix nar\fR - create or inspect NAR files
.SH Synopsis
\fCnix nar\fR [\fIoption\fR\[u2026]] \fIsubcommand\fR
.PP
where \fIsubcommand\fR is one of the following:
.IP "\(bu" 2
\fB\fCnix nar cat\fR\fR (\fI./nix3-nar-cat.md\fR) - print the contents of a file inside a NAR file on stdout
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 2
\fB\fCnix nar dump-path\fR\fR (\fI./nix3-nar-dump-path.md\fR) - serialise a path to stdout in NAR format
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 2
\fB\fCnix nar ls\fR\fR (\fI./nix3-nar-ls.md\fR) - show information about a path inside a NAR file
.SH Description
\fCnix nar\fR provides several subcommands for creating and inspecting
\fINix Archives\fR (NARs).
.SH File format
For the definition of the NAR file format, see Figure 5.2 in
\fIhttps://edolstra.github.io/pubs/phd-thesis.pdf\fR.