koji-cancel

Cancel a task by its ID

$ koji cancel [task_id]

$ koji cancel [task_id1 task_id2 ...]

$ koji cancel --verbose [task_id]

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

koji-cancel taskid [taskid ...]

-h, --help
    Show help message and exit

The koji-cancel command is part of the Koji client toolkit, a distributed system for building RPM packages used by Fedora, CentOS, and other RPM-based distributions.

It enables authenticated users to cancel one or more pending or active build tasks identified by their task IDs. Koji tasks represent build jobs queued on the Koji hub and executed by builders. Canceling a task stops its execution if running or removes it from the queue if pending.

Users must have appropriate permissions, typically task owners or Koji administrators. The command communicates with the Koji hub via XML-RPC, requiring prior login with koji login. Upon success, it reports the canceled tasks; failures occur due to permissions, invalid IDs, or hub connectivity issues.

This tool is essential for managing build pipelines, preventing resource waste on faulty or obsolete tasks. It integrates with other Koji commands for task monitoring and retrying.

Requires prior koji login authentication.
Can only cancel owned tasks or with admin privileges.
Running tasks may not stop immediately if builder ignores signal.

koji-cancel 12345
Cancels single task.

koji-cancel 12345 12346 12347
Cancels multiple tasks.

0 on success, non-zero on failure (e.g., invalid task, permissions).

Koji originated in Fedora Infrastructure around 2007 as a mock-based build system replacement. The client, including koji-cancel, evolved through versions, with major updates in Koji 1.10+ adding better task management. Widely adopted in EPEL, RHEL, and Mageia.

koji(1), koji-list(1), koji-retry(1), koji-wait(1)