LinuxCommandLibrary

koji-taginfo

Display Koji tag information

TLDR

Print basic information

$ koji taginfo [tag1 tag2 ...]
copy

Display help
$ koji taginfo [[-h|--help]]
copy

SYNOPSIS

koji taginfo [options] <tagname>

PARAMETERS

--builds
    List recent builds in the tag

--effective
    Show effective inheritance (including parents)

--extra
    Display extra tag details like arches, Maven

--help
    Show usage help

--packages
    List packages allowed to build in tag

--perms
    List permissions associated with the tag

--quiet
    Reduce output verbosity

--server <URL>
    Specify Koji hub URL

--users
    List users with tag permissions

--verbose
    Increase output detail

--cfg <FILE>
    Use alternate config file

--proxy <FILE>
    Path to web proxy cert

DESCRIPTION

Koji is a distributed system for building and tracking RPMs, used by Fedora, CentOS, and others. Tags in Koji define build environments or repositories, specifying package lists, inheritance from parent tags, permissions, and more.

The koji taginfo command fetches and prints comprehensive details about a given tag. Core output includes tag ID, name, parent, active status, strict inheritance, creation/modification dates, owner, and mock configuration. It helps admins and developers verify tag setups for builds, promotions, or troubleshooting.

Options extend output to recent builds, package allowlists, user/permission lists, effective inheritance chains (resolving parents recursively), or extra metadata like arches and Maven support. Requires Koji client authentication via <tt>koji></tt> cert/key or session.

CAVEATS

Requires authenticated session for full details. Output depends on user permissions. Some options fetch large lists; use judiciously on busy hubs.

EXAMPLE USAGE

koji taginfo f39 <br>koji taginfo --builds --packages f39-updates

OUTPUT FIELDS

Key fields: ID, Name, Parent, Active (Y/N), Strict (Y/N), Inherit (Y/N), Locked (Y/N), CreateTS, ModifyTS, Owner.

HISTORY

Introduced in early Koji versions (~2007) as part of Fedora's build farm tools. Evolved with Koji 1.x releases; options like --effective added for complex tag trees.

SEE ALSO

koji(1), koji-taglist(1), koji-list-builds(1), koji-build(1)

Copied to clipboard