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