DNF5-ADVISORY(8)

NAME
dnf5-advisory - Advisory Command

SYNOPSIS

dnf5 advisory <subcommand> [options] [<advisory-spec>...]

DESCRIPTION

The advisory command in DNF5 offers several queries for getting information about advisories and packages related to them.

Optional advisory-spec arguments could be passed to filter only advisories with given names.

Note:
        The updateinfo command is available as a compatibility alias for advisory. For example, dnf5 updateinfo list is equivalent to dnf5 advisory list.

SUBCOMMANDS

    list
        List advisories matching the specified criteria.
        Displays a table with the following columns: Name (advisory ID), Type, Severity, Package (NEVRA), and Issued (date).
        When --with-bz or --with-cve is specified, the first column shows the Bugzilla or CVE reference ID instead of the advisory name.
        Installed advisory packages are highlighted in green.

    info
        Print detailed information about advisories.
        For each matching advisory, displays: Name, Title, Severity, Type, Status, Vendor, Issued date, Description, Message, Rights, References (with Title, Id, Type, and URL), and affected packages/modules organized by collection.

    summary
        Print a summary count of advisories by type and severity.
        Displays a hierarchical summary showing the number of advisories in each category:
        Security (with subcategories: Critical, Important, Moderate, Low, Other), Bugfix, Enhancement, and Other.
        The output header indicates the filter mode: Available (default), All, Installed, or Updates.

OPTIONS

    --all
        Show advisories containing any version of installed packages.

    --available
        Show advisories containing newer versions of installed packages. This is the default behavior.

    --installed
        Show advisories containing equal and older versions of installed packages.

    --updates
        Show advisories containing newer versions of installed packages for which a newer version is available.

    --contains-pkgs=PACKAGE_NAME,...
        Show only advisories containing packages with specified names.
        This is a list option.
        Only installed packages are matched. Globs are supported.

    --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.

    --advisory-severities=ADVISORY_SEVERITY,...
        Include content contained in advisories with 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.
        Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the --skip-unavailable switch.

    --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.
        Any transaction command (install, upgrade) will fail with an error if there is no advisory fixing the given ticket; this can be bypassed by using the --skip-unavailable switch.

    --with-bz
        Show only advisories referencing a Bugzilla ticket.

    --with-cve
        Show only advisories referencing a CVE ticket.

    --json
        Request JSON output format for machine-readable results.
        Available for list and info subcommands only.

EXAMPLES

    dnf5 advisory info FEDORA-2022-07aa56297a
        Show detailed info about advisory with given name.

    dnf5 advisory summary --contains-pkgs=kernel,kernel-core --with-bz
        Show a summary of advisories containing kernel or kernel-core packages and referencing any Bugzilla ticket.

    dnf5 advisory list --security --advisory-severities=important
        Show a list of security advisories or advisories with important severity.

    dnf5 advisory list --json
        List all advisories in JSON format for programmatic processing.

    dnf5 advisory list --json --with-cve
        List advisories with CVE references in JSON format (extended format).

    dnf5 advisory info FEDORA-2022-07aa56297a --json
        Show detailed info about advisory in JSON format.

JSON OUTPUT

    •   dnf5 advisory list --json

The command returns a JSON array, each element describing one advisory.

Basic format (without --with-cve or --with-bz):

            •   name (string) - Advisory identifier.

            •   type (string) - Advisory type (security, bugfix, enhancement).

            •   severity (string) - Advisory severity level.

            •   nevra (string) - Package name-epoch:version-release.architecture.

            •   buildtime (integer) - Advisory build time, UNIX time.

Extended format (with --with-cve or --with-bz):

            •   advisory_name (string) - Advisory identifier.

            •   advisory_type (string) - Advisory type (security, bugfix, enhancement).

            •   advisory_severity (string) - Advisory severity level.

            •   advisory_buildtime (integer) - Advisory build time, UNIX time.

            •   nevra (string) - Package name-epoch:version-release.architecture.

            •   references (array) - List of references (CVE/Bugzilla). Each reference contains:

                    •   reference_id (string) - Reference identifier (e.g., CVE-2024-1234).

                    •   reference_type (string) - Reference type (cve or bugzilla).

    •   dnf5 advisory info --json

The command returns a JSON array, each element containing detailed advisory information. Each advisory object contains the following fields:

    •   Name (string) - Advisory name/identifier.

    •   Title (string) - Advisory title.

    •   Type (string) - Advisory type (security, bugfix, enhancement).

    •   Severity (string) - Advisory severity level.

    •   Status (string) - Advisory status.

    •   Vendor (string) - Advisory vendor.

    •   Issued (integer) - Advisory issue time, UNIX time.

    •   Description (string) - Detailed advisory description.

    •   Message (string) - Advisory message.

    •   Rights (string) - Advisory rights/copyright information.

    •   references (array) - List of references (CVE, Bugzilla, etc.). Each reference contains:

        •   Title (string) - Reference title.

        •   Id (string) - Reference identifier (e.g., CVE-2024-1234).

        •   Type (string) - Reference type (cve, bugzilla, etc.).

        •   Url (string) - Reference URL.

    •   collections (object) - Package and module collections affected by the advisory:

        •   packages (array) - List of affected package NEVRAs (only present if packages exist).

        •   modules (array) - List of affected module NSVCAs (only present if modules exist).

For empty results:

    •   dnf5 advisory list --json returns [] (empty array).

    •   dnf5 advisory info --json returns [] (empty array).

Author
See AUTHORS.md in dnf5 source distribution.

Copyright
Contributors to the dnf5 project.