Home Explore Blog CI



nix

1st chunk of `src/nix/log.md`
423d17a97fedf624601e485f74cd7ac3c94e912523c38c540000000100000400
R""(

# Examples

* Get the build log of GNU Hello:

  ```console
  # nix log nixpkgs#hello
  ```

* Get the build log of a specific store path:

  ```console
  # nix log /nix/store/lmngj4wcm9rkv3w4dfhzhcyij3195hiq-thunderbird-52.2.1
  ```

* Get a build log from a specific binary cache:

  ```console
  # nix log --store https://cache.nixos.org nixpkgs#hello
  ```

# Description

This command prints the log of a previous build of the [*installable*](./nix.md#installables) on standard output.

Nix looks for build logs in two places:

* In the directory `/nix/var/log/nix/drvs`, which contains logs for
  locally built derivations.

* In the binary caches listed in the `substituters` setting. Logs
  should be named `<cache>/log/<base-name-of-store-path>`, where
  `store-path` is a derivation,
  e.g. `https://cache.nixos.org/log/dvmig8jgrdapvbyxb1rprckdmdqx08kv-hello-2.10.drv`.
  For non-derivation store paths, Nix will first try to determine the
  deriver by fetching the `.narinfo` file for this store path.

)""

Title: Nix Log Command: Usage and Functionality
Summary
The `nix log` command retrieves and prints the build log of a specified installable or store path. It searches for logs in the local `/nix/var/log/nix/drvs` directory and in binary caches listed in the `substituters` setting, using the store path to locate the relevant log file. Examples of usage are provided, including retrieving logs from specific binary caches.