Debian Codegraph @

upstream/mageia-cauldron/man8/dnf5-offline.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-OFFLINE" "8" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-offline \- Offline Command
33 .SH SYNOPSIS
34 .sp
35 \fBdnf5 offline <subcommand> [options]\fP
36 .SH DESCRIPTION
37 .sp
38 The \fBoffline\fP command is used to manage \(dqoffline\(dq transactions\-\-\-transactions that run when the system is booted into a minimal environment. Running a transaction in this stripped\-down environment can be safer than running it when the system is booted normally since the transaction is less likely to interfere with running processes.
39 .sp
40 Offline transactions can be initiated by specifying the \fB\-\-offline\fP flag on any operation (\fBinstall\fP, \fBupgrade\fP, \fBdistro\-sync\fP, etc.), or via \fBdnf5 system\-upgrade download\fP\&. Once an offline transaction is initiated, run \fBdnf5 offline reboot\fP to reboot and begin the transaction.
41 .sp
42 Data for offline transactions is stored under the \(dqsystem state\(dq directory at \fB/usr/lib/sysimage/libdnf5/offline\fP\&.
43 .SH SUBCOMMANDS
44 .INDENT 0.0
45 .TP
46 .B \fBclean\fP
47 .nf
48 Removes any stored offline transaction and deletes cached package files.
49 .fi
50 .sp
51 .TP
52 .B \fBlog\fP
53 .nf
54 Used to see a list of boots during which an offline transaction was attempted, or show the logs from an attempted offline transaction. The logs for one of the boots can be shown by specifying one of the numbers in the first column with the \fB\-\-number\fP argument. Negative numbers can be used to number the boots from last to first. For example, \fBlog \-\-number=\-1\fP can be used to see the logs for the last offline transaction.
55 .fi
56 .sp
57 .TP
58 .B \fBreboot\fP
59 .nf
60 Prepares the system to perform the offline transaction and reboots to start the transaction. This command can only be run after an offline transaction is initiated (e.g. by \fBdnf5 system\-upgrade download\fP).
61 .fi
62 .sp
63 .TP
64 .B \fBstatus\fP
65 .nf
66 Shows the status of the current offline transaction.
67 .fi
68 .sp
69 .TP
70 .B \fB_execute\fP
71 .nf
72 Execute the transaction in the offline environment.
73 .fi
74 .sp
75 .sp
76 \fBWARNING:\fP
77 .INDENT 7.0
78 .INDENT 3.5
79 For internal use only. Not intended to be run by the user.
80 .UNINDENT
81 .UNINDENT
82 .UNINDENT
83 .SH OPTIONS
84 .INDENT 0.0
85 .TP
86 .B \fB\-\-number=<boot number>\fP
87 .nf
88 Show the log specified by the number. Run \fBdnf5 offline log\fP with \fB\-\-number\fP first to get a list of logs to choose from.
89 Used with the \fBlog\fP subcommand.
90 .fi
91 .sp
92 .TP
93 .B \fB\-\-poweroff\fP
94 .nf
95 The system will power off after the transaction is completed instead of restarting. If the transaction failed, the system will reboot instead of powering off even with this flag.
96 Used with the \fBreboot\fP subcommand.
97 .fi
98 .sp
99 .UNINDENT
100 .SH ENVIRONMENT
101 .INDENT 0.0
102 .TP
103 .B \fBDNF_SYSTEM_UPGRADE_NO_REBOOT\fP
104 If set, the system won\(aqt be rebooted or powered off by DNF5 when the normal work flow would do so.
105 .UNINDENT
106 .SH EXAMPLES
107 .INDENT 0.0
108 .TP
109 .B \fBdnf5 install \-\-offline hello\fP
110 .nf
111 Prepares the installation of the \fBhello\fP package as an offline transaction.
112 .fi
113 .sp
114 .TP
115 .B \fBdnf5 offline status\fP
116 .nf
117 Shows the status of the current offline transaction.
118 .fi
119 .sp
120 .TP
121 .B \fBdnf5 offline reboot \-\-poweroff\fP
122 .nf
123 Reboot and run the offline transaction, then power the system off after the transaction is complete.
124 .fi
125 .sp
126 .TP
127 .B \fBdnf5 offline log\fP
128 .nf
129 List boots during which an offline transaction was attempted.
130 .fi
131 .sp
132 .TP
133 .B \fBdnf5 offline log \-\-number=\-1\fP
134 .nf
135 View the log from the latest boot during which an offline transaction was attempted.
136 .fi
137 .sp
138 .UNINDENT
139 .SH SEE ALSO
140 .INDENT 0.0
141 .INDENT 3.5
142 .nf
143 \fBdnf5\-system\-upgrade(8)\fP, \fI\%System\-upgrade command\fP
144 \X'tty: link https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates'\fI\%https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates\fP\X'tty: link'
145 .fi
146 .sp
147 .UNINDENT
148 .UNINDENT
149 .SH AUTHOR
150 See AUTHORS.md in dnf5 source distribution.
151 .SH COPYRIGHT
152 Contributors to the dnf5 project.
153 .\" Generated by docutils manpage writer.
154 .