lix/src/nix/log.md

R""(

**Note:** this command's interface is based heavily around [*installables*](./nix.md#installables), which you may want to read about first (`nix --help`).

# 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.

)""
Add 'nix log' manpage 2020-12-09 12:41:47 +00:00			`R""(`

docs: guide to installables docs in installable commands' docs The installables syntax is not documented in any of the man pages or docbook pages for any of those individual commands. And while these commands really should at least peripherally individually document how installables work, in the meantime we can at least direct people to the right place. This commit also clarifies the unexpected fact that `nix profile remove` and `nix profile upgrade` do not take installables. Change-Id: I3b1453cb197a613bbab639c66a466365c3592c6d 2024-04-29 13:39:10 +00:00			Note: this command's interface is based heavily around [installables](./nix.md#installables), which you may want to read about first (`nix --help`).

Add 'nix log' manpage 2020-12-09 12:41:47 +00:00			`# 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`

clarify definition of "installable" the term was hard to discover, as its definition and explanation were in a very long document lacking an overview section. search did not help because it occurs so often. - clarify wording in the definition - add an overview of installable types - add "installable" to glossary - link to definition from occurrences of the term - be more precise about where store derivation outputs are processed - installable Nix expressions must evaluate to a derivation Co-authored-by: Adam Joseph <54836058+amjoseph-nixpkgs@users.noreply.github.com> 2022-12-01 00:57:02 +00:00			`This command prints the log of a previous build of the [installable](./nix.md#installables) on standard output.`
Add 'nix log' manpage 2020-12-09 12:41:47 +00:00
			`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.

			`)""`