.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-nar-ls" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix nar ls\fR - show information about a path inside a NAR file
.SH Synopsis
\fCnix nar ls\fR [\fIoption\fR\[u2026]] \fInar\fR \fIpath\fR
.SH Examples
.IP "\(bu" 2
To list a specific file in a NAR:
.LP
.EX
# nix nar ls -l ./hello.nar /bin/hello
-r-xr-xr-x                38184 hello
.EE
.IP "\(bu" 2
To recursively list the contents of a directory inside a NAR, in JSON
format:
.LP
.EX
# nix nar ls --json -R ./hello.nar /bin
{\(dqtype\(dq:\(dqdirectory\(dq,\(dqentries\(dq:{\(dqhello\(dq:{\(dqtype\(dq:\(dqregular\(dq,\(dqsize\(dq:38184,\(dqexecutable\(dq:true,\(dqnarOffset\(dq:400}}}
.EE
.SH Description
This command shows information about a \fIpath\fR inside NAR file \fInar\fR.
.SH Options
.IP "\(bu" 2
\fC--directory\fR / \fC-d\fR
.br
Show directories rather than their contents.
.IP "\(bu" 2
\fC--json\fR
.br
Produce output in JSON format, suitable for consumption by another program.
.IP "\(bu" 2
\fC--long\fR / \fC-l\fR
.br
Show detailed file information.
.IP "\(bu" 2
\fC--recursive\fR / \fC-R\fR
.br
List subdirectories recursively.