* Some GC documentation.

This commit is contained in:
Eelco Dolstra 2005-04-05 11:30:56 +00:00
parent 6c8cf567b8
commit 229252941a
2 changed files with 52 additions and 42 deletions

View file

@ -57,16 +57,6 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><option>--min-age</option> <replaceable>age</replaceable></term>
<listitem>
<para>
This option corresponds to the <option>--min-age</option>
option in <command>nix-store <option>--gc</option></command>.
</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</refsection> </refsection>

View file

@ -167,24 +167,37 @@ output.</para>
<title>Description</title> <title>Description</title>
<para> <para>
The operation <option>--gc</option> performs a garbage Without additional flags, the operation <option>--gc</option>
collection on the Nix store. What it does specifically is performs a garbage collection on the Nix store. That is, all
determined by the sub-operation, which is one of the paths in the Nix store not reachable via file system
following: references from a set of <quote>roots</quote>, are deleted.
</para>
<para>
The following flags may be specified:
</para> </para>
<variablelist> <variablelist>
<varlistentry>
<term><option>--print-roots</option></term>
<listitem>
<para>
This operation prints on standard output the set of
roots used by the garbage collector.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><option>--print-live</option></term> <term><option>--print-live</option></term>
<listitem> <listitem>
<para> <para>
This operation prints on standard output the set of This operation prints on standard output the set of
<quote>live</quote> store paths, which are all the store <quote>live</quote> store paths, which are all the store
paths reachable from a set of <quote>root</quote> store paths reachable from the roots. Live paths should never
expressions read from standard input. Live paths should be deleted, since that would break consistency — it
never be deleted, since that would break consistency — would become possible that applications are installed
it would become possible that applications are installed
that reference things that are no longer present in the that reference things that are no longer present in the
store. store.
</para> </para>
@ -215,29 +228,36 @@ output.</para>
</variablelist> </variablelist>
<para> </refsection>
The set of root store expressions is read from standard input.
Each line should contain exactly one store path.
</para>
<para> <refsection>
The option <option>--min-age</option> specifies a minimum time <title>Roots</title>
in hours that an unreachable store path must not have been
used before it is considered dead. The default is 0 (consider
all unreachable store paths dead). Whether a store path has
been used is determined by looking at its access time
(<literal>atime</literal>), so this does not work if the store
is located on a file system that has the
<literal>noatime</literal> option set.
</para>
<warning> <para>The roots of the garbage collector are all store paths to
<para> which there are symlinks in the
You generally will want to use the command directory <filename><replaceable>prefix</replaceable>/nix/var/nix/gcroots</filename>.
<command>nix-collect-garbage</command>, which figures out For instance, the following command makes the
the roots and then calls this command automatically. path <filename>/nix/store/d718ef...-foo</filename> a root of
</para> the collector:
</warning>
<screen>
$ ln -s /nix/store/d718ef...-foo /nix/var/nix/gcroots/bar</screen>
That is, after this command, the garbage collector will not
remove <filename>/nix/store/d718ef...-foo</filename> or any of
its dependencies.</para>
<para>Subdirectories
of <filename><replaceable>prefix</replaceable>/nix/var/nix/gcroots</filename>
are also searched for symlinks. Symlinks to non-store paths are
followed and searched for roots, but TODO.</para>
</refsection>
<refsection>
<title>Configuration file</title>
<para>TODO</para>
</refsection> </refsection>