View a markdown version of this page

Using the dnf supportinfo plugin - Amazon Linux 2027

Using the dnf supportinfo plugin

AL2027 Preview

AL2027 is currently available for preview. It is intended for evaluation and testing only and is not recommended for production workloads.

Before you apply updates or plan a maintenance window, you can check whether a package stays supported for the period you need. Use the dnf supportinfo command, from the dnf-plugin-support-info package, to check the support status of an AL2027 package: whether it is supported now, what severity levels receive patches, and when its support status changes.

For more information about package support statements, see Package support information in the AL2027 Release Notes.

Note

During the preview, the reported support timeline for each package ends with the preview period. Support timelines for the AL2027 releases will be published with the public releases.

Prerequisites

Before you begin, make sure that you have the following:

  • An AL2027 instance

  • The dnf-plugin-support-info package, available from the default AL2027 repositories

No root privileges are required to run queries.

Getting started

Install the plugin.

$ sudo dnf install dnf-plugin-support-info

Query a package to verify the installation.

$ dnf supportinfo --pkg glibc

The output shows the package's support status and timeline:

Name : glibc Version : 2.44-2.amzn2027 State : installed Origin : Amazon Linux 2027 Core Support Timeline : from 2026-09-03 : supported (Low, Medium, Important, Critical) : from 2027-03-31 : unsupported Package Note : Amazon Linux will support this package until the end of the AL2027 public preview period

Query packages

Pass --pkg with one or more package names to show their support details.

$ dnf supportinfo --pkg package [package ...]

To query multiple packages in one command:

$ dnf supportinfo --pkg glibc bash openssl-libs

Filter packages

The --show flag filters packages by state, support level, or both.

$ dnf supportinfo --show filter [filter ...]

There are two filter types:

Category Values Source
State filters (fixed) installed, available, unavailable, all Built into the plugin
Support level filters (dynamic) Varies. For example, full_support and eos Loaded from the support data, so the values depend on what AL2027 defines

Multiple filters of the same type combine with OR. Filters of different types combine with AND. For example, --show installed eos matches packages that are installed and at the eos support level. If a filter name exists in both categories, use the prefix syntax: state:name or support:name.

Run --list-filters to see all valid filter values grouped by category:

$ dnf supportinfo --list-filters
State filters: all - All packages (installed, available, and unavailable) available - Packages available in repositories but not installed installed - Packages currently installed on the system unavailable - Packages in support info but not in any repository Support level filters: eos - End of support - no further updates full_support - Full security and bug fix support for all severities

To list the support information for all installed packages:

$ dnf supportinfo --show installed

The output lists each package in a table:

Package Version State Support Level Current Status Until (Next Phase) Note alternatives 1.33-3.amzn2027.0.2 installed Amazon Linux will support this package until the end of the AL2027 public preview period audit-libs 4.1.3-1.amzn2027.0.1 installed Amazon Linux will support this package until the end of the AL2027 public preview period # Output truncated for brevity

To use the prefix syntax:

$ dnf supportinfo --show state:installed support:full_support

Structured output

For scripts and automation, --showjson and --showxml produce machine-readable output.

To get JSON output:

$ dnf supportinfo --pkg bash --showjson

The output contains the package's phases, origin, and timeline with support level details:

{ "name": "bash", "version": "5.3.0-2.amzn2027", "state": "installed", "origin": "Amazon Linux 2027 Core", "phases": [ { "name": "supported", "start_date": "2026-09-03", "patch_priority": "Full Support", "support_level_description": "Full security and bug fix support for all severities", "covered_severities": "Low, Medium, Important, Critical" }, { "name": "unsupported", "start_date": "2027-03-31", "patch_priority": "End of Support", "support_level_description": "End of support - no further updates" } ], "note": "Amazon Linux will support this package until the end of the AL2027 public preview period" }

To get XML output:

$ dnf supportinfo --pkg bash --showxml

The output is an XML document with a package_support root element containing the package's phases, start dates, and support level details. For the schema reference, see SupportInfo XML structure.

Manage the cache

Your queries use a local cache of the support data, which avoids unnecessary network requests. When the cache expires, the plugin checks for changes to the remote file. If the file is unchanged, the cache refreshes without downloading. If it changed, the plugin downloads the updated file. On network errors, the plugin uses the cached file if one is available.

To download and cache the latest support data, for example in automation that needs fresh data without a full query:

$ dnf supportinfo --sync
Support info sync complete

To clear the cache:

$ dnf supportinfo --clean-cache
Cleaned support info cache.

Non-root usage

All commands work without root privileges. When run as root, the cache is stored at /var/cache/libdnf5/support-info/. When run as a non-root user, the cache goes to ~/.cache/libdnf5/support-info/ in the user's home directory.

Configuration reference

The plugin reads configuration from /etc/dnf/plugins/supportinfo.conf. The following is the configuration shipped with AL2027:

[main] baseurl = https://cdn-al2027.amazonlinux.com/core/AL2027-supportinfo-1.0.xml templateurl = https://cdn-al2027.amazonlinux.com/core/supportinfo-1.0.xsd
Option Description Default
baseurl URL to the support info XML file. Required
templateurl URL to the XSD schema for validation. None
metadata_expire Cache duration in seconds. 1800

Output fields reference

The --pkg output contains the following fields:

Field Description
Name Package name
Version Installed or available version
State installed, available, or unavailable
Origin Repository providing the package
Support Timeline Chronological list of lifecycle phases with dates and the severities covered in each phase
Package Note Additional context, such as support period notes

Troubleshooting

If query results look stale, sync the cache manually:

$ dnf supportinfo --sync

If the issue persists, clear the cache and sync again:

$ dnf supportinfo --clean-cache dnf supportinfo --sync

Additional resources