BKR-TASK-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

✨ BKR-TASK-LIST ✨

okay so bestie, welcome to bkr-task-list — it's a Beaker manual page (that's the Beaker manual, section 1) and honestly it's giving very much "let me show you what's in the task library" 💅

🌸 NAME 🌸

bkr-task-list — literally just lists out the tasks chillin' in Beaker's task library 🎀

🦋 SYNOPSIS 🦋

bkr task-list [options]
  [--type <type> ...] [--package <package> ...] [--distro <name>]
  [--xml [--params <name>=<value> ...]]

like, that's the whole vibe. copy it exactly, don't @ me 😭

💖 DESCRIPTION 💖

It prints a list of the tasks in the Beaker task library that match whatever you asked for, straight to stdout. that's it. that's the whole thing. slay ✨

👑 OPTIONS 👑

  • --type <type> — only show you tasks of type <type>. this maps to the Type: field in the task metadata, and also the Type on the task page in Beaker's web UI 🫶

you can pass this more than once, and then it's an "or" situation — a task gets listed if it matches any of the types you gave. periodt.

  • --package <package> — only show tasks that apply to <package>. this one maps to the RunFor: field in the task metadata, and the Run For field on the task page in Beaker's web UI 🌈

same deal, you can pass it more than once and it's an "or" — a task gets listed if it applies to any of the packages. no cap.

  • --destructive — only show tasks that are destructive. > heads up: this excludes both non-destructive tasks AND unmarked tasks. like, it's strict. 💀
  • --non-destructive — only show tasks that are non-destructive. > same energy: this excludes both destructive tasks AND unmarked tasks. 🙈
  • --distro <name> — only show tasks that apply to the distro <name> 🍓
  • --xml — output the task listing as XML, with one <task/> element per task. this output is suitable for inclusion inside the <tasks/> element of a Beaker XML job — iykyk, it just drops right in 🔥
  • --params <name>=<value> — when you pass --xml, this makes a <param/> element get added inside each <task/> element. cute little nesting moment 🧚

also!! the common bkr options are described in the Options section of bkr(1) — go peek at that one too bestie 💜

⭐ EXIT STATUS ⭐

Non-zero if something goes wrong, otherwise zero. simple as that 💅

🌸 EXAMPLES 🌸

wanna list every regression test that applies to the apache or tomcat6 packages? say less:

bkr task-list --type=Regression --package=apache --package=tomcat6

look at her go 🎀

🦋 HISTORY 🦋

before version 0.9, this command accepted --install_name instead of --distro. yeah. ancient lore. consider yourself educated 👑

💜 SEE ALSO 💜

🫶 AUTHOR 🫶

The Beaker team <beaker-devel@lists.fedorahosted.org> — icons, honestly 🌟

2013-2025 Red Hat, Inc.

and that's the whole page, bestie 💖 this was version 29.2, dated May 26, 2025, straight from Beaker — mwah, go list some tasks 🧚✨

📦 where this page comes from