nix3-store-ls(1)

🌸 nix3-store-ls(1) 🌸

ok so bestie, this is a page from the General Commands Manual and it's literally all about snooping on stuff in the Nix store. pull up a chair, we're doing this πŸ’–

⚠️ Warning ⚠️ This program is experimental and its interface is subject to change. no cap. it might get a glow-up and change on you, so don't get too attached to the exact vibes, ok?

✨ Name ✨

nix store ls β€” show information about a path in the Nix store 🫢


✨ Synopsis ✨

nix store ls [option…] path

✨ Examples ✨

  • To list the contents of a store path in a binary cache πŸ’…
# nix store ls --store https://cache.nixos.org/ --long --recursive /nix/store/qbhyj3blxpw2i6pb7c6grc9185nbnpvy-hello-2.10
dr-xr-xr-x                    0 ./bin
-r-xr-xr-x                38184 ./bin/hello
dr-xr-xr-x                    0 ./share
…
  • To show information about a specific file in a binary cache πŸ”₯
# nix store ls --store https://cache.nixos.org/ --long /nix/store/qbhyj3blxpw2i6pb7c6grc9185nbnpvy-hello-2.10/bin/hello
-r-xr-xr-x                38184 hello

✨ Description ✨

This command shows information about path in a Nix store. and path? it can be a top-level store path or any file inside a store path. so like, the whole entire thing or just one lil file chilling inside it. iconic flexibility honestly πŸ‘‘


✨ Options ✨

  • --directory, -d β€” show directories rather than their contents. like, we're looking at the folder itself, not what's inside it πŸŽ€
  • --json β€” produce output in JSON format, suitable for consumption by another program. feeding the robots, we love that for you πŸ€–
  • --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.
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. we're going alllll the way down πŸ•³οΈ
  • --debug β€” set the logging verbosity level to β€˜debug’. maximum yapping about what's happening πŸ”
  • --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 bestie πŸ—£οΈ

🧚 Miscellaneous global options 🧚

  • --help β€” show usage information.
  • --offline β€” disable substituters and consider all previously downloaded files up-to-date. airplane mode but make it Nix ✈️
  • --option name value β€” set the Nix configuration setting name to value (overriding nix.conf).
  • --refresh β€” consider all previously downloaded files out-of-date. spicy, we're re-checking everything πŸ”„
  • --version β€” show version information.
Note See man nix.conf for overriding configuration settings with command line flags.

and that's the whole page, periodt πŸ’œ this was nix3-store-ls(1) from the General Commands Manual β€” go forth and ls the store, you absolute main character ✨🌸

πŸ“¦ where this page comes from