nix-super/src/nix/derivation-show.md
John Ericson 043135a848 Document file system object content addressing
In addition:

- Take the opportunity to add a bunch more missing hyperlinks, too.

- Remove some glossary entries that are now subsumed by dedicated pages.
  We used to not be able to do this without breaking link fragments, but
  now we can, so pick up where we left off.

Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
2024-05-15 16:28:48 -04:00

1.5 KiB

R""(

Examples

  • Show the store derivation that results from evaluating the Hello package:

    # nix derivation show nixpkgs#hello
    {
      "/nix/store/s6rn4jz1sin56rf4qj5b5v8jxjm32hlk-hello-2.10.drv": {
      }
    }
    
  • Show the full derivation graph (if available) that produced your NixOS system:

    # nix derivation show -r /run/current-system
    
  • Print all files fetched using fetchurl by Firefox's dependency graph:

    # nix derivation show -r nixpkgs#firefox \
      | jq -r '.[] | select(.outputs.out.hash and .env.urls) | .env.urls' \
      | uniq | sort
    

    Note that .outputs.out.hash selects fixed-output derivations (derivations that produce output with a specified content hash), while .env.urls selects derivations with a urls attribute.

Description

This command prints on standard output a JSON representation of the store derivations to which installables evaluate.

Store derivations are used internally by Nix. They are store paths with extension .drv that represent the build-time dependency graph to which a Nix expression evaluates.

By default, this command only shows top-level derivations, but with --recursive, it also shows their dependencies.

nix derivation show outputs a JSON map of store paths to derivations in the following format:

{{#include ../../protocols/json/derivation.md}}

)""