aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/package-management/garbage-collection.md
diff options
context:
space:
mode:
authorEelco Dolstra <edolstra@gmail.com>2020-07-31 15:43:25 +0200
committerEelco Dolstra <edolstra@gmail.com>2020-07-31 15:43:25 +0200
commit1d0a7b54fa330b041a720932ee4e05dcad1d2d5c (patch)
tree48627a3530e4d6d58c612864b2e99afb11a0a902 /doc/manual/src/package-management/garbage-collection.md
parent0c94c176446bd9e9cb8c7e16fb7c6d88bb4e9a20 (diff)
Enable syntax highlighting
Diffstat (limited to 'doc/manual/src/package-management/garbage-collection.md')
-rw-r--r--doc/manual/src/package-management/garbage-collection.md24
1 files changed, 18 insertions, 6 deletions
diff --git a/doc/manual/src/package-management/garbage-collection.md b/doc/manual/src/package-management/garbage-collection.md
index 4c8799dfe..fecb30fd6 100644
--- a/doc/manual/src/package-management/garbage-collection.md
+++ b/doc/manual/src/package-management/garbage-collection.md
@@ -18,23 +18,31 @@ be done if you are certain that you will not need to roll back.
To delete all old (non-current) generations of your current profile:
- $ nix-env --delete-generations old
+```console
+$ nix-env --delete-generations old
+```
Instead of `old` you can also specify a list of generations, e.g.,
- $ nix-env --delete-generations 10 11 14
+```console
+$ nix-env --delete-generations 10 11 14
+```
To delete all generations older than a specified number of days (except
the current generation), use the `d` suffix. For example,
- $ nix-env --delete-generations 14d
+```console
+$ nix-env --delete-generations 14d
+```
deletes all generations older than two weeks.
After removing appropriate old generations you can run the garbage
collector as follows:
- $ nix-store --gc
+```console
+$ nix-store --gc
+```
The behaviour of the gargage collector is affected by the
`keep-derivations` (default: true) and `keep-outputs` (default: false)
@@ -47,7 +55,9 @@ sense to keep outputs to ensure that rebuild times are quick.) If you
are feeling uncertain, you can also first view what files would be
deleted:
- $ nix-store --gc --print-dead
+```console
+$ nix-store --gc --print-dead
+```
Likewise, the option `--print-live` will show the paths that *won’t* be
deleted.
@@ -56,6 +66,8 @@ There is also a convenient little utility `nix-collect-garbage`, which
when invoked with the `-d` (`--delete-old`) switch deletes all old
generations of all profiles in `/nix/var/nix/profiles`. So
- $ nix-collect-garbage -d
+```console
+$ nix-collect-garbage -d
+```
is a quick and easy way to clean up your system.