.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-store-ls" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix store ls\fR - show information about a path in the Nix store
.SH Synopsis
\fCnix store ls\fR [\fIoption\fR\[u2026]] \fIpath\fR
.SH Examples
.IP "\(bu" 2
To list the contents of a store path in a binary cache:
.LP
.EX
# nix store ls --store https://cache.nixos.org/ -lR /nix/store/0i2jd68mp5g6h2sa5k9c85rb80sn8hi9-hello-2.10
dr-xr-xr-x                    0 ./bin
-r-xr-xr-x                38184 ./bin/hello
dr-xr-xr-x                    0 ./share
…
.EE
.IP "\(bu" 2
To show information about a specific file in a binary cache:
.LP
.EX
# nix store ls --store https://cache.nixos.org/ -l /nix/store/0i2jd68mp5g6h2sa5k9c85rb80sn8hi9-hello-2.10/bin/hello
-r-xr-xr-x                38184 hello
.EE
.SH Description
This command shows information about \fIpath\fR in a Nix store. \fIpath\fR can
be a top-level store path or any file inside a store path.
.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.