BKR-POLICY-LIST(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 BKR-POLICY-LIST — like, the manual page, but make it make sense ✨

okay bestie, welcome to bkr-policy-list (that's the manual name, part of the Beaker squad 🧚, section 1). She lists access policy rules for a system. That's literally it. That's her whole job. And honestly? She ate. 💅

✨ NAME ✨

bkr-policy-list — lists access policy rules for a system 👑

🦋 SYNOPSIS 🦋

bkr policy-list [options] <fqdn>

🌸 DESCRIPTION 🌸

So what she does is, she goes and retrieves and prints the access policy rules for a system whose FQDN is *<fqdn>*. Like, all of them. Printed. Right there. 🎀

And by default? By default she grabs the currently active access policy rules — which could be a a pool access policy. (Yes, "a a" — that's what the original says, I'm not fixing it, it's iconic, we love a typo queen 😭💀)

But if you want the custom access policy rules instead, you just specify --custom. Periodt. ✨

💖 OPTIONS 💖

  • --custom — retrieve the custom access policy rules for the system, instead of the currently active access policy rules. Switching it up, main character energy. 🦋
  • --mine — retrieves the access policy rules that have been granted directly to your user account. And hear me out, this is important: it does not include permissions granted indirectly via group permissions, nor does it include the system's default permissions. So it's just yours. Yours yours. 🫶
  • --user <username> — retrieve the access policy rules for *<username>*. And the way that this option can be specified multiple times? Obsessed. 💅
  • --group <group> — retrieve the access policy rules for group, *<group>*. Also can be specified multiple times. Stack 'em, bestie. 🌈
  • --format <format> — display results in the given format, either tabular or json. Let me break it down real quick:
    • the tabular format lists one rule per row as a table, and this is the default 👑
    • the json format returns the rules as a JSON array and is compact 🍓

Also, real quick — the common bkr options are described in the Options section of bkr(1). Go check her out, she's got lore. 📖

🔥 EXIT STATUS 🔥

Non-zero on error, otherwise zero. Simple. Clean. No notes. ✨

🐚 EXAMPLES 🐚

List current policy list for a system:

bkr policy-list test1.example.com

List current policy list for a system for users, user1 and user2:

bkr policy-list --user user1 --user user2 test1.example.com

See how we used --user twice? That's the multiple-times thing in action. Slay. 💅

👀 SEE ALSO 👀

bkr(1), bkr-policy-list(1)

🫶 AUTHOR 🫶

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

2013-2025 Red Hat, Inc.

okay that's the whole page, bestie, you're officially educated 🎓✨ this was version 29.2, dated May 26, 2025, and no cap, it's giving iconic documentation. iykyk 💖🦋🎀

📦 where this page comes from