Glossary

Atom

The way a package is written: category/name, optionally with a version (>=www-servers/nginx-1.26).

Binary repository

A place that keeps built, signed packages. Yours is written to by your builds; others are only read from.

Build

See package build.

CVE

A numbered public record of a security weakness. An advisory covers one or more.

Config

A Portage config: the settings for how packages are built.

Container image

A package of a program and what it needs, run by Docker or Podman. kaji builds one from a root filesystem.

Ebuild

Gentoo’s recipe for one package: where its source is, how to build it, what it needs.

Entrypoint

The program a container runs when it starts; its arguments are the cmd.

GLSA

Gentoo Linux Security Advisory: Gentoo’s notice that some versions of a package are vulnerable and which version fixes it.

Job

One unit of work kaji runs: it builds one or more packages, copies some, or makes an image.

Lock file

The exact list of everything installed in a root filesystem, with versions and where each came from.

Organization

The owner of resources. People belong to one or more, each with a role (owner, member, viewer).

Package build

A request: these packages, from this tree, published to this repository.

Plan

What kaji works out before building: every package needed, what can be reused, and the order to build the rest in.

Portage tree

Gentoo’s collection of ebuilds. The tree of a given day determines the versions you get.

Public

Visible to everybody, read-only.

Pull from

Take ready-made packages from another repository instead of compiling them.

Pull-through

Copy what is pulled into your own repository too, so it holds everything it needs.

Registry

A server that keeps container images.

Root filesystem

The finished packages installed into an empty directory, saved as a tarball.

Signing key

A GPG key whose signature on a package proves it came from you.

Upload proxy

The small service in front of a binary repository that receives packages from build jobs and signs them.

USE flag

A switch for a feature of a package, such as X or systemd; a - in front turns it off.