From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: guix-gc Date: Sun, 06 Jan 2013 00:57:00 +0100 Message-ID: <8738yfp4j7.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:39163) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Trdbs-0007fy-I4 for bug-guix@gnu.org; Sat, 05 Jan 2013 18:57:05 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Trdbr-0005tc-6Q for bug-guix@gnu.org; Sat, 05 Jan 2013 18:57:04 -0500 Received: from mail4-relais-sop.national.inria.fr ([192.134.164.105]:15838) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Trdbq-0005tP-W9 for bug-guix@gnu.org; Sat, 05 Jan 2013 18:57:03 -0500 List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org To: bug-guix@gnu.org Commit fe8ff02 adds a =E2=80=98guix-gc=E2=80=99 command to invoke the GC, s= imilar to part of the =E2=80=98nix-store=E2=80=99 command. Below is a copy of the ma= nual. Comments welcome! Ludo=E2=80=99. Packages that are installed but not used may be "garbage-collected". The `guix-gc' command allows users to explicitly run the garbage collector to reclaim space from the `/nix/store' directory. The garbage collector has a set of known "roots": any file under `/nix/store' reachable from a root is considered "live" and cannot be deleted; any other file is considered "dead" and may be deleted. The set of garbage collector roots includes default user profiles, and may be augmented with `guix-build --root', for example (*note Invoking guix-build::). The `guix-gc' command has three mode of operations: it can be used to garbage-collect any dead files (the default), to delete specific files (the `--delete' option), or to print garbage-collector information. The available options are listed below: `--collect-garbage[=3DMIN]' `-C [MIN]' Collect garbage--i.e., unreachable `/nix/store' files and sub-directories. This is the default operation when no option is specified. When MIN is given, stop once MIN bytes have been collected. MIN may be a number of bytes, or it may include a unit as a suffix, such as `MiB' for mebibytes and `GB' for gigabytes. When MIN is omitted, collect as much garbage as possible. `--delete' `-d' Attempt to delete all the store files and directories specified as arguments. This fails if some of the files are not in the store, or if they are still live. `--list-dead' Show the list of dead files and directories still present in the store--i.e., files and directories no longer reachable from any root. `--list-live' Show the list of live store files and directories.