.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-nar-ls" "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 ls\fR - show information about a path inside a NAR file
.SH Synopsis
.LP
\f(CRnix nar ls\fR [\fIoption\fR\[u2026]] \fInar\fR \fIpath\fR
.SH Examples
.IP "\(bu" 3
To list a specific file in a \fBNAR\fR:
.LP
.EX
# nix nar ls --long ./hello.nar /bin/hello
-r-xr-xr-x                38184 hello
.EE
.IP "\(bu" 3
To recursively list the contents of a directory inside a NAR, in JSON
format:
.LP
.EX
# nix nar ls --json --recursive ./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
.LP
This command shows information about a \fIpath\fR inside \fBNix Archive (NAR)\fR file \fInar\fR.
.SH Options
.IP "\(bu" 3
\fB\f(CR--directory\fR\fR / \f(CR-d\fR
.IP
Show directories rather than their contents.
.IP "\(bu" 3
\fB\f(CR--json\fR\fR
.IP
Produce output in JSON format, suitable for consumption by another program.
.IP "\(bu" 3
\fB\f(CR--long\fR\fR / \f(CR-l\fR
.IP
Show detailed file information.
.IP "\(bu" 3
\fB\f(CR--recursive\fR\fR / \f(CR-R\fR
.IP
List subdirectories recursively.
.SS
Logging-related options
.IP "\(bu" 3
\fB\f(CR--debug\fR\fR
.IP
Set the logging verbosity level to \(oqdebug\(cq.
.IP "\(bu" 3
\fB\f(CR--log-format\fR\fR \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
\fB\f(CR--print-build-logs\fR\fR / \f(CR-L\fR
.IP
Print full build logs on standard error.
.IP "\(bu" 3
\fB\f(CR--quiet\fR\fR
.IP
Decrease the logging verbosity level.
.IP "\(bu" 3
\fB\f(CR--verbose\fR\fR / \f(CR-v\fR
.IP
Increase the logging verbosity level.
.SS
Miscellaneous global options
.IP "\(bu" 3
\fB\f(CR--help\fR\fR
.IP
Show usage information.
.IP "\(bu" 3
\fB\f(CR--offline\fR\fR
.IP
Disable substituters and consider all previously downloaded files up-to-date.
.IP "\(bu" 3
\fB\f(CR--option\fR\fR \fIname\fR \fIvalue\fR
.IP
Set the Nix configuration setting \fIname\fR to \fIvalue\fR (overriding \f(CRnix.conf\fR).
.IP "\(bu" 3
\fB\f(CR--refresh\fR\fR
.IP
Consider all previously downloaded files out-of-date.
.IP "\(bu" 3
\fB\f(CR--version\fR\fR
.IP
Show version information.
.RS
.LP
\fBNote\fR
.PP
See \fB\f(CRman nix.conf\fR\fR for overriding configuration settings with command line flags.
.RE