nix3-nar(1)

💖 nix3-nar(1) — the one where we mess with NAR files 💖

okay bestie, before literally anything else, we need to have a little chat. this is from the General Commands Manual (nix3-nar(1), yes, that's the manual name, it's iconic), and:

⚠️ Warning — this program is experimental and its interface is subject to change. like, it might just reshape itself overnight. no cap. proceed with the awareness of a girl who reads the changelog. 👑✨

---

✨ Name ✨

nix nar — create or inspect NAR files 🎀

---

🌸 Synopsis 🌸

nix nar [option…] subcommand

and where subcommand is one of the following, periodt:

• nix nar cat — print the contents of a file inside a NAR file on stdout 🐱
• nix nar dump-path — serialise a path to stdout in NAR format
• nix nar ls — show information about a path inside a NAR file
• nix nar pack — serialise a path to stdout in NAR format

---

🦋 Description 🦋

nix nar hands you several subcommands for creating and inspecting Nix Archives (NARs). that's the whole vibe. make them, look at them, live your truth. 💅

🍓 File format 🍓

for the definition of the Nix Archive file format, see within the protocols chapter of the manual. iykyk — go read it, it's giving documentation. 📖

---

💖 Options 💖

🌈 Logging-related options

• --debug — set the logging verbosity level to ‘debug’. we are getting so much detail, bestie.
• --log-format format — set the format of log output; one of raw, internal-json, bar or bar-with-logs. pick your aesthetic. ✨
• --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. when in doubt, ask for help, queen.
• --offline — disable substituters and consider all previously downloaded files up-to-date. we're going airplane mode, no thoughts head empty. ✈️
• --option name value — set the Nix configuration setting name to value (overriding nix.conf).
• --refresh — consider all previously downloaded files out-of-date. plot twist: everything's old again. 💀
• --version — show version information. who even am i? 🪞

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

---

okay that's the whole page, bestie, you ate it. 🫶 this was the nix3-nar(1) manual page from the General Commands Manual, and that footer up in your terminal was just repping its own name on the way out — <rainbow>stay experimental, stay iconic ✨👑💖