Debian Codegraph @

upstream/debian-unstable/man7/dnf5-system-state.7

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-SYSTEM-STATE" "7" "May 09, 2026" "" "dnf5"
32 .SH NAME
33 dnf5-system-state \- System state
34 .SH DESCRIPTION
35 .sp
36 The DNF5 system state consists of several TOML files with their location determined by the \fIsystem_state_dir\fP configuration option (\fBdnf5.conf(5)\fP, system_state_dir \%<#\:system-state-dir-options-label>). DNF5 uses the system state to:
37 .INDENT 0.0
38 .INDENT 3.5
39 .INDENT 0.0
40 .IP 1. 3
41 Store the reasons why each installed package was added to the system. The reasons can be \(dquser\(dq for packages that the user explicitly asked DNF5 to install, \(dqdependency\(dq and \(dqweak dependency\(dq for packages pulled in as dependencies of another package, \(dqgroup\(dq for packages installed by a group, or \(dqexternal\(dq for packages installed by another tool (e.g. rpm).
42 .IP 2. 3
43 Track installed groups and packages installed by these groups.
44 .IP 3. 3
45 Track installed environmental groups.
46 .UNINDENT
47 .UNINDENT
48 .UNINDENT
49 .sp
50 The way of storing the DNF5 system state is an internal implementation detail and may change at any time. To modify the state, always use the DNF5 command\-line interface or DNF5 API.
51 .SH RECOVERING FROM A CORRUPTED SYSTEM STATE
52 .sp
53 If the system state files become corrupted, simply back up and remove the corrupted TOML file mentioned in the error message. It will be regenerated during the next successful DNF5 transaction.
54 The regenerated files may lack some data, such as the reasons why packages were installed or the repositories from which they were installed.
55 .SH Author
56 See AUTHORS.md in dnf5 source distribution.
57 .SH Copyright
58 Contributors to the dnf5 project.
59 .\" End of generated man page.