nix3-nar-ls - Man Page

nix nar ls [option…] nar path

• To list a specific file in a NAR :

# nix nar ls --long ./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 --recursive ./hello.nar /bin
{"type":"directory","entries":{"hello":{"type":"regular","size":38184,"executable":true,"narOffset":400}}}

This command shows information about a path inside Nix Archive (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.

• --no-pretty

  Print compact JSON output on a single line, even when the output is a terminal. Some commands may print multiple JSON objects on separate lines.

            See `--pretty`.

• --pretty

  Print multi-line, indented JSON output for readability.

            Default: indent if output is to a terminal.

            This option is only effective when `--json` is also specified.

• --recursive / -R

  List subdirectories recursively.