RPMGRILL(1)

📦
version 0.34 · 2 versions
, in fedora 43

💅 RPMGRILL — the manual page, but make it make sense

okay bestie, buckle up, we're reading the rpmgrill(1) page from the User Contributed Perl Documentation section and honestly? it's giving "powerful tool with trust issues about being used by humans." let's get into it 🫶

✨ NAME ✨

rpmgrill — static analysis of koji builds. that's it, that's the whole vibe. 🎀

✨ SYNOPSIS ✨

rpmgrill [--disable=LIST] [--verbose] [--blacklist-config=FILE] BASEDIR

rpmgrill  --help  |  --version | --man

so you either give it a BASEDIR and let it cook, or you ask it one of the three existential questions (--help, --version, --man). no in-between. 💅

✨ DESCRIPTION ✨

okay so what does rpmgrill actually do? it analyzes a set of RPMs — typically from a Koji build — and it's looking for problems with the source and/or the generated RPMs. 🔍

and here's the thing that makes it different, bestie: unlike rpmlint, rpmgrill analyzes full builds, not individual RPMs. that's its whole thing. no cap.

now, the important part, and I need you to hear me on this one:

rpmgrill is not intended to be run directly by humans. it requires complex prep work to fetch and unpack the build RPMs. it's best suited toward a CI environment in which other tools monitor builds, fetch them, run rpmgrill, and report results.

so if you're reading this as a casual user?? you are almost certainly better off looking into rpmgrill-analyze-local. like, genuinely. go there. it's the main character of your use case, this one is not. 😭

✨ OPTIONS ✨

  • --list-plugins — lists the available plugins, then exits. a little menu of what's available, iconic. 📋
  • --disable=LIST — disables the given plugins while running. LIST is a comma-separated list of plugin names, exactly as they show up when you run --list-plugins. super useful for development, when you wanna do quick iterations of a test but not spend 10 minutes sitting in the VirusCheck plugin. like bestie we get it, you're thorough, but we have places to be. ⏱️
  • --verbose — shows progress messages. so you're not just staring at a blank terminal wondering if it's alive. 🫶
  • --blacklist-config=FILE — blacklisted tests will not be reported by rpmgrill. the blacklist configuration FILE is in YAML format:
blacklist:
  Plugin1: test1, test2
  Plugin2: test3
  ...

and what this is telling rpmgrill is: hey, do not report fails for these specified tests within these certain plugins. it's the "please stop telling me about this, I already know" setting. 🙈

  • --help — emits usage hints. the "what do I even type" option.
  • --version — displays the program version.
  • --man — displays this man page. hi, that's me, you're reading me. 🎀

✨ DIAGNOSTICS ✨

rpmgrill writes its results to the files rpmgrill.* in its working directory — where * is one of json, xml, yaml. so you get your results in whichever format your little heart desires. 📁

unexpected errors — which are probably bugs or FIXMEs in rpmgrill — get emitted to stderr. so if you see chaos on stderr, that's not you, that's them. 💀

✨ FILES ✨

rpmgrill requires a pre-set-up directory hierarchy containing unpacked RPMs. documenting that is way beyond the scope of this man page, and honestly fair, this page has a job and that job is not being a whole setup tutorial.

see README.unpacking in the rpmgrill source tree, or the rpmgrill-fetch-build tool, for more details. go read those, they got you. 🧚

✨ Examples ✨

want to test a new set of builds from Koji? say less:

$ mkdir testdir && cd testdir
$ koji download-task --logs <task id>

# unpack all rpms in the current directory
$ rpmgrill-unpack .

# the unpacked directory is created by rpmgrill-unpack
$ rpmgrill unpacked

look at that flow. mkdir, download, unpack, grill. chef's kiss. 👑

✨ SEE ALSO ✨

rpmgrill-unpack-rpms — go look at it, bestie, it's right there.

✨ AUTHOR ✨

Ed Santiago <santiago@redhat.com> — thank you for your service. 🫡

please report bugs or suggestions on bugzilla: <https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=rpmgrill>

like actually please do, they want to hear from you. fr fr. 💖

and that's the whole page, bestie!! this was perl v5.42.0, dated 2025-07-25, from the RPMGRILL(1) manual — literally slaying since 2025-07-25, no cap. go forth and analyze those koji builds (or, y'know, go look at rpmgrill-analyze-local like a sensible person 🌸). bye!! 💜

📦 where this page comes from