summaryrefslogtreecommitdiff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2018-03-27 14:16:19 +0200
committerLudovic Courtès <ludo@gnu.org>2018-03-27 14:51:44 +0200
commit8980eea5ab6f89e7649d9abf0be2a9d49156f7d2 (patch)
tree4f9788709a42f67bd11117b4b91660454b128eca /doc/guix.texi
parentb06a70e05dc6252a3ecb28db5898de7ebc110973 (diff)
downloadpatches-8980eea5ab6f89e7649d9abf0be2a9d49156f7d2.tar
patches-8980eea5ab6f89e7649d9abf0be2a9d49156f7d2.tar.gz
guix gc: Add '--derivers'.
* guix/scripts/gc.scm (show-help, %options): Add '--derivers'. (guix-gc): Handle 'list-derivers'. * tests/guix-gc.sh: Add test. * doc/guix.texi (Invoking guix gc): Document it.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 2204285516..c37a87d5a1 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2642,6 +2642,24 @@ of these, recursively. In other words, the returned list is the
of an element. @xref{Invoking guix graph}, for a tool to visualize
the graph of references.
+@item --derivers
+@cindex derivation
+Return the derivation(s) leading to the given store items
+(@pxref{Derivations}).
+
+For example, this command:
+
+@example
+guix gc --derivers `guix package -I ^emacs$ | cut -f4`
+@end example
+
+@noindent
+returns the @file{.drv} file(s) leading to the @code{emacs} package
+installed in your profile.
+
+Note that there may be zero matching @file{.drv} files, for instance
+because these files have been garbage-collected. There can also be more
+than one matching @file{.drv} due to fixed-output derivations.
@end table
Lastly, the following options allow you to check the integrity of the