From Gentoo Wiki
Jump to:navigation Jump to:search

The pkgcore configuration files support various formats, default is the ini syntax.

Each section has an associated class which defines the scope of the section. We will structure the following by these classes.


Class: pkgcore.ebuild.domain.domain

This is the fundamental configuration object. A domain provides all configuration options (mostly by reference onto other configuration objects). By providing multiple domains these can be selected at runtime.

Important attributes:

  • default (boolean, e.g. True)
  • root (string, e.g. '/' )
  • fetcher (reference)
  • profile (reference)
  • repositories (references)
  • triggers (references)
  • vdb (reference)


Classes: pkgcore.fetch.base.fetcher and pkgcore.fetch.custom.fetcher

Configure how to obtain distfiles and where to store them.


Classes: pkgcore.ebuild.profile.ProfileStack and pkgcore.ebuild.profile.OnDiskProfile

Configure location of profiles and which is applicable. These can be combined out multiple sources.


Classes: pkgcore.ebuild.repository.tree, pkgcore.ebuild.repository.slavedtree, pkgcore.binpkg.repository.tree

Metaobject for repositories. We have different flavors: ebuild.repository.tree is for the Gentoo tree, slavedtree is for overlays and binpkg.repository.tree is for prebuilt package instances (the last one is pretty much like a raw repo).

Important attributes:

  • cache (references, not binpkg.repository.tree)
  • raw_repo (reference, not binpkg.repository.tree)
  • parent_repo (reference, only for slavedtree)


Classes: pkgcore.cache.flat_hash.md5_cache and pkgcore.cache.flat_hash.database

Configure nature and location of caches. These are used for lookup of metadata and similar.

Raw Repository

Class: pkgcore.ebuild.repo_objs.RepoConfig

Configure location. This is the bare repository.

Important attributes:

  • syncer (reference)

Class: pkgcore.sync.base.AutodetectSyncer and pkgcore.sync.rsync.rsync_timestamp_syncer

Configure how to sync a repository.


Class: pkgcore.vdb.ondisk.tree

Configure location of the current system state.