.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-LIST" "8" "Sep 06, 2026" "" "dnf5"
.SH NAME
dnf5-list \- List Command
.SH SYNOPSIS
.sp
\fBdnf5 list [options] [<package\-spec\-NI>...]\fP
.SH DESCRIPTION
.sp
Prints lists of packages based on the provided parameters.
.sp
If terminal is available, list of the packages is colored, packages available for reinstall are
(by default) colored with bold green and packages available for upgrade with bold blue. This
behavior can be adjusted in \fBdnf5.conf(5)\fP via \fIcolor_list_available_upgrade\fP and
\fIcolor_list_available_reinstall\fP options.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-\-showduplicates\fP
.nf
Show all versions of the packages, not only the latest one.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
.nf
Filters installed packages by the ID of the repository they were installed from.
.fi
.sp
.UNINDENT
.INDENT 0.0
.TP
.B \fB\-\-installed\fP
.nf
List only installed packages.
.fi
.sp
.TP
.B \fB\-\-available\fP
.nf
List only available packages.
.fi
.sp
.TP
.B \fB\-\-extras\fP
.nf
List only extras: packages installed on the system that are not available in any known repository.
.fi
.sp
.TP
.B \fB\-\-obsoletes\fP
.nf
List only packages installed on the system that are obsoleted by packages in any known repository.
.fi
.sp
.TP
.B \fB\-\-recent\fP
.nf
List only packages recently added to the repositories.
.fi
.sp
.TP
.B \fB\-\-upgrades\fP
.nf
List only available upgrades for installed packages.
.fi
.sp
.TP
.B \fB\-\-autoremove\fP
.nf
List only packages that will be removed by the autoremove command \%<#\:autoremove-command-ref-label>\&.
.fi
.sp
.TP
.B \fB\-\-json\fP
.nf
Request JSON output format.
.fi
.sp
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.TP
.B \fBdnf5 list\fP
.nf
List installed and available packages.
.fi
.sp
.TP
.B \fBdnf5 list \-\-available \-\-showduplicates\fP
.nf
List all available packages, including all available versions.
.fi
.sp
.TP
.B \fBdnf5 list kernel*\fP
.nf
List installed and available packages whose names start with \fBkernel\fP\&.
.fi
.sp
.UNINDENT
.SH JSON OUTPUT
.sp
\fBdnf5 list \-\-json\fP
.sp
The command returns a JSON object with the following structure:
.INDENT 0.0
.IP \(bu 2
keys represent a section of the “pretty” CLI output
.IP \(bu 2
values represent the packages in that section as an array of objects with the following structure:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBname\fP (string): package name
.IP \(bu 2
\fBarch\fP (string): package architecture
.IP \(bu 2
\fBevr\fP (string): available update version
.IP \(bu 2
\fBrepository\fP (string): repository ID from which the update is available
.IP \(bu 2
\fBobsoletes\fP (array): (only for the “Obsoleting packages” section) list of the packages that
obsolete this package (they have the same structure as above, omitting \fBobsoletes\fP)
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-specs(7)\fP, Patterns specification \%<#\:specs-misc-ref-label>
.fi
.sp
.UNINDENT
.UNINDENT
.SH Author
See AUTHORS.md in dnf5 source distribution.
.SH Copyright
Contributors to the dnf5 project.
.\" End of generated man page.