| 1 |
'\" t |
| 2 |
.TH "KERNEL\-COMMAND\-LINE" "7" "" "systemd 261~rc3" "kernel-command-line" |
| 3 |
.\" ----------------------------------------------------------------- |
| 4 |
.\" * Define some portability stuff |
| 5 |
.\" ----------------------------------------------------------------- |
| 6 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 7 |
.\" http://bugs.debian.org/507673 |
| 8 |
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
| 9 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 10 |
.ie \n(.g .ds Aq \(aq |
| 11 |
.el .ds Aq ' |
| 12 |
.\" ----------------------------------------------------------------- |
| 13 |
.\" * set default formatting |
| 14 |
.\" ----------------------------------------------------------------- |
| 15 |
.\" disable hyphenation |
| 16 |
.nh |
| 17 |
.\" disable justification (adjust text to left margin only) |
| 18 |
.ad l |
| 19 |
.\" ----------------------------------------------------------------- |
| 20 |
.\" * MAIN CONTENT STARTS HERE * |
| 21 |
.\" ----------------------------------------------------------------- |
| 22 |
.SH "NAME" |
| 23 |
kernel-command-line \- Kernel command line parameters |
| 24 |
.SH "SYNOPSIS" |
| 25 |
.PP |
| 26 |
/proc/cmdline |
| 27 |
.SH "DESCRIPTION" |
| 28 |
.PP |
| 29 |
The kernel, the programs running in the initrd and in the host system may be configured at boot via kernel command line arguments\&. |
| 30 |
.PP |
| 31 |
For command line parameters understood by the kernel, please see |
| 32 |
\m[blue]\fBkernel\-parameters\&.html\fR\m[]\&\s-2\u[1]\d\s+2 |
| 33 |
and |
| 34 |
\fBbootparam\fR(7)\&. |
| 35 |
.PP |
| 36 |
For command line parameters understood by the initrd, see the documentation of the specific initrd implementation of your installation\&. |
| 37 |
.SH "CORE OS COMMAND LINE ARGUMENTS" |
| 38 |
.PP |
| 39 |
\fIsystemd\&.unit=\fR, \fIrd\&.systemd\&.unit=\fR, \fIsystemd\&.dump_core\fR, \fIsystemd\&.crash_chvt\fR, \fIsystemd\&.crash_shell\fR, \fIsystemd\&.crash_action=\fR, \fIsystemd\&.confirm_spawn\fR, \fIsystemd\&.service_watchdogs\fR, \fIsystemd\&.show_status\fR, \fIsystemd\&.status_unit_format=\fR, \fIsystemd\&.log_target=\fR, \fIsystemd\&.log_level=\fR, \fIsystemd\&.log_location=\fR, \fIsystemd\&.log_color\fR, \fIsystemd\&.log_ratelimit_kmsg\fR, \fIsystemd\&.default_standard_output=\fR, \fIsystemd\&.default_standard_error=\fR, \fIsystemd\&.setenv=\fR, \fIsystemd\&.machine_id=\fR, \fIsystemd\&.set_credential=\fR, \fIsystemd\&.set_credential_binary=\fR, \fIsystemd\&.import_credentials=\fR, \fIsystemd\&.reload_limit_interval_sec=\fR, \fIsystemd\&.reload_limit_burst=\fR, \fIsystemd\&.minimum_uptime_sec=\fR |
| 40 |
.RS 4 |
| 41 |
Parameters understood by the system and service manager to control system behavior\&. For details, see |
| 42 |
\fBsystemd\fR(1)\&. |
| 43 |
.sp |
| 44 |
Added in version 186\&. |
| 45 |
.RE |
| 46 |
.PP |
| 47 |
\fIsystemd\&.restrict_filesystem_access=\fR |
| 48 |
.RS 4 |
| 49 |
Controls the |
| 50 |
\fIRestrictFileSystemAccess=\fR |
| 51 |
execution enforcement policy\&. For details, see |
| 52 |
\fBsystemd-system.conf\fR(5)\&. |
| 53 |
.sp |
| 54 |
Added in version 261\&. |
| 55 |
.RE |
| 56 |
.PP |
| 57 |
\fIsystemd\&.mask=\fR, \fIsystemd\&.wants=\fR, \fIsystemd\&.debug_shell\fR, \fIsystemd\&.default_debug_tty=\fR |
| 58 |
.RS 4 |
| 59 |
Additional parameters understood by |
| 60 |
\fBsystemd-debug-generator\fR(8), to mask or start specific units at boot, or invoke a debug shell on tty9\&. |
| 61 |
.sp |
| 62 |
Added in version 215\&. |
| 63 |
.RE |
| 64 |
.PP |
| 65 |
\fIsystemd\&.break=\fR, \fIrd\&.systemd\&.break=\fR |
| 66 |
.RS 4 |
| 67 |
Parameters understood by |
| 68 |
\fBsystemd-debug-generator\fR(8), to pause the boot process at a certain point and spawn a debug shell\&. |
| 69 |
.sp |
| 70 |
Added in version 258\&. |
| 71 |
.RE |
| 72 |
.PP |
| 73 |
\fIsystemd\&.run=\fR, \fIsystemd\&.run_success_action=\fR, \fIsystemd\&.run_failure_action=\fR |
| 74 |
.RS 4 |
| 75 |
Additional parameters understood by |
| 76 |
\fBsystemd-run-generator\fR(8), to run a command line specified on the kernel command line as system service after booting up\&. |
| 77 |
.sp |
| 78 |
Added in version 240\&. |
| 79 |
.RE |
| 80 |
.PP |
| 81 |
\fIsystemd\&.early_core_pattern=\fR |
| 82 |
.RS 4 |
| 83 |
During early boot, the generation of core dump files is disabled until a core dump handler (if any) takes over\&. This parameter allows specifying an absolute path where core dump files should be stored until a handler is installed\&. The path should be absolute and may contain specifiers, see |
| 84 |
\fBcore\fR(5) |
| 85 |
for details\&. |
| 86 |
.sp |
| 87 |
Added in version 240\&. |
| 88 |
.RE |
| 89 |
.PP |
| 90 |
\fIsystemd\&.restore_state=\fR |
| 91 |
.RS 4 |
| 92 |
This parameter is understood by several system tools to control whether or not they should restore system state from the previous boot\&. For details, see |
| 93 |
\[email protected]\fR(8) |
| 94 |
and |
| 95 |
\fBsystemd-rfkill.service\fR(8)\&. |
| 96 |
.sp |
| 97 |
Added in version 209\&. |
| 98 |
.RE |
| 99 |
.PP |
| 100 |
\fIsystemd\&.ssh_auto=\fR, \fIsystemd\&.ssh_listen=\fR |
| 101 |
.RS 4 |
| 102 |
These parameters are interpreted by |
| 103 |
\fBsystemd-ssh-generator\fR(8) |
| 104 |
and may be used to control SSH sockets the system shall be reachable on\&. |
| 105 |
.sp |
| 106 |
Added in version 256\&. |
| 107 |
.RE |
| 108 |
.PP |
| 109 |
\fIsystemd\&.volatile=\fR |
| 110 |
.RS 4 |
| 111 |
This parameter controls whether the system shall boot up in volatile mode\&. Takes a boolean argument, or the special values |
| 112 |
"state" |
| 113 |
or |
| 114 |
"overlay"\&. If false (the default), normal boot mode is selected, the root directory and |
| 115 |
/var/ |
| 116 |
are mounted as specified on the kernel command line or |
| 117 |
/etc/fstab, or otherwise configured\&. If true, full state\-less boot mode is selected\&. In this case, the root directory is mounted as volatile memory file system ("tmpfs"), and only |
| 118 |
/usr/ |
| 119 |
is mounted from the file system configured as root device, in read\-only mode\&. This enables fully state\-less boots where the vendor\-supplied OS is used as shipped, with only default configuration and no stored state in effect, as |
| 120 |
/etc/ |
| 121 |
and |
| 122 |
/var/ |
| 123 |
(as well as all other resources shipped in the root file system) are reset at boot and lost on shutdown\&. If this setting is set to |
| 124 |
"state" |
| 125 |
the root file system is mounted read\-only, however |
| 126 |
/var/ |
| 127 |
is mounted as a volatile memory file system ("tmpfs"), so that the system boots up with the normal configuration applied, but all state reset at boot and lost at shutdown\&. If this setting is set to |
| 128 |
"overlay" |
| 129 |
the root file system is set up as |
| 130 |
"overlayfs" |
| 131 |
mount combining the read\-only root directory with a writable |
| 132 |
"tmpfs", so that no modifications are made to disk, but the file system may be modified nonetheless with all changes being lost at reboot\&. For details, see |
| 133 |
\fBsystemd-volatile-root.service\fR(8) |
| 134 |
and |
| 135 |
\fBsystemd-fstab-generator\fR(8)\&. |
| 136 |
.sp |
| 137 |
Added in version 233\&. |
| 138 |
.RE |
| 139 |
.PP |
| 140 |
\fIquiet\fR |
| 141 |
.RS 4 |
| 142 |
Parameter understood by both the kernel and the system and service manager to control console log verbosity\&. For details, see |
| 143 |
\fBsystemd\fR(1)\&. |
| 144 |
.sp |
| 145 |
Added in version 186\&. |
| 146 |
.RE |
| 147 |
.PP |
| 148 |
\fIdebug\fR |
| 149 |
.RS 4 |
| 150 |
Parameter understood by both the kernel and the system and service manager to control console log verbosity\&. For details, see |
| 151 |
\fBsystemd\fR(1)\&. |
| 152 |
.sp |
| 153 |
Added in version 205\&. |
| 154 |
.RE |
| 155 |
.PP |
| 156 |
\fI\-b\fR, \fIrd\&.emergency\fR, \fIemergency\fR, \fIrd\&.rescue\fR, \fIrescue\fR, \fIsingle\fR, \fIs\fR, \fIS\fR, \fI1\fR, \fI2\fR, \fI3\fR, \fI4\fR, \fI5\fR |
| 157 |
.RS 4 |
| 158 |
Parameters understood by the system and service manager, as compatibility and convenience options\&. For details, see |
| 159 |
\fBsystemd\fR(1)\&. |
| 160 |
.sp |
| 161 |
Added in version 186\&. |
| 162 |
.RE |
| 163 |
.PP |
| 164 |
\fIlocale\&.LANG=\fR, \fIlocale\&.LANGUAGE=\fR, \fIlocale\&.LC_CTYPE=\fR, \fIlocale\&.LC_NUMERIC=\fR, \fIlocale\&.LC_TIME=\fR, \fIlocale\&.LC_COLLATE=\fR, \fIlocale\&.LC_MONETARY=\fR, \fIlocale\&.LC_MESSAGES=\fR, \fIlocale\&.LC_PAPER=\fR, \fIlocale\&.LC_NAME=\fR, \fIlocale\&.LC_ADDRESS=\fR, \fIlocale\&.LC_TELEPHONE=\fR, \fIlocale\&.LC_MEASUREMENT=\fR, \fIlocale\&.LC_IDENTIFICATION=\fR |
| 165 |
.RS 4 |
| 166 |
Parameters understood by the system and service manager to control locale and language settings\&. For details, see |
| 167 |
\fBsystemd\fR(1)\&. |
| 168 |
.sp |
| 169 |
Added in version 186\&. |
| 170 |
.RE |
| 171 |
.PP |
| 172 |
\fIfsck\&.mode=\fR, \fIfsck\&.repair=\fR |
| 173 |
.RS 4 |
| 174 |
Parameters understood by the file system checker services\&. For details, see |
| 175 |
\[email protected]\fR(8)\&. |
| 176 |
.sp |
| 177 |
Added in version 186\&. |
| 178 |
.RE |
| 179 |
.PP |
| 180 |
\fIquotacheck\&.mode=\fR |
| 181 |
.RS 4 |
| 182 |
Parameter understood by the file quota checker service\&. For details, see |
| 183 |
\[email protected]\fR(8)\&. |
| 184 |
.sp |
| 185 |
Added in version 186\&. |
| 186 |
.RE |
| 187 |
.PP |
| 188 |
\fIsystemd\&.journald\&.forward_to_syslog=\fR, \fIsystemd\&.journald\&.forward_to_kmsg=\fR, \fIsystemd\&.journald\&.forward_to_console=\fR, \fIsystemd\&.journald\&.forward_to_wall=\fR |
| 189 |
.RS 4 |
| 190 |
Parameters understood by the journal service\&. For details, see |
| 191 |
\fBsystemd-journald.service\fR(8)\&. |
| 192 |
.sp |
| 193 |
Added in version 186\&. |
| 194 |
.RE |
| 195 |
.PP |
| 196 |
\fIvconsole\&.keymap=\fR, \fIvconsole\&.keymap_toggle=\fR, \fIvconsole\&.font=\fR, \fIvconsole\&.font_map=\fR, \fIvconsole\&.font_unimap=\fR |
| 197 |
.RS 4 |
| 198 |
Parameters understood by the virtual console setup logic\&. For details, see |
| 199 |
\fBvconsole.conf\fR(5)\&. |
| 200 |
.sp |
| 201 |
Added in version 186\&. |
| 202 |
.RE |
| 203 |
.PP |
| 204 |
\fIudev\&.log_level=\fR, \fIrd\&.udev\&.log_level=\fR, \fIudev\&.trace=\fR, \fIrd\&.udev\&.trace=\fR, \fIudev\&.children_max=\fR, \fIrd\&.udev\&.children_max=\fR, \fIudev\&.exec_delay=\fR, \fIrd\&.udev\&.exec_delay=\fR, \fIudev\&.event_timeout=\fR, \fIrd\&.udev\&.event_timeout=\fR, \fIudev\&.timeout_signal=\fR, \fIrd\&.udev\&.timeout_signal=\fR, \fIudev\&.blockdev_read_only\fR, \fIrd\&.udev\&.blockdev_read_only\fR, \fInet\&.ifnames=\fR, \fInet\&.naming_scheme=\fR |
| 205 |
.RS 4 |
| 206 |
Parameters understood by the device event managing daemon\&. For details, see |
| 207 |
\fBsystemd-udevd.service\fR(8)\&. |
| 208 |
.sp |
| 209 |
Added in version 186\&. |
| 210 |
.RE |
| 211 |
.PP |
| 212 |
\fIplymouth\&.enable=\fR |
| 213 |
.RS 4 |
| 214 |
May be used to disable the Plymouth boot splash\&. For details, see |
| 215 |
\fBplymouth\fR(8)\&. |
| 216 |
.sp |
| 217 |
Added in version 186\&. |
| 218 |
.RE |
| 219 |
.PP |
| 220 |
\fIluks=\fR, \fIrd\&.luks=\fR, \fIluks\&.crypttab=\fR, \fIrd\&.luks\&.crypttab=\fR, \fIluks\&.name=\fR, \fIrd\&.luks\&.name=\fR, \fIluks\&.uuid=\fR, \fIrd\&.luks\&.uuid=\fR, \fIluks\&.options=\fR, \fIrd\&.luks\&.options=\fR, \fIluks\&.key=\fR, \fIrd\&.luks\&.key=\fR |
| 221 |
.RS 4 |
| 222 |
Configures the LUKS full\-disk encryption logic at boot\&. For details, see |
| 223 |
\fBsystemd-cryptsetup-generator\fR(8)\&. |
| 224 |
.sp |
| 225 |
Added in version 186\&. |
| 226 |
.RE |
| 227 |
.PP |
| 228 |
\fIfstab=\fR, \fIrd\&.fstab=\fR |
| 229 |
.RS 4 |
| 230 |
Configures the |
| 231 |
/etc/fstab |
| 232 |
logic at boot\&. For details, see |
| 233 |
\fBsystemd-fstab-generator\fR(8)\&. |
| 234 |
.sp |
| 235 |
Added in version 186\&. |
| 236 |
.RE |
| 237 |
.PP |
| 238 |
\fIroot=\fR, \fIrootfstype=\fR, \fIrootflags=\fR, \fIro\fR, \fIrw\fR |
| 239 |
.RS 4 |
| 240 |
Configures the root file system and its file system type and mount options, as well as whether it shall be mounted read\-only or read\-write initially\&. For details, see |
| 241 |
\fBsystemd-fstab-generator\fR(8)\&. |
| 242 |
.sp |
| 243 |
If |
| 244 |
\fIroot=\fR |
| 245 |
is not set (or set to |
| 246 |
"gpt\-auto") the automatic root partition discovery implemented by |
| 247 |
\fBsystemd-gpt-auto-generator\fR(8) |
| 248 |
will be in effect\&. In this case, |
| 249 |
\fIrootfstype=\fR, |
| 250 |
\fIrootflags=\fR, |
| 251 |
\fIro\fR, |
| 252 |
\fIrw\fR |
| 253 |
will be interpreted by |
| 254 |
\fBsystemd\-gpt\-auto\-generator\fR\&. |
| 255 |
.sp |
| 256 |
Added in version 215\&. |
| 257 |
.RE |
| 258 |
.PP |
| 259 |
\fImount\&.usr=\fR, \fImount\&.usrfstype=\fR, \fImount\&.usrflags=\fR |
| 260 |
.RS 4 |
| 261 |
Configures the /usr file system (if required) and its file system type and mount options\&. For details, see |
| 262 |
\fBsystemd-fstab-generator\fR(8)\&. |
| 263 |
.sp |
| 264 |
Added in version 235\&. |
| 265 |
.RE |
| 266 |
.PP |
| 267 |
\fIveritytab=\fR, \fIrd\&.veritytab=\fR, \fIroothash=\fR, \fIsystemd\&.verity=\fR, \fIrd\&.systemd\&.verity=\fR, \fIsystemd\&.verity_root_data=\fR, \fIsystemd\&.verity_root_hash=\fR, \fIsystemd\&.verity_root_options=\fR, \fIusrhash=\fR, \fIsystemd\&.verity_usr_data=\fR, \fIsystemd\&.verity_usr_hash=\fR, \fIsystemd\&.verity_usr_options=\fR |
| 268 |
.RS 4 |
| 269 |
Configures the integrity protection root hash for the root and |
| 270 |
/usr |
| 271 |
file systems, and other related parameters\&. For details, see |
| 272 |
\fBsystemd-veritysetup-generator\fR(8)\&. |
| 273 |
.sp |
| 274 |
Added in version 233\&. |
| 275 |
.RE |
| 276 |
.PP |
| 277 |
\fIsystemd\&.getty_auto=\fR |
| 278 |
.RS 4 |
| 279 |
Configures whether the |
| 280 |
serial\-getty@\&.service |
| 281 |
will run\&. For details, see |
| 282 |
\fBsystemd-getty-generator\fR(8)\&. |
| 283 |
.sp |
| 284 |
Added in version 250\&. |
| 285 |
.RE |
| 286 |
.PP |
| 287 |
\fIsystemd\&.gpt_auto=\fR, \fIrd\&.systemd\&.gpt_auto=\fR |
| 288 |
.RS 4 |
| 289 |
Configures whether GPT\-based partition auto\-discovery shall be attempted\&. For details, see |
| 290 |
\fBsystemd-gpt-auto-generator\fR(8)\&. |
| 291 |
.sp |
| 292 |
Added in version 215\&. |
| 293 |
.RE |
| 294 |
.PP |
| 295 |
\fIsystemd\&.image_policy=\fR |
| 296 |
.RS 4 |
| 297 |
When GPT\-based partition auto\-discovery is used, configures the image dissection policy string to apply, as per |
| 298 |
\fBsystemd.image-policy\fR(7)\&. For details see |
| 299 |
\fBsystemd-gpt-auto-generator\fR(8)\&. |
| 300 |
.sp |
| 301 |
Added in version 254\&. |
| 302 |
.RE |
| 303 |
.PP |
| 304 |
\fIsystemd\&.image_filter=\fR |
| 305 |
.RS 4 |
| 306 |
When GPT\-based partition auto\-discovery is used, configures the image dissection filter string to apply, as per |
| 307 |
\fBsystemd.image-filter\fR(7)\&. For details see |
| 308 |
\fBsystemd-gpt-auto-generator\fR(8)\&. |
| 309 |
.sp |
| 310 |
Added in version 258\&. |
| 311 |
.RE |
| 312 |
.PP |
| 313 |
\fIsystemd\&.default_timeout_start_sec=\fR |
| 314 |
.RS 4 |
| 315 |
Overrides the default start job timeout |
| 316 |
\fIDefaultTimeoutStartSec=\fR |
| 317 |
at boot\&. For details, see |
| 318 |
\fBsystemd-system.conf\fR(5)\&. |
| 319 |
.sp |
| 320 |
Added in version 230\&. |
| 321 |
.RE |
| 322 |
.PP |
| 323 |
\fIsystemd\&.default_device_timeout_sec=\fR |
| 324 |
.RS 4 |
| 325 |
Overrides the default device timeout |
| 326 |
\fIDefaultDeviceTimeoutSec=\fR |
| 327 |
at boot\&. For details, see |
| 328 |
\fBsystemd-system.conf\fR(5)\&. |
| 329 |
.sp |
| 330 |
Added in version 254\&. |
| 331 |
.RE |
| 332 |
.PP |
| 333 |
\fIsystemd\&.watchdog_device=\fR |
| 334 |
.RS 4 |
| 335 |
Overrides the watchdog device path |
| 336 |
\fIWatchdogDevice=\fR\&. For details, see |
| 337 |
\fBsystemd-system.conf\fR(5)\&. |
| 338 |
.sp |
| 339 |
Added in version 236\&. |
| 340 |
.RE |
| 341 |
.PP |
| 342 |
\fIsystemd\&.watchdog_sec=\fR |
| 343 |
.RS 4 |
| 344 |
Overrides the watchdog timeout settings otherwise configured with |
| 345 |
\fIRuntimeWatchdog=\fR, |
| 346 |
\fIRebootWatchdog=\fR |
| 347 |
and |
| 348 |
\fIKExecWatchdogSec=\fR\&. Takes a time value (if no unit is specified, seconds is the implicitly assumed time unit) or the special strings |
| 349 |
"off" |
| 350 |
or |
| 351 |
"default"\&. For details, see |
| 352 |
\fBsystemd-system.conf\fR(5)\&. |
| 353 |
.sp |
| 354 |
Added in version 250\&. |
| 355 |
.RE |
| 356 |
.PP |
| 357 |
\fIsystemd\&.watchdog_pre_sec=\fR |
| 358 |
.RS 4 |
| 359 |
Overrides the watchdog pre\-timeout settings otherwise configured with |
| 360 |
\fIRuntimeWatchdogPreSec=\fR\&. Takes a time value (if no unit is specified, seconds is the implicitly assumed time unit) or the special strings |
| 361 |
"off" |
| 362 |
or |
| 363 |
"default"\&. For details, see |
| 364 |
\fBsystemd-system.conf\fR(5)\&. |
| 365 |
.sp |
| 366 |
Added in version 251\&. |
| 367 |
.RE |
| 368 |
.PP |
| 369 |
\fIsystemd\&.watchdog_pretimeout_governor=\fR |
| 370 |
.RS 4 |
| 371 |
Overrides the watchdog pre\-timeout settings otherwise configured with |
| 372 |
\fIRuntimeWatchdogPreGovernor=\fR\&. Takes a string value\&. For details, see |
| 373 |
\fBsystemd-system.conf\fR(5)\&. |
| 374 |
.sp |
| 375 |
Added in version 251\&. |
| 376 |
.RE |
| 377 |
.PP |
| 378 |
\fIsystemd\&.cpu_affinity=\fR |
| 379 |
.RS 4 |
| 380 |
Overrides the CPU affinity mask for the service manager and the default for all child processes it forks\&. This takes precedence over |
| 381 |
\fICPUAffinity=\fR, see |
| 382 |
\fBsystemd-system.conf\fR(5) |
| 383 |
for details\&. |
| 384 |
.sp |
| 385 |
Added in version 245\&. |
| 386 |
.RE |
| 387 |
.PP |
| 388 |
\fImodules_load=\fR, \fIrd\&.modules_load=\fR |
| 389 |
.RS 4 |
| 390 |
Load a specific kernel module early at boot\&. For details, see |
| 391 |
\fBsystemd-modules-load.service\fR(8)\&. |
| 392 |
.sp |
| 393 |
Added in version 187\&. |
| 394 |
.RE |
| 395 |
.PP |
| 396 |
\fInameserver=\fR, \fIdomain=\fR |
| 397 |
.RS 4 |
| 398 |
Configures DNS server information and search domains, see |
| 399 |
\fBsystemd-resolved.service\fR(8) |
| 400 |
for details\&. |
| 401 |
.sp |
| 402 |
Added in version 253\&. |
| 403 |
.RE |
| 404 |
.PP |
| 405 |
\fIresume=\fR, \fIresumeflags=\fR |
| 406 |
.RS 4 |
| 407 |
Enable resume from hibernation using the specified device and timeout options\&. All |
| 408 |
\fBfstab\fR(5)\-style device identifiers are supported\&. For details, see |
| 409 |
\fBsystemd-hibernate-resume-generator\fR(8)\&. |
| 410 |
.sp |
| 411 |
Added in version 217\&. |
| 412 |
.RE |
| 413 |
.PP |
| 414 |
\fIresume_offset=\fR |
| 415 |
.RS 4 |
| 416 |
Configure the page offset of the swap space from the resume device\&. For details, see |
| 417 |
\fBsystemd-hibernate-resume-generator\fR(8)\&. |
| 418 |
.sp |
| 419 |
Added in version 254\&. |
| 420 |
.RE |
| 421 |
.PP |
| 422 |
\fIsystemd\&.firstboot=\fR |
| 423 |
.RS 4 |
| 424 |
Takes a boolean argument, defaults to on\&. If off, |
| 425 |
\fBsystemd-firstboot.service\fR(8) |
| 426 |
and |
| 427 |
\fBsystemd-homed-firstboot.service\fR(1) |
| 428 |
will not query the user for basic system settings, even if the system boots up for the first time and the relevant settings are not initialized yet\&. Not to be confused with |
| 429 |
\fIsystemd\&.condition_first_boot=\fR |
| 430 |
(see below), which overrides the result of the |
| 431 |
\fIConditionFirstBoot=\fR |
| 432 |
unit file condition, and thus controls more than just |
| 433 |
systemd\-firstboot\&.service |
| 434 |
behaviour\&. |
| 435 |
.sp |
| 436 |
Added in version 233\&. |
| 437 |
.RE |
| 438 |
.PP |
| 439 |
\fIsystemd\&.condition_needs_update=\fR |
| 440 |
.RS 4 |
| 441 |
Takes a boolean argument\&. If specified, overrides the result of |
| 442 |
\fIConditionNeedsUpdate=\fR |
| 443 |
unit condition checks\&. See |
| 444 |
\fBsystemd.unit\fR(5) |
| 445 |
for details\&. |
| 446 |
.sp |
| 447 |
Added in version 246\&. |
| 448 |
.RE |
| 449 |
.PP |
| 450 |
\fIsystemd\&.condition_first_boot=\fR |
| 451 |
.RS 4 |
| 452 |
Takes a boolean argument\&. If specified, overrides the result of |
| 453 |
\fIConditionFirstBoot=\fR |
| 454 |
unit condition checks\&. See |
| 455 |
\fBsystemd.unit\fR(5) |
| 456 |
for details\&. Not to be confused with |
| 457 |
\fIsystemd\&.firstboot=\fR |
| 458 |
which only controls behaviour of the |
| 459 |
systemd\-firstboot\&.service |
| 460 |
system service but has no effect on the condition check (see above)\&. |
| 461 |
.sp |
| 462 |
Added in version 246\&. |
| 463 |
.RE |
| 464 |
.PP |
| 465 |
\fIsystemd\&.clock_usec=\fR |
| 466 |
.RS 4 |
| 467 |
Takes a decimal, numeric timestamp in μs since January 1st 1970, 00:00am, to set the system clock to\&. The system time is set to the specified timestamp early during boot\&. It is not propagated to the hardware clock (RTC)\&. |
| 468 |
.sp |
| 469 |
Added in version 246\&. |
| 470 |
.RE |
| 471 |
.PP |
| 472 |
\fIsystemd\&.random_seed=\fR |
| 473 |
.RS 4 |
| 474 |
Takes a base64 encoded random seed value to credit with full entropy to the kernel\*(Aqs random pool during early service manager initialization\&. This option is useful in testing environments where delays due to random pool initialization in entropy starved virtual machines shall be avoided\&. |
| 475 |
.sp |
| 476 |
Note that if this option is used the seed is accessible to unprivileged programs from |
| 477 |
/proc/cmdline\&. This option is hence a security risk when used outside of test systems, since the (possibly) only seed used for initialization of the kernel\*(Aqs entropy pool might be easily acquired by unprivileged programs\&. |
| 478 |
.sp |
| 479 |
It is recommended to pass 512 bytes of randomized data (as that matches the Linux kernel pool size), which may be generated with a command like the following: |
| 480 |
.sp |
| 481 |
.if n \{\ |
| 482 |
.RS 4 |
| 483 |
.\} |
| 484 |
.nf |
| 485 |
dd if=/dev/urandom bs=512 count=1 status=none | base64 \-w 0 |
| 486 |
.fi |
| 487 |
.if n \{\ |
| 488 |
.RE |
| 489 |
.\} |
| 490 |
.sp |
| 491 |
Again: do not use this option outside of testing environments, it is a security risk elsewhere, as secret key material derived from the entropy pool can possibly be reconstructed by unprivileged programs\&. |
| 492 |
.sp |
| 493 |
Added in version 246\&. |
| 494 |
.RE |
| 495 |
.PP |
| 496 |
\fIsystemd\&.allow_userspace_verity=\fR |
| 497 |
.RS 4 |
| 498 |
Takes a boolean argument\&. Controls whether disk images that are Verity protected may be authenticated in userspace signature checks via |
| 499 |
/etc/verity\&.d/*\&.crt |
| 500 |
(and related directories) public key drop\-ins, or whether in\-kernel signature checking only\&. Defaults to on\&. |
| 501 |
.sp |
| 502 |
Added in version 256\&. |
| 503 |
.RE |
| 504 |
.PP |
| 505 |
\fIsystemd\&.hostname=\fR |
| 506 |
.RS 4 |
| 507 |
Accepts a hostname to set during early boot\&. If specified takes precedence over what is set in |
| 508 |
/etc/hostname\&. Note that this does not bar later runtime changes to the hostname, it simply controls the initial hostname set during early boot\&. |
| 509 |
.sp |
| 510 |
Added in version 246\&. |
| 511 |
.RE |
| 512 |
.PP |
| 513 |
\fIsystemd\&.tty\&.term\&.\fR\fI\fItty\fR\fR\fI=\fR, \fIsystemd\&.tty\&.rows\&.\fR\fI\fItty\fR\fR\fI=\fR, \fIsystemd\&.tty\&.columns\&.\fR\fI\fItty\fR\fR\fI=\fR |
| 514 |
.RS 4 |
| 515 |
These arguments allow configuring default values for |
| 516 |
\fI$TERM\fR, |
| 517 |
\fITTYRows=\fR, and |
| 518 |
\fITTYColumns=\fR |
| 519 |
for tty |
| 520 |
\fItty\fR\&. Additionally, |
| 521 |
\fIsystemd\&.tty\&.term\&.console\fR |
| 522 |
will configure the |
| 523 |
\fI$TERM\fR |
| 524 |
value used by |
| 525 |
\fBsystemd\fR |
| 526 |
if not set explicitly using |
| 527 |
\fITERM\fR |
| 528 |
on the kernel command line\&. The tty name should be specified without the |
| 529 |
/dev/ |
| 530 |
prefix (e\&.g\&. |
| 531 |
"systemd\&.tty\&.rows\&.ttyS0=80")\&. |
| 532 |
.sp |
| 533 |
Added in version 254\&. |
| 534 |
.RE |
| 535 |
.PP |
| 536 |
\fIsystemd\&.battery_check=\fR |
| 537 |
.RS 4 |
| 538 |
Accepts a boolean argument\&. If false the boot\-time battery charge check implemented by |
| 539 |
\fBsystemd-battery-check.service\fR(8) |
| 540 |
is disabled\&. |
| 541 |
.sp |
| 542 |
Added in version 254\&. |
| 543 |
.RE |
| 544 |
.PP |
| 545 |
\fIifname=\fR, \fInet\&.ifname_policy=\fR |
| 546 |
.RS 4 |
| 547 |
Controls interface naming policies, implemented by |
| 548 |
\fBsystemd-network-generator.service\fR(8)\&. |
| 549 |
.sp |
| 550 |
Added in version 245\&. |
| 551 |
.RE |
| 552 |
.PP |
| 553 |
\fIsystemd\&.tpm2_allow_clear=\fR |
| 554 |
.RS 4 |
| 555 |
Controls whether to allow clearing of the TPM chip, implemented by |
| 556 |
\fBsystemd-tpm2-clear.service\fR(8)\&. |
| 557 |
.sp |
| 558 |
Added in version 258\&. |
| 559 |
.RE |
| 560 |
.PP |
| 561 |
\fIsystemd\&.tpm2_wait=\fR |
| 562 |
.RS 4 |
| 563 |
Controls whether to wait for a TPM2 device at boot, implemented by |
| 564 |
\fBsystemd-tpm2-generator\fR(8)\&. |
| 565 |
.sp |
| 566 |
Added in version 256\&. |
| 567 |
.RE |
| 568 |
.PP |
| 569 |
\fIsystemd\&.tpm2_software_fallback=\fR |
| 570 |
.RS 4 |
| 571 |
Controls whether to start a fallback software TPM service in case a hardware TPM is not available, implemented by |
| 572 |
\fBsystemd-tpm2-generator\fR(8)\&. |
| 573 |
.sp |
| 574 |
Added in version 261\&. |
| 575 |
.RE |
| 576 |
.PP |
| 577 |
\fIsystemd\&.tpm2_measured_os=\fR |
| 578 |
.RS 4 |
| 579 |
Controls whether to execute various boot and runtime TPM PCR measurements\&. Takes a boolean argument\&. If not specified explicitly this behaviour is enabled automatically in case |
| 580 |
\fBsystemd-stub\fR(7) |
| 581 |
is used and it succeeded in doing pre\-boot measurements of the booted UKI, and otherwise disabled\&. |
| 582 |
.sp |
| 583 |
Added in version 261\&. |
| 584 |
.RE |
| 585 |
.PP |
| 586 |
\fIsystemd\&.factory_reset=\fR |
| 587 |
.RS 4 |
| 588 |
Controls whether to to boot into factory reset mode, implemented by |
| 589 |
\fBsystemd-factory-reset-generator\fR(8), |
| 590 |
\fBsystemd-repart\fR(8), and other tools\&. |
| 591 |
.sp |
| 592 |
Added in version 258\&. |
| 593 |
.RE |
| 594 |
.PP |
| 595 |
\fIsystemd\&.imds=\fR, \fIsystemd\&.imds\&.*=\fR |
| 596 |
.RS 4 |
| 597 |
Controls various Instance Metadata Service (IMDS) cloud aspects, see |
| 598 |
\[email protected]\fR(8) |
| 599 |
and |
| 600 |
\fBsystemd-imds-generator\fR(8) |
| 601 |
for details\&. |
| 602 |
.sp |
| 603 |
Added in version 261\&. |
| 604 |
.RE |
| 605 |
.PP |
| 606 |
\fIsystemd\&.sysext=\fR, \fIsystemd\&.confext=\fR, \fIrd\&.systemd\&.sysext=\fR, \fIrd\&.systemd\&.confext=\fR |
| 607 |
.RS 4 |
| 608 |
Take boolean arguments, default to on\&. Control whether system and configuration extensions for the initrd (\fIrd\&.systemd\&.sysext=\fR, |
| 609 |
\fIrd\&.systemd\&.confext=\fR) and for the main system (\fIsystemd\&.sysext=\fR, |
| 610 |
\fIsystemd\&.confext=\fR) are merged automatically on boot\&. See |
| 611 |
\fBsystemd-sysext\fR(8) |
| 612 |
for details\&. |
| 613 |
.sp |
| 614 |
Added in version 261\&. |
| 615 |
.RE |
| 616 |
.SH "HISTORY" |
| 617 |
.PP |
| 618 |
systemd 252 |
| 619 |
.RS 4 |
| 620 |
Kernel command\-line arguments |
| 621 |
\fIsystemd\&.unified_cgroup_hierarchy\fR |
| 622 |
and |
| 623 |
\fIsystemd\&.legacy_systemd_cgroup_controller\fR |
| 624 |
were deprecated\&. Please switch to the unified cgroup hierarchy\&. |
| 625 |
.RE |
| 626 |
.SH "SEE ALSO" |
| 627 |
.PP |
| 628 |
\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBbootparam\fR(7), \fBsystemd.system-credentials\fR(7), \fBsmbios-type-11\fR(7), \fBsystemd-debug-generator\fR(8), \[email protected]\fR(8), \[email protected]\fR(8), \fBsystemd-journald.service\fR(8), \fBsystemd-vconsole-setup.service\fR(8), \fBsystemd-udevd.service\fR(8), \fBplymouth\fR(8), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-veritysetup-generator\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-getty-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-volatile-root.service\fR(8), \fBsystemd-modules-load.service\fR(8), \[email protected]\fR(8), \fBsystemd-rfkill.service\fR(8), \fBsystemd-hibernate-resume-generator\fR(8), \fBsystemd-firstboot.service\fR(8), \fBbootctl\fR(1) |
| 629 |
.SH "NOTES" |
| 630 |
.IP " 1." 4 |
| 631 |
kernel-parameters.html |
| 632 |
.RS 4 |
| 633 |
\%https://docs.kernel.org/admin-guide/kernel-parameters.html |
| 634 |
.RE |