DOKK / manpages / debian 12 / nix-bin / nix3-nar-ls.1.en
nix3-nar-ls(1) General Commands Manual nix3-nar-ls(1)

Warning: This program is experimental and its interface is subject to change.

nix nar ls - show information about a path inside a NAR file

nix nar ls [option…] nar path

To list a specific file in a NAR:

# nix nar ls -l ./hello.nar /bin/hello
-r-xr-xr-x                38184 hello
To recursively list the contents of a directory inside a NAR, in JSON format:

# nix nar ls --json -R ./hello.nar /bin
{"type":"directory","entries":{"hello":{"type":"regular","size":38184,"executable":true,"narOffset":400}}}

This command shows information about a path inside NAR file nar.

  • --directory / -d
    Show directories rather than their contents.
  • --json
    Produce output in JSON format, suitable for consumption by another program.
  • --long / -l
    Show detailed file information.
  • --recursive / -R
    List subdirectories recursively.