nix3-nar-dump-path(1)

✨ nix3-nar-dump-path(1) ✨

okay bestie, welcome to the Nix manual β€” this one's a page from the General Commands Manual and it's about nix nar dump-path, which is lowkey the most "put it in a box and mail it" command ever. πŸŽ€

⚠️ Warning β€” this program is experimental and its interface is subject to change. so like, don't build your whole personality around it, bestie. 🫢

πŸ’– Name πŸ’–

nix nar dump-path β€” serialise a path to stdout in NAR format. that's it, that's the vibe. πŸ¦‹


🌸 Synopsis 🌸

nix nar dump-path [option…] path

✨ Examples ✨

  • To serialise directory foo as a Nix Archive (NAR):
# nix nar pack ./foo > foo.nar

(yes boo, the example says pack β€” I'm not arguing with the manpage, I'm just transcribing it, periodt. πŸ’…)


πŸ¦‹ Description πŸ¦‹

This command generates a Nix Archive (NAR) file containing the serialisation of path, which must contain only regular files, directories and symbolic links. The NAR is written to standard output.

so: point it at a thing, get NAR bytes on stdout, feel iconic. ✨ if your path has something spicy in it that isn't a regular file, a directory or a symlink, that's a no from the manpage. πŸ™ˆ


πŸ‘‘ Options πŸ‘‘

  • --debug β€” set the logging verbosity level to 'debug'. maximum yapping mode, we love to see it. πŸ”₯
  • --log-format format β€” set the format of log output; one of raw, internal-json, bar or bar-with-logs. pick your aesthetic bestie. πŸŽ€
  • --print-build-logs, -L β€” print full build logs on standard error. give me everything. 😭
  • --quiet β€” decrease the logging verbosity level. shhh era. 🀫
  • --verbose, -v β€” increase the logging verbosity level. tell me more tell me more. πŸ’œ

⭐ Miscellaneous global options

  • --help β€” show usage information. when in doubt, ask the command itself. 🫢
  • --offline β€” disable substituters and consider all previously downloaded files up-to-date. offline era, no cap. πŸ’€
  • --option name value β€” set the Nix configuration setting name to value (overriding nix.conf). sneaky little override, we stan. πŸ’…
  • --refresh β€” consider all previously downloaded files out-of-date. everything's stale, slay. πŸ”₯
  • --version β€” show version information. who are you, what's your sign. πŸ‘‘
Note β€” see man nix.conf for overriding configuration settings with command line flags. ✨

aaaand that's the whole page, bestie β€” no crumbs left, I promise. πŸ“

kisses, this has been nix3-nar-dump-path(1) from the Nix manual, part of the General Commands Manual set, and it's giving ✨experimental✨ energy forever until they change it. byeeee πŸ§šπŸ’–

πŸ“¦ where this page comes from