nix3-store...-trace-info(1)

📦 version 2.35.3, in fedora 44

🎀 Name 🎀

okay bestie, welcome to the manual for nix store build-trace info — literally it's the glow-up command that lets you query information about one or several build traces. That's it. That's the job. It's part of the General Commands Manual collection, so you know it's official 💅

⚠️ Warning — this program is experimental and its interface is subject to change. Not me being dramatic, that's just facts. Don't build your whole personality on it staying the same, fr fr 😭

✨ Synopsis ✨

nix store build-trace info [option…] installables…

yes that really is the whole thing. Options first, installables after, go off 👑

🦋 Description 🦋

It displays some information about the given build trace. That's the vibe. You hand it a trace, it hands you the details. Simple as. No cap.

🌸 Examples 🌸

Show some information about the build trace of the hello package:

$ nix store build-trace info nixpkgs#hello --json
[{"id":"sha256:3d382378a00588e064ee30be96dd0fa7e7df7cf3fbcace85a0e7b7dada1eef25!out","outPath":"fd3m7xawvrqcg98kgz5hc2vk3x9q0lh7-hello"}]

see how it just hands you the JSON?? iconic behaviour honestly 🫶

💖 Options 💖

  • --json — Produce output in JSON format, suitable for consumption by another program. Feed it to your script bestie, it's not just for human eyeballs.
  • --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. So don't be out here using it solo, it needs its partner ✨

  • --stdin — Read installables from the standard input. No default installable applied. Pipe it in, queen.

🌈 Common evaluation options

  • --arg name expr — Pass the value expr as the argument name to Nix functions.
  • --arg-from-file name path — Pass the contents of file path as the argument name to Nix functions.
  • --arg-from-stdin name — Pass the contents of stdin as the argument name to Nix functions.
  • --argstr name string — Pass the string string as the argument name to Nix functions.
  • --debugger — Start an interactive environment if evaluation fails. It's giving "second chance energy" 😌
  • --eval-store store-url — The URL of the Nix store to use for evaluation, i.e. to store derivations (.drv files) and inputs referenced by them.
  • --impure — Allow access to mutable paths and repositories. chaotic, but make it consensual.
  • --include / -I path — Add path to search path entries used to resolve lookup paths.

This option may be given multiple times. Stack 'em up, bestie.

Paths added through -I take precedence over the nix-path configuration setting and the NIX_PATH environment variable.

  • --override-flake original-ref resolved-ref — Override the flake registries, redirecting original-ref to resolved-ref.
  • --commit-lock-file — Commit changes to the flake's lock file. yes queen, commit it, make it official 💅
  • --inputs-from flake-url — Use the inputs of the specified flake as registry entries.
  • --no-registries — Don't allow lookups in the flake registries.
DEPRECATED — Use --no-use-registries instead. bestie it's old, move on, we don't use that anymore 🙈
  • --no-update-lock-file — Do not allow any updates to the flake's lock file. frozen. locked in. literally.
  • --no-write-lock-file — Do not write the flake's newly generated lock file.
  • --output-lock-file flake-lock-path — Write the given lock file instead of flake.lock within the top-level flake.
  • --override-input input-path flake-url — Override a specific flake input (e.g. dwarffs/nixpkgs). The input path must not be empty. This implies --no-write-lock-file.
  • --recreate-lock-file — Recreate the flake's lock file from scratch.
DEPRECATED — Use nix flake update instead. again, deprecated, we don't do that here ✋
  • --reference-lock-file flake-lock-path — Read the given lock file instead of flake.lock within the top-level flake.
  • --update-input input-path — Update a specific flake input (ignoring its previous entry in the lock file).
DEPRECATED — Use nix flake update instead. same warning, same energy 😭
  • --debug — Set the logging verbosity level to 'debug'. maximum yap mode, but for logs.
  • --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.
  • --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. everything is stale, do not trust a single file, drama!! 🔥
  • --repair — During evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths. healing era 💖
  • --version — Show version information.

🍓 Options that change the interpretation of installables

  • --all — Apply the operation to every store path. all of them. every single one. no crumbs left.
  • --derivation — Operate on the store derivation rather than its outputs.
  • --expr expr — Interpret installables as attribute paths relative to the Nix expression expr.
  • --file / -f file — Interpret installables as attribute paths relative to the Nix expression stored in file. If file is the character -, then a Nix expression is read from standard input. Implies --impure.
  • --recursive / -r — Apply operation to closure of the specified paths.
Note — See man nix.conf for overriding configuration settings with command line flags.

and that's the whole page, bestie!! you understood all of it, I know you did, we ate that 💅

this was the nix3-store...-trace-info(1) page from the General Commands Manual — go forth and trace those builds, you gorgeous genius 🦋✨

📦 where this page comes from