BKR-JOB-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 bkr-job-list(1) — the Beaker manual page, bestie edition

okay so this is bkr-job-list from the Beaker gang, and it's genuinely one of my fave little tools because it does exactly one thing and does it cute. Buckle up, we're listing jobs. 🎀

✨ NAME ✨

bkr-job-list — literally just lists Beaker jobs for you 🫶

🌸 SYNOPSIS 🌸

bkr job-list [options]
  [--family <family>] [--tag <tag>] [--product <cpeid>] [--completeDays <days>]

That's the whole vibe check: the command, then a pile of optional flags you can stack up however you like. 🌈

🦋 DESCRIPTION 🦋

It prints a list of matching Beaker jobs to stdout. That's it, that's the main character energy. ✨

💖 OPTIONS 💖

  • --family <family> — only show jobs that ran with a distro belonging to <family>. Example that's burned into my brain: RedHatEnterpriseLinuxServer5. 🐧
  • --completeDays <days> — only show jobs that finished at least <days> ago. So it's like "give me the old ones, the ones that have had time to marinate" 💅
  • --tag <tag> — only show jobs that have retention tag <tag>, for example scratch.
  • --product <cpeid> — only show jobs that were testing the product identified by <cpeid>.
  • --owner <username> — only show jobs owned by the user identified by <username>.
  • --whiteboard <string> — only show jobs whose whiteboard contains <string>.
  • --mine — if --mine is present, that's the same thing as throwing your own username into --owner. Self-explanatory slay 🫶
  • --limit <number> — only display the first <number> of results. Anti-scroll-forever technology.
  • --min-id id — query jobs with a minimum Job ID of id.
  • --max-id id — query jobs with a max Job ID of id.
  • --finished — only show jobs that are finished (Completed, Aborted, or Cancelled). A finished job has hit its final state and will not change in future. Periodt, it's done, no take-backs. ⭐
  • --unfinished — only show jobs that are not finished. The opposite of above, bestie.
  • --format <format> — display results in the given format, either list or json. Here's the tea: the list format lists one job ID per line, and it's genuinely perfect for feeding as input to other command line utilities. The default format is json, which returns the job IDs as a JSON array and is compact — super useful for quick human observation. 👀

Common bkr options are described in the Options section of bkr(1). Go read the mothership page, iykyk.

🌟 EXIT STATUS 🌟

Non-zero on error, otherwise zero. Clean and simple, no drama. ✨

🎀 EXAMPLES 🎀

List all scratch jobs which finished 30 or more days ago:

bkr job-list --tag scratch --completeDays 30

List all scratch jobs with IDs between 10-100:

bkr job-list --tag=scratch --min-id=10 --max-id=100

List all scratch jobs with min ID of 10:

bkr job-list --tag=scratch --min-id=10

Look at those. Chef's kiss. 🤌

👑 SEE ALSO 👑

  • bkr(1) — the big one, the icon, the blueprint.

💀 AUTHOR 💀

The Beaker team <beaker-devel@lists.fedorahosted.org> 🫶

2013-2025 Red Hat, Inc.

ngl, the whole time you were reading this I was just vibing. now go list some jobs, bestie. 🍓

okay that's the page!! this lovely lil manual is from Beaker, version 29.2, dated May 26, 2025 — like, timestamped and everything. mwah. 💜

📦 where this page comes from