nix3-nar-ls(1)

💅 nix3-nar-ls(1) — General Commands Manual 💅

okay bestie, before literally anything else: ⚠️ this program is experimental and its interface is subject to change. so like, it's giving "we're still figuring it out" energy, no cap. don't come for me when the flags shift under your feet. 🫶

---

✨ Name ✨

nix nar ls — show information about a path inside a NAR file 🌸

(iykyk: NAR = Nix Archive. it's the vibe.)

---

🦋 Synopsis 🦋

nix nar ls [option…] nar path

---

🎀 Examples 🎀

1. wanna list one specific file inside a NAR? iconic. do this:

# nix nar ls --long ./hello.nar /bin/hello
-r-xr-xr-x                38184 hello

2. wanna go recursive on a directory inside a NAR and get it as JSON? periodt:

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

---

👑 Description 👑

This command shows information about a path inside Nix Archive (NAR) file nar. literally that's it. that's the whole job. and it ate. 💖

---

✨ Options ✨

• --directory, -d — show directories rather than their contents. like, the folder itself is the moment, not what's inside 🎀
• --json — produce output in JSON format, suitable for consumption by another program. feed it to your lil scripts bestie 🤖
• --long, -l — show detailed file information. the full tea ☕
• --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. also: 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. so like, don't @ me if you use it alone 💀
• --recursive, -R — list subdirectories recursively. go all the way down, no skipping 🌈

🌸 Logging-related options 🌸

• --debug — set the logging verbosity level to 'debug'. maximum yapping mode 🔥
• --log-format format — set the format of log output; one of raw, internal-json, bar or bar-with-logs.
• --print-build-logs, -L — print full build logs on standard error.
• --quiet — decrease the logging verbosity level. shhh 🤫
• --verbose, -v — increase the logging verbosity level. tell me EVERYTHING 👑

💜 Miscellaneous global options 💜

• --help — show usage information. your girl's got you 🫶
• --offline — disable substituters and consider all previously downloaded files up-to-date.
• --option name value — set the Nix configuration setting name to value (overriding nix.conf).
• --refresh — consider all previously downloaded files out-of-date.
• --version — show version information.

Note 📌 see man nix.conf for overriding configuration settings with command line flags.

---

and that's the whole page bestie, fr fr. this lil gem came out of the nix3-nar-ls(1) manual, and the footer was literally just the same name staring back at us — so consider this your cute lil sign-off: nix3-nar-ls(1), that's a wrap. slay, go list some NARs 💅✨🦋