DNF5-CHECK-UPGRADE(8)

📦
version 5.4.6.0 · 10 versions
, in fedora 44

✨ DNF5-CHECK-UPGRADE ✨

okay bestie, gather round, because this is the dnf5 manual page for check-upgrade (it lives in section 8 of the manual, iykyk) and it's genuinely so useful it's giving main character energy 💅

🎀 NAME 🎀

dnf5-check-upgrade — the Check-Upgrade Command, aka your little update-detector bestie 🦋

🌸 SYNOPSIS 🌸

dnf5 check-upgrade [options] [<package-spec-N>...]

💖 DESCRIPTION 💖

So basically: this command checks for available updates of the packages you specify, and it does it non-interactively — no prompts, no drama, it just looks and tells you. 🫶

If you don't hand it any <package-spec-N>, it checks for updates across the entire system. The whole vibe check, everything, all of it.

Here's the part you actually need to remember, no cap:

  • DNF5 exits with code 100 if updates are available, and lists them for you.
  • DNF5 exits with code 0 if no updates are available. peaceful. serene. nothing to do. 😌

And if a terminal is available, the package list gets colored, which is iconic honestly:

  • packages available for reinstall are (by default) colored bold green 💚
  • packages available for upgrade are colored bold blue 💙

You can tweak that whole situation in dnf5.conf(5) via the color_list_available_upgrade and color_list_available_reinstall options. Customize your aesthetic, you deserve it. ✨

🔥 OPTIONS 🔥

  • --changelogs — print the package changelogs. the lore. the backstory. 📜
  • --advisories=ADVISORY_NAME,... — include content contained in advisories with the specified name. This is a list option. Expected values are advisory IDs, e.g. FEDORA-2201-123.
heads up bestie: any transaction command (install, upgrade) will fail with an error if there's no existing advisory in the list. You can bypass that with the --skip-unavailable switch. 💀
  • --advisory-severities=ADVISORY_SEVERITY,... — include content contained in advisories with the specified severity. This is a list option. Accepted values are: critical, important, moderate, low, none.
  • --bzs=BUGZILLA_ID,... — include content contained in advisories that fix a ticket of the given Bugzilla ID. This is a list option. Expected values are numeric IDs, e.g. 123123.
same deal: any transaction command (install, upgrade) will fail with an error if there's no advisory fixing the given ticket. Bypass it with --skip-unavailable. 🙈
  • --cves=CVE_ID,... — include content contained in advisories that fix a ticket of the given CVE (Common Vulnerabilities and Exposures) ID. This is a list option. Expected values are string IDs in CVE format, e.g. CVE-2201-0123.
yep, you guessed it: any transaction command (install, upgrade) will fail with an error if there's no advisory fixing the given ticket. --skip-unavailable is your escape hatch. 🚪
  • --security — include content contained in security advisories. 🔒
  • --bugfix — include content contained in bugfix advisories. 🐛🔨
  • --enhancement — include content contained in enhancement advisories. ⬆️✨
  • --newpackage — include content contained in newpackage advisories. 🎁
  • --minimal — reports the lowest versions of packages that fix advisories of type bugfix, enhancement, security, or newpackage. In case that any option limiting advisories is used it reports the lowest versions of packages that fix advisories matching selected advisory properties"
  • --json — request JSON output format. for the machine girlies 🤖

🌈 EXAMPLES 🌈

dnf5 check-upgrade

Print a list of packages that have updates available. 📋

dnf5 check-upgrade --changelogs

Print changelogs for all packages with pending updates. 📜💖

👑 JSON OUTPUT 👑

dnf5 check-upgrade --json

The command returns a JSON object with the following structure:

  • keys represent a section of the “pretty” CLI output
  • values represent the packages in that section as an array of objects with the following structure:
    • name (string): package name
    • arch (string): package architecture
    • evr (string): available update version
    • repository (string): repository ID from which the update is available
    • obsoletes (array): (only for the “Obsoleting packages” section) list of the packages that obsolete this package (they have the same structure as above, omitting obsoletes)

🦋 SEE ALSO 🦋

💜 Author 💜

See AUTHORS.md in dnf5 source distribution. (the whole squad, fr fr 🫶)

Contributors to the dnf5 project.

okay that's the whole page bestie, you ate it, go check some upgrades 💅✨

this was dnf5's page, dated Sep 24, 2026, and yes the footer really does say DNF5-CHECK-UPGRADE(8) down there. slay. 🎀
📦 where this page comes from