aboutsummaryrefslogtreecommitdiff
path: root/doc/configuration/repositories/vdb.html.part
blob: 722c7b1bdbf15e60790a362e752202c5337fd9b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<!-- vim: set tw=120 ft=html sw=4 sts=4 et : -->

<h1>vdb Repository Format</h1>

<p>The <code>vdb</code> repository format is used on Gentoo and derived distributions to track packages installed from
an ebuild. It is not used on Exherbo; <a href="exndbam.html">exndbam</a> serves the equivalent purpose there.</p>

<p>As well as the <a href="index.html">general keys supported for all repositories</a>, the following keys have meaning
for <code>vdb</code> format repositories:</p>

<dl>
    <dt><code>location</code></dt>
    <dd>The location of the repository. Mandatory. On Gentoo systems, this must be <code>${root}/var/db/pkg</code> to
    avoid problems with broken ebuilds that illegally access the VDB.</dd>

    <dt><code>provides_cache</code></dt>
    <dd>The file to use for reading and writing a cache of providers of old-style virtuals. See <a
        href="../../overview/gettingstarted.html">Getting Started</a> for notes. Optional, set to <code>/var/empty</code>
    to disable.</dd>

    <dt><code>names_cache</code></dt>
    <dd>The directory in which to look for a names cache, and in which to generate a names cache. A names cache will
    significantly speed up converting a <code>pkg</code> into a <code>cat/pkg</code>. See <a
        href="../../overview/gettingstarted.html">Getting Started</a> for notes. Optional, set to <code>/var/empty</code>
    to disable.</dd>

    <dt><code>builddir</code></dt>
    <dd>The directory to use when 'building' a package for an uninstall (a temporary directory is needed for various
    operations). Optional.</dd>
</dl>