koji-taginfo

Print basic information

$ koji taginfo [tag1 tag2 ...]

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

koji-taginfo [options] <tag_name> [<tag_name> ...]

Explanation:

• koji-taginfo: The command itself.
• [options]: Optional flags that modify the command's behavior.
• <tag_name>: The name of the Koji tag for which to retrieve information. Multiple tag names can be specified, separated by spaces.

<tag_name>
    The name of the Koji tag (or tags) for which to retrieve detailed information. Multiple tags can be specified as positional arguments.

-h, --help
    Show the help message and exit.

--debug
    Enable debug output, providing more verbose information for troubleshooting.

--config <file>
    Specify an alternate Koji configuration file to use instead of the default.

--server <url>
    Specify the Koji XML-RPC server URL to connect to.

--weburl <url>
    Specify the Koji web interface URL.

--topurl <url>
    Specify the Koji top URL, often used for content and repository access.

--login
    Force a new login session, discarding any existing session tokens.

--session <id>
    Use a specific Koji session ID for authentication.

--json
    Output the tag information in JSON format, suitable for scripting and programmatic parsing.

The koji-taginfo command is a Koji client utility used to retrieve and display detailed information about one or more specified Koji tags.

Koji tags are fundamental to the Koji build system, representing specific points in a build process, such as a release branch, a development stream, or an architecture-specific grouping. This command allows users to inspect a tag's attributes, including its name, ID, creation time, associated event IDs, and parent/child tag relationships.

It's an essential tool for system administrators, release engineers, and developers who need to understand the configuration and hierarchy of tags within their Koji instance, troubleshoot build assignments, or verify tag settings. The output helps in managing build policies, ensuring proper inheritance of buildroots, and maintaining a clear overview of the build environment.

The koji-taginfo command requires the Koji client tools to be properly installed and configured.
Network connectivity to the Koji hub server is essential for its operation. Users must have the necessary permissions within Koji to access and view the requested tag information; otherwise, an authentication or authorization error may occur.
The exact output format and the level of detail provided can sometimes vary slightly depending on the specific Koji server version and its configuration.

To get information about a single tag named f24-build:

koji-taginfo f24-build

koji-taginfo --json f25-candidate f26-master

koji-taginfo --debug some-tag

Koji tags often form a hierarchical structure, where child tags inherit properties from parent tags. The information provided by koji-taginfo helps in understanding these inheritance chains, which is crucial for determining how buildroots are composed and how builds are promoted through different stages (e.g., from rawhide to a specific release tag).

koji(1), koji list-tags(1), koji add-tag(1), koji edit-tag(1), koji remove-tag(1)