Debian Codegraph @

upstream/debian-unstable/man8/dnf5-list.8

raw
1 .\" Man page generated from reStructuredText
2 .\" by the Docutils 0.22.4 manpage writer.
3 .
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .TH "DNF5-LIST" "8" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 dnf5-list \- List Command
34 .SH SYNOPSIS
35 .sp
36 \fBdnf5 list [options] [<package\-spec\-NI>...]\fP
37 .SH DESCRIPTION
38 .sp
39 Prints lists of packages based on the provided parameters.
40 .sp
41 If terminal is available, list of the packages is colored, packages available for reinstall are
42 (by default) colored with bold green and packages available for upgrade with bold blue. This
43 behavior can be adjusted in \fBdnf5.conf(5)\fP via \fIcolor_list_available_upgrade\fP and
44 \fIcolor_list_available_reinstall\fP options.
45 .SH OPTIONS
46 .INDENT 0.0
47 .TP
48 .B \fB\-\-showduplicates\fP
49 .nf
50 Show all versions of the packages, not only the latest one.
51 .fi
52 .sp
53 .UNINDENT
54 .INDENT 0.0
55 .TP
56 .B \fB\-\-installed\-from\-repo=REPO_ID,...\fP
57 .nf
58 Filters installed packages by the ID of the repository they were installed from.
59 .fi
60 .sp
61 .UNINDENT
62 .INDENT 0.0
63 .TP
64 .B \fB\-\-installed\fP
65 .nf
66 List only installed packages.
67 .fi
68 .sp
69 .TP
70 .B \fB\-\-available\fP
71 .nf
72 List only available packages.
73 .fi
74 .sp
75 .TP
76 .B \fB\-\-extras\fP
77 .nf
78 List only extras: packages installed on the system that are not available in any known repository.
79 .fi
80 .sp
81 .TP
82 .B \fB\-\-obsoletes\fP
83 .nf
84 List only packages installed on the system that are obsoleted by packages in any known repository.
85 .fi
86 .sp
87 .TP
88 .B \fB\-\-recent\fP
89 .nf
90 List only packages recently added to the repositories.
91 .fi
92 .sp
93 .TP
94 .B \fB\-\-upgrades\fP
95 .nf
96 List only available upgrades for installed packages.
97 .fi
98 .sp
99 .TP
100 .B \fB\-\-autoremove\fP
101 .nf
102 List only packages that will be removed by the autoremove command \%<#\:autoremove-command-ref-label>\&.
103 .fi
104 .sp
105 .TP
106 .B \fB\-\-json\fP
107 .nf
108 Request JSON output format.
109 .fi
110 .sp
111 .UNINDENT
112 .SH EXAMPLES
113 .INDENT 0.0
114 .TP
115 .B \fBdnf5 list\fP
116 .nf
117 List installed and available packages.
118 .fi
119 .sp
120 .TP
121 .B \fBdnf5 list \-\-available \-\-showduplicates\fP
122 .nf
123 List all available packages, including all available versions.
124 .fi
125 .sp
126 .TP
127 .B \fBdnf5 list kernel*\fP
128 .nf
129 List installed and available packages whose names start with \fBkernel\fP\&.
130 .fi
131 .sp
132 .UNINDENT
133 .SH JSON OUTPUT
134 .sp
135 \fBdnf5 list \-\-json\fP
136 .sp
137 The command returns a JSON object with the following structure:
138 .INDENT 0.0
139 .IP \(bu 2
140 keys represent a section of the “pretty” CLI output
141 .IP \(bu 2
142 values represent the packages in that section as an array of objects with the following structure:
143 .INDENT 2.0
144 .INDENT 3.5
145 .INDENT 0.0
146 .IP \(bu 2
147 \fBname\fP (string): package name
148 .IP \(bu 2
149 \fBarch\fP (string): package architecture
150 .IP \(bu 2
151 \fBevr\fP (string): available update version
152 .IP \(bu 2
153 \fBrepository\fP (string): repository ID from which the update is available
154 .IP \(bu 2
155 \fBobsoletes\fP (array): (only for the “Obsoleting packages” section) list of the packages that
156 obsolete this package (they have the same structure as above, omitting \fBobsoletes\fP)
157 .UNINDENT
158 .UNINDENT
159 .UNINDENT
160 .UNINDENT
161 .SH SEE ALSO
162 .INDENT 0.0
163 .INDENT 3.5
164 .nf
165 \fBdnf5\-specs(7)\fP, Patterns specification \%<#\:specs-misc-ref-label>
166 .fi
167 .sp
168 .UNINDENT
169 .UNINDENT
170 .SH Author
171 See AUTHORS.md in dnf5 source distribution.
172 .SH Copyright
173 Contributors to the dnf5 project.
174 .\" End of generated man page.