Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-list.8

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