source: chapter08/systemd.xml@ e0f124e

11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 arm bdubbs/gcc13 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since e0f124e was 394bd9c, checked in by Xi Ruoyao <xry111@…>, 3 years ago

systemd: minor reword for Linux header >= 5.14 issue

It does not affect using systemd with Linux >= 5.14, but only affects
building systemd with kernel header >= 5.14.

  • Property mode set to 100644
File size: 32.2 KB
RevLine 
[f896e21c]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
[35a5259]8<sect1 id="ch-system-systemd" role="wrap" revision="systemd">
[cba2d4e]9 <?dbhtml filename="systemd.html"?>
[f896e21c]10
11 <sect1info condition="script">
[cba2d4e]12 <productname>systemd</productname>
[f896e21c]13 <productnumber>&systemd-version;</productnumber>
14 <address>&systemd-url;</address>
15 </sect1info>
16
[cba2d4e]17 <title>Systemd-&systemd-version;</title>
[f896e21c]18
[cba2d4e]19 <indexterm zone="ch-system-systemd">
[1118b17]20 <primary sortas="a-systemd">systemd</primary>
[f896e21c]21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
[1118b17]26 <para>The systemd package contains programs for controlling the startup,
[cba2d4e]27 running, and shutdown of the system.</para>
[f896e21c]28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
[fb386e0]34 <seg>&systemd-fin-sbu;</seg>
35 <seg>&systemd-fin-du;</seg>
[f896e21c]36 </seglistitem>
37 </segmentedlist>
38 </sect2>
39
40 <sect2 role="installation">
[1118b17]41 <title>Installation of systemd</title>
[70dcd88]42
[9f84752]43 <!--Fix CVE-2021-33910 -->
44 <para>First, apply a patch to fix a security vulnerability:</para>
[22009fb]45
[d7a9421]46<screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-upstream_fixes-1.patch</userinput></screen>
[22009fb]47
[8725cae]48<!-- Seems to be not needed anymore with 248
[e88a471b]49 <para>Remove tests that cannot be built in chroot:</para>
50
[d7a9421]51<screen><userinput remap="pre">sed '177,$ d' -i src/resolve/meson.build</userinput></screen>
[8725cae]52-->
[b55310e]53
[87119fd]54 <para>Remove two unneeded groups,
55 <systemitem class="groupname">render</systemitem> and
56 <systemitem class="groupname">sgx</systemitem>, from the default udev
[896e77e]57 rules:</para>
58
[1f201845]59 <screen><userinput remap="pre">sed -i -e 's/GROUP="render"/GROUP="video"/' \
[87119fd]60 -e 's/GROUP="sgx", //' rules.d/50-udev-default.rules.in</userinput></screen>
[896e77e]61
[3328dfd]62 <para>Fix a meson problem:</para>
[1f201845]63
64 <screen><userinput remap="pre">sed -i 's/+ want_libfuzzer.*$/and want_libfuzzer/' meson.build</userinput></screen>
65
[394bd9c]66 <para>Fix a problem when building with kernel headers from Linux-5.14 and
67 later:</para>
[0d78c2c]68
69 <screen><userinput remap="pre">sed -i '/ARPHRD_CAN/a#define ARPHRD_MCTP 290' src/basic/linux/if_arp.h</userinput></screen>
70
[1118b17]71 <para>Prepare systemd for compilation:</para>
72
[c556e59]73<screen><userinput remap="configure">mkdir -p build
[04b2165]74cd build
[fc199db]75
[0f703541]76LANG=en_US.UTF-8 \
77meson --prefix=/usr \
78 --sysconfdir=/etc \
79 --localstatedir=/var \
[06cdaed]80 --buildtype=release \
[0f703541]81 -Dblkid=true \
82 -Ddefault-dnssec=no \
83 -Dfirstboot=false \
84 -Dinstall-tests=false \
85 -Dldconfig=false \
86 -Dsysusers=false \
87 -Db_lto=false \
88 -Drpmmacrosdir=no \
89 -Dhomed=false \
90 -Duserdb=false \
[35e0479]91 -Dman=false \
[22009fb]92 -Dmode=release \
[1446892]93 -Ddocdir=/usr/share/doc/systemd-&systemd-version; \
[fc199db]94 ..</userinput></screen>
[cba2d4e]95
96 <variablelist>
[81ed05f]97 <title>The meaning of the meson options:</title>
[cba2d4e]98
[06cdaed]99 <varlistentry>
100 <term><parameter>--buildtype=release</parameter></term>
101 <listitem>
102 <para>This switch overrides the default buildtype
103 (<quote>debug</quote>), which would produce unoptimized
104 binaries.</para>
105 </listitem>
106 </varlistentry>
107
[cba2d4e]108 <varlistentry>
[81ed05f]109 <term><parameter>-Ddefault-dnssec=no</parameter></term>
[cba2d4e]110 <listitem>
[81ed05f]111 <para>This switch turns off the experimental DNSSEC support.</para>
[cba2d4e]112 </listitem>
113 </varlistentry>
114
115 <varlistentry>
[81ed05f]116 <term><parameter>-Dfirstboot=false</parameter></term>
[cba2d4e]117 <listitem>
[81ed05f]118 <para>This switch prevents installation of systemd
119 services responsible for setting up the system for
120 the first time. They are not useful for LFS because
121 everything is done manually.</para>
[cba2d4e]122 </listitem>
123 </varlistentry>
124
[e88a471b]125 <varlistentry>
126 <term><parameter>-Dinstall-tests=false</parameter></term>
127 <listitem>
128 <para>This switch prevents installation of the compiled tests.</para>
129 </listitem>
130 </varlistentry>
131
[cba2d4e]132 <varlistentry>
[0d84af1]133 <term><parameter>-Dldconfig=false</parameter></term>
[cba2d4e]134 <listitem>
[0d84af1]135 <para>This switch prevents installation of a systemd unit that runs
136 <command>ldconfig</command> at boot, which is not useful for source
137 distributions such as LFS and makes the boot time longer. Remove it
138 if the described feature is desired.</para>
[cba2d4e]139 </listitem>
140 </varlistentry>
141
[1118b17]142 <varlistentry>
[81ed05f]143 <term><parameter>-Dsysusers=false</parameter></term>
[1118b17]144 <listitem>
145 <para>This switch prevents installation of systemd
146 services responsible for setting up the
147 <filename>/etc/group</filename> and
148 <filename>/etc/passwd</filename> files. Both files
[0d84af1]149 were created earlier in this chapter.</para>
[cba2d4e]150 </listitem>
151 </varlistentry>
152
[c556e59]153 <varlistentry>
154 <term><parameter>-Drpmmacrosdir=no</parameter></term>
155 <listitem>
156 <para>This switch disables installation of RPM Macros
157 for use with systemd because LFS does not support RPM.</para>
158 </listitem>
159 </varlistentry>
[c06f49a]160
161 <varlistentry>
162 <term><parameter>-D{userdb,homed}=false</parameter></term>
163 <listitem>
164 <para>Remove two daemons that have dependencies that do not fit
165 the scope of LFS.</para>
166 </listitem>
167 </varlistentry>
168
[35e0479]169 <varlistentry>
170 <term><parameter>-Dman=false</parameter></term>
171 <listitem>
172 <para>Prevent the generation of man pages to avoid extra
173 dependencies. We will install pre-generated man pages for systemd
174 from a tarball later.</para>
175 </listitem>
176 </varlistentry>
177
[fe42b2f]178 <varlistentry>
179 <term><parameter>-Dmode=release</parameter></term>
180 <listitem>
181 <para>Disable some features considered experimental by upstream.
182 </para>
183 </listitem>
184 </varlistentry>
185
[cba2d4e]186 </variablelist>
187
188 <para>Compile the package:</para>
189
[fc199db]190<screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
[f896e21c]191
192 <para>Install the package:</para>
193
[81ed05f]194<screen><userinput remap="install">LANG=en_US.UTF-8 ninja install</userinput></screen>
[cba2d4e]195
[35e0479]196 <para>Install the man pages:</para>
[c556e59]197
[35e0479]198<screen><userinput remap="install">tar -xf ../../systemd-man-pages-&systemd-man-version;.tar.xz --strip-components=1 -C /usr/share/man</userinput></screen>
[c556e59]199
[4f8ae861]200 <para>Remove a useless directory:</para>
[a815ec7]201
202<screen><userinput remap="install">rm -rf /usr/lib/pam.d</userinput></screen>
203
[cba2d4e]204 <para>Create the <filename>/etc/machine-id</filename> file needed by
[1118b17]205 <command>systemd-journald</command>:</para>
[053b206]206
[15f0f21]207<screen><userinput remap="adjust">systemd-machine-id-setup</userinput></screen>
[cba2d4e]208
[8a0d39ee]209 <para>Setup the basic target structure:</para>
210
211<screen><userinput remap="adjust">systemctl preset-all</userinput></screen>
[777b5cb]212
213 <para>Disable a service that is known to cause problems with systems that
214 use a network configuration other than what is provided by
215 systemd-networkd:</para>
216 <!-- Observed halting startup with dhcpcd handling the primary NIC -->
[d672ab7]217
[777b5cb]218<screen><userinput remap="adjust">systemctl disable systemd-time-wait-sync.service</userinput></screen>
219
[a815ec7]220<!-- dev: 50-pid-max.conf is not removed in BLFS, so I commented the following out.
221 If it causes any trouble, we can add this back and also copy it into BLFS -->
222<!--
[777b5cb]223 <para>Prevent systemd from resetting the maximum PID value which causes
224 some problems with packages and units in BLFS:</para>
[d672ab7]225
[c06f49a]226<screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen>
[a815ec7]227-->
[777b5cb]228
[f896e21c]229 </sect2>
230
[cba2d4e]231 <sect2 id="contents-systemd" role="content">
[1118b17]232 <title>Contents of systemd</title>
[f896e21c]233
234 <segmentedlist>
235 <segtitle>Installed programs</segtitle>
236 <segtitle>Installed libraries</segtitle>
237 <segtitle>Installed directories</segtitle>
238
239 <seglistitem>
[78cc3be]240 <seg>bootctl, busctl, coredumpctl, halt (symlink to systemctl),
241 hostnamectl, init, journalctl, kernel-install, localectl, loginctl,
[d7a9421]242 machinectl, networkctl, oomctl, portablectl, poweroff (symlink to
[78cc3be]243 systemctl), reboot (symlink to systemctl), resolvconf (symlink to
244 resolvectl), resolvectl, runlevel (symlink to systemctl), shutdown
245 (symlink to systemctl), systemctl, systemd-analyze,
[1118b17]246 systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop,
[d7a9421]247 systemd-cryptenroll, systemd-delta, systemd-detect-virt,
248 systemd-dissect, systemd-escape, systemd-hwdb, systemd-id128,
249 systemd-inhibit, systemd-machine-id-setup,
[78cc3be]250 systemd-mount, systemd-notify, systemd-nspawn, systemd-path,
[c06f49a]251 systemd-repart, systemd-resolve (symlink to resolvectl), systemd-run,
[d7a9421]252 systemd-socket-activate, systemd-stdio-bridge, systemd-sysext,
253 systemd-tmpfiles, systemd-tty-ask-password-agent,
254 systemd-umount (symlink to systemd-mount),
255 telinit (symlink to systemctl), timedatectl, and udevadm</seg>
[1118b17]256 <seg>libnss_myhostname.so.2, libnss_mymachines.so.2,
[78cc3be]257 libnss_resolve.so.2, libnss_systemd.so.2,
[d7a9421]258 libsystemd.so, libsystemd-shared-&systemd-version;.so (in /usr/lib/systemd),
[a840e59]259 and libudev.so</seg>
[cba2d4e]260 <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,
261 /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
[d7a9421]262 /etc/xdg/systemd, /usr/lib/systemd, /usr/lib/udev, /usr/include/systemd,
[d672ab7]263 /usr/lib/binfmt.d, /usr/lib/environment.d, /usr/lib/kernel,
264 /usr/lib/modules-load.d, /usr/lib/sysctl.d, /usr/lib/systemd,
[2ca70d33]265 /usr/lib/tmpfiles.d,
[1118b17]266 /usr/share/doc/systemd-&systemd-version;, /usr/share/factory,
267 /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg>
[f896e21c]268 </seglistitem>
269 </segmentedlist>
270
271 <variablelist>
272 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
273 <?dbfo list-presentation="list"?>
274 <?dbhtml list-presentation="table"?>
275
[cba2d4e]276 <varlistentry id="bootctl">
277 <term><command>bootctl</command></term>
278 <listitem>
[9e7475a]279 <para>Is used to query the firmware and boot manager settings</para>
[cba2d4e]280 <indexterm zone="ch-system-systemd bootctl">
281 <primary sortas="b-bootctl">bootctl</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="busctl">
287 <term><command>busctl</command></term>
288 <listitem>
[9e7475a]289 <para>Is used to introspect and monitor the D-Bus bus</para>
[cba2d4e]290 <indexterm zone="ch-system-systemd busctl">
291 <primary sortas="b-busctl">busctl</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
[1118b17]296 <varlistentry id="coredumpctl">
297 <term><command>coredumpctl</command></term>
298 <listitem>
[9e7475a]299 <para>Is used to retrieve coredumps from the systemd journal</para>
[1118b17]300 <indexterm zone="ch-system-systemd coredumpctl">
301 <primary sortas="b-coredumpctl">coredumpctl</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
[cba2d4e]306 <varlistentry id="halt">
307 <term><command>halt</command></term>
308 <listitem>
309 <para>Normally invokes <command>shutdown</command> with the
310 <parameter>-h</parameter> option, except when already in run-level 0,
311 then it tells the kernel to halt the system; it notes in the
312 file <filename>/var/log/wtmp</filename> that the system is being
[1118b17]313 brought down</para>
[cba2d4e]314 <indexterm zone="ch-system-systemd halt">
315 <primary sortas="b-halt">halt</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="hostnamectl">
321 <term><command>hostnamectl</command></term>
322 <listitem>
[9e7475a]323 <para>Is used to query and change the system hostname and related
[1118b17]324 settings</para>
[cba2d4e]325 <indexterm zone="ch-system-systemd hostnamectl">
326 <primary sortas="b-hostnamectl">hostnamectl</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="init">
332 <term><command>init</command></term>
333 <listitem>
[9e7475a]334 <para>Is the first process to be started when the kernel has initialized
[d672ab7]335 the hardware which takes over the boot process and starts all
[9e7475a]336 processes according to its configuration files. In this case, it starts
[8d35535]337 systemd</para>
[cba2d4e]338 <indexterm zone="ch-system-systemd init">
339 <primary sortas="b-init">init</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="journalctl">
345 <term><command>journalctl</command></term>
346 <listitem>
[9e7475a]347 <para>Is used to query the contents of the systemd journal</para>
[cba2d4e]348 <indexterm zone="ch-system-systemd journalctl">
349 <primary sortas="b-journalctl">journalctl</primary>
350 </indexterm>
351 </listitem>
352 </varlistentry>
353
354 <varlistentry id="kernel-install">
355 <term><command>kernel-install</command></term>
356 <listitem>
[9e7475a]357 <para>Is used to add and remove kernel and initramfs images to and
[8d35535]358 from /boot. In LFS, this is done manually</para>
[cba2d4e]359 <indexterm zone="ch-system-systemd kernel-install">
360 <primary sortas="b-kernel-install">kernel-install</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="localectl">
366 <term><command>localectl</command></term>
367 <listitem>
[9e7475a]368 <para>Is used to query and change the system locale and keyboard layout
[1118b17]369 settings</para>
[cba2d4e]370 <indexterm zone="ch-system-systemd localectl">
371 <primary sortas="b-localectl">localectl</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="loginctl">
377 <term><command>loginctl</command></term>
378 <listitem>
[9e7475a]379 <para>Is used to introspect and control the state of the systemd Login
[1118b17]380 Manager</para>
[cba2d4e]381 <indexterm zone="ch-system-systemd loginctl">
382 <primary sortas="b-loginctl">loginctl</primary>
383 </indexterm>
384 </listitem>
385 </varlistentry>
386
387 <varlistentry id="machinectl">
388 <term><command>machinectl</command></term>
389 <listitem>
[9e7475a]390 <para>Is used to introspect and control the state of the systemd Virtual
[cba2d4e]391 Machine and Container Registration Manager</para>
392 <indexterm zone="ch-system-systemd machinectl">
393 <primary sortas="b-machinectl">machinectl</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
[1118b17]398 <varlistentry id="networkctl">
399 <term><command>networkctl</command></term>
400 <listitem>
[d672ab7]401 <para>Is used to introspect and configure the state of the network
[9e7475a]402 links configured by systemd-networkd</para>
[1118b17]403 <indexterm zone="ch-system-systemd networkctl">
404 <primary sortas="b-networkctl">networkctl</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
[d7a9421]409 <varlistentry id="oomctl">
410 <term><command>oomctl</command></term>
411 <listitem>
412 <para>Controls the systemd Out Of Memory daemon</para>
413 <indexterm zone="ch-system-systemd oomctl">
414 <primary sortas="b-oomctl">oomctl</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
[78cc3be]419 <varlistentry id="portablectl">
420 <term><command>portablectl</command></term>
421 <listitem>
[9e7475a]422 <para>Is used to attach or detach portable services from the local
[78cc3be]423 system</para>
424 <indexterm zone="ch-system-systemd portablectl">
425 <primary sortas="b-portablectl">portablectl</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
[cba2d4e]430 <varlistentry id="poweroff">
431 <term><command>poweroff</command></term>
432 <listitem>
[9e7475a]433 <para>Instructs the kernel to halt the system and switch off the computer
[1118b17]434 (see <command>halt</command>)</para>
[cba2d4e]435 <indexterm zone="ch-system-systemd poweroff">
436 <primary sortas="b-poweroff">poweroff</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="reboot">
442 <term><command>reboot</command></term>
[f896e21c]443 <listitem>
[9e7475a]444 <para>Instructs the kernel to reboot the system (see
[1118b17]445 <command>halt</command>)</para>
[cba2d4e]446 <indexterm zone="ch-system-systemd reboot">
447 <primary sortas="b-reboot">reboot</primary>
[f896e21c]448 </indexterm>
449 </listitem>
450 </varlistentry>
451
[78cc3be]452 <varlistentry id="resolvconf">
453 <term><command>resolvconf</command></term>
454 <listitem>
[9e7475a]455 <para>Registers DNS server and domain configuration with
[93058448]456 <command>systemd-resolved</command></para>
[78cc3be]457 <indexterm zone="ch-system-systemd resolvconf">
458 <primary sortas="b-resolvconf">resolvconf</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462
463 <varlistentry id="resolvectl">
464 <term><command>resolvectl</command></term>
465 <listitem>
[9e7475a]466 <para>Sends control commands to the network name resolution
467 manager, or resolves domain names, IPv4 and IPv6 addresses,
[8d35535]468 DNS records, and services</para>
[78cc3be]469 <indexterm zone="ch-system-systemd resolvectl">
470 <primary sortas="b-resolvectl">resolvectl</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474
[cba2d4e]475 <varlistentry id="runlevel">
476 <term><command>runlevel</command></term>
[f896e21c]477 <listitem>
[9e7475a]478 <para>Outputs the previous and the current run-level, as noted in the
[02776dff]479 last run-level record in <filename>/run/utmp</filename></para>
[cba2d4e]480 <indexterm zone="ch-system-systemd runlevel">
481 <primary sortas="b-runlevel">runlevel</primary>
[f896e21c]482 </indexterm>
483 </listitem>
484 </varlistentry>
485
[cba2d4e]486 <varlistentry id="shutdown">
487 <term><command>shutdown</command></term>
[f896e21c]488 <listitem>
[d672ab7]489 <para>Brings the system down in a safe and secure manner, signaling
[9e7475a]490 all processes and notifying all logged-in users</para>
[cba2d4e]491 <indexterm zone="ch-system-systemd shutdown">
492 <primary sortas="b-shutdown">shutdown</primary>
[f896e21c]493 </indexterm>
494 </listitem>
495 </varlistentry>
496
[cba2d4e]497 <varlistentry id="systemctl">
498 <term><command>systemctl</command></term>
[f896e21c]499 <listitem>
[9e7475a]500 <para>Is used to introspect and control the state of the systemd system
[1118b17]501 and service manager</para>
[cba2d4e]502 <indexterm zone="ch-system-systemd systemctl">
503 <primary sortas="b-systemctl">systemctl</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="systemd-analyze">
509 <term><command>systemd-analyze</command></term>
510 <listitem>
[9e7475a]511 <para>Is used to determine system startup performance of the current
512 boot, as well as identify troublesome systemd units</para>
[cba2d4e]513 <indexterm zone="ch-system-systemd systemd-analyze">
514 <primary sortas="b-systemd-analyze">systemd-analyze</primary>
515 </indexterm>
516 </listitem>
517 </varlistentry>
518
519 <varlistentry id="systemd-ask-password">
520 <term><command>systemd-ask-password</command></term>
521 <listitem>
[9e7475a]522 <para>Is used to query a system password or passphrase from the user,
[1118b17]523 using a question message specified on the command line</para>
[cba2d4e]524 <indexterm zone="ch-system-systemd systemd-ask-password">
525 <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
526 </indexterm>
527 </listitem>
528 </varlistentry>
529
530 <varlistentry id="systemd-cat">
531 <term><command>systemd-cat</command></term>
532 <listitem>
[9e7475a]533 <para>Is used to connect the STDOUT and STDERR outputs of a process
[8d35535]534 with the systemd journal
[cba2d4e]535 </para>
536 <indexterm zone="ch-system-systemd systemd-cat">
537 <primary sortas="b-systemd-cat">systemd-cat</primary>
538 </indexterm>
539 </listitem>
540 </varlistentry>
541
542 <varlistentry id="systemd-cgls">
543 <term><command>systemd-cgls</command></term>
544 <listitem>
[1118b17]545 <para>Recursively shows the contents of the selected Linux control
546 group hierarchy in a tree</para>
[cba2d4e]547 <indexterm zone="ch-system-systemd systemd-cgls">
548 <primary sortas="b-systemd-cgls">systemd-cgls</primary>
549 </indexterm>
550 </listitem>
551 </varlistentry>
552
553 <varlistentry id="systemd-cgtop">
554 <term><command>systemd-cgtop</command></term>
555 <listitem>
[1118b17]556 <para>Shows the top control groups of the local Linux control group
557 hierarchy, ordered by their CPU, memory and disk I/O load</para>
[cba2d4e]558 <indexterm zone="ch-system-systemd systemd-cgtop">
559 <primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
560 </indexterm>
561 </listitem>
562 </varlistentry>
563
[d7a9421]564 <varlistentry id="systemd-cryptenroll">
565 <term><command>systemd-cryptenroll</command></term>
566 <listitem>
567 <para>Is used to enroll or remove a system from full disk encryption,
568 as well as set and query private keys and recovery keys</para>
569 <indexterm zone="ch-system-systemd systemd-cryptenroll">
570 <primary sortas="b-systemd-cryptenroll">systemd-cryptenroll</primary>
571 </indexterm>
572 </listitem>
573 </varlistentry>
574
[cba2d4e]575 <varlistentry id="systemd-delta">
576 <term><command>systemd-delta</command></term>
577 <listitem>
[9e7475a]578 <para>Is used to identify and compare configuration files in
[cba2d4e]579 <filename class="directory">/etc</filename> that override default
[1118b17]580 counterparts in <filename class="directory">/usr</filename></para>
[cba2d4e]581 <indexterm zone="ch-system-systemd systemd-delta">
582 <primary sortas="b-systemd-delta">systemd-delta</primary>
583 </indexterm>
584 </listitem>
585 </varlistentry>
586
587 <varlistentry id="systemd-detect-virt">
588 <term><command>systemd-detect-virt</command></term>
589 <listitem>
[9e7475a]590 <para>Detects whether the system is being run in a virtual
[8d35535]591 environment, and adjusts udev accordingly</para>
[cba2d4e]592 <indexterm zone="ch-system-systemd systemd-detect-virt">
593 <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
594 </indexterm>
595 </listitem>
596 </varlistentry>
597
[22009fb]598 <varlistentry id="systemd-dissect">
599 <term><command>systemd-dissect</command></term>
600 <listitem>
[8d35535]601 <para>Is used to inspect OS disk images</para>
[22009fb]602 <indexterm zone="ch-system-systemd systemd-dissect">
603 <primary sortas="b-systemd-dissect">systemd-dissect</primary>
604 </indexterm>
605 </listitem>
606 </varlistentry>
607
[1118b17]608 <varlistentry id="systemd-escape">
609 <term><command>systemd-escape</command></term>
610 <listitem>
[9e7475a]611 <para>Is used to escape strings for inclusion in systemd unit
[1118b17]612 names</para>
613 <indexterm zone="ch-system-systemd systemd-escape">
614 <primary sortas="b-systemd-escape">systemd-escape</primary>
615 </indexterm>
616 </listitem>
617 </varlistentry>
618
619 <varlistentry id="systemd-hwdb">
620 <term><command>systemd-hwdb</command></term>
621 <listitem>
[9e7475a]622 <para>Is used to manage the hardware database (hwdb)</para>
[1118b17]623 <indexterm zone="ch-system-systemd systemd-hwdb">
624 <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
625 </indexterm>
626 </listitem>
627 </varlistentry>
628
[78cc3be]629 <varlistentry id="systemd-id128">
630 <term><command>systemd-id128</command></term>
631 <listitem>
[9e7475a]632 <para>Generates and prints id128 strings</para>
[78cc3be]633 <indexterm zone="ch-system-systemd systemd-id128">
634 <primary sortas="b-systemd-id128">systemd-id128</primary>
635 </indexterm>
636 </listitem>
637 </varlistentry>
638
[cba2d4e]639 <varlistentry id="systemd-inhibit">
640 <term><command>systemd-inhibit</command></term>
641 <listitem>
[9e7475a]642 <para>Is used to execute a program with a shutdown, sleep or idle
643 inhibitor lock taken, preventing an action such as a system shutdown
[8d35535]644 until the process is completed</para>
[cba2d4e]645 <indexterm zone="ch-system-systemd systemd-inhibit">
646 <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
647 </indexterm>
648 </listitem>
649 </varlistentry>
650
651 <varlistentry id="systemd-machine-id-setup">
652 <term><command>systemd-machine-id-setup</command></term>
653 <listitem>
[9e7475a]654 <para>Is used by system installer tools to initialize the machine ID
[1118b17]655 stored in <filename>/etc/machine-id</filename> at install time with a
656 randomly generated ID</para>
[cba2d4e]657 <indexterm zone="ch-system-systemd systemd-machine-id-setup">
658 <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary>
659 </indexterm>
660 </listitem>
661 </varlistentry>
662
[13c8b42]663 <varlistentry id="systemd-mount">
664 <term><command>systemd-mount</command></term>
665 <listitem>
[8d35535]666 <para>Is used to temporarily mount or automount disks</para>
[13c8b42]667 <indexterm zone="ch-system-systemd systemd-mount">
668 <primary sortas="b-systemd-mount">systemd-mount</primary>
669 </indexterm>
670 </listitem>
671 </varlistentry>
672
[cba2d4e]673 <varlistentry id="systemd-notify">
674 <term><command>systemd-notify</command></term>
675 <listitem>
[9e7475a]676 <para>Is used by daemon scripts to notify the init system about status
[1118b17]677 changes</para>
[cba2d4e]678 <indexterm zone="ch-system-systemd systemd-notify">
679 <primary sortas="b-systemd-notify">systemd-notify</primary>
680 </indexterm>
681 </listitem>
682 </varlistentry>
683
684 <varlistentry id="systemd-nspawn">
685 <term><command>systemd-nspawn</command></term>
686 <listitem>
[9e7475a]687 <para>Is used to run a command or OS in a light-weight namespace
[1118b17]688 container</para>
[cba2d4e]689 <indexterm zone="ch-system-systemd systemd-nspawn">
690 <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
691 </indexterm>
692 </listitem>
693 </varlistentry>
694
[1118b17]695 <varlistentry id="systemd-path">
696 <term><command>systemd-path</command></term>
697 <listitem>
[9e7475a]698 <para>Is used to query system and user paths</para>
[1118b17]699 <indexterm zone="ch-system-systemd systemd-path">
700 <primary sortas="b-systemd-path">systemd-path</primary>
701 </indexterm>
702 </listitem>
703 </varlistentry>
704
[c06f49a]705 <varlistentry id="systemd-repart">
706 <term><command>systemd-repart</command></term>
707 <listitem>
[9e7475a]708 <para>Is used to grow and add partitions to a partition table when
[8d35535]709 systemd is used in an OS image (e.g. a container)</para>
[c06f49a]710 <indexterm zone="ch-system-systemd systemd-repart">
711 <primary sortas="b-systemd-repart">systemd-repart</primary>
712 </indexterm>
713 </listitem>
714 </varlistentry>
715
[1118b17]716 <varlistentry id="systemd-resolve">
717 <term><command>systemd-resolve</command></term>
718 <listitem>
[9e7475a]719 <para>Is used to resolve domain names, IPV4 and IPv6 addresses, DNS
[1118b17]720 resource records, and services</para>
721 <indexterm zone="ch-system-systemd systemd-resolve">
722 <primary sortas="b-systemd-resolve">systemd-resolve</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
[cba2d4e]727 <varlistentry id="systemd-run">
728 <term><command>systemd-run</command></term>
729 <listitem>
[9e7475a]730 <para>Is used to create and start a transient .service or a .scope
731 unit and run the specified command in it. This is useful for
[8d35535]732 validating systemd units</para>
[cba2d4e]733 <indexterm zone="ch-system-systemd systemd-run">
734 <primary sortas="b-systemd-run">systemd-run</primary>
735 </indexterm>
736 </listitem>
737 </varlistentry>
738
[13c8b42]739 <varlistentry id="systemd-socket-activate">
740 <term><command>systemd-socket-activate</command></term>
741 <listitem>
[9e7475a]742 <para>Is used to listen on socket devices and launch a process upon
[8d35535]743 a successful connection to the socket</para>
[13c8b42]744 <indexterm zone="ch-system-systemd systemd-socket-activate">
745 <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
746 </indexterm>
747 </listitem>
748 </varlistentry>
749
[d7a9421]750 <varlistentry id="systemd-sysext">
751 <term><command>systemd-sysext</command></term>
752 <listitem>
[871fd2f]753 <para>Activates system extension images</para>
[d7a9421]754 <indexterm zone="ch-system-systemd systemd-sysext">
755 <primary sortas="b-systemd-sysext">systemd-sysext</primary>
756 </indexterm>
757 </listitem>
758 </varlistentry>
759
[cba2d4e]760 <varlistentry id="systemd-tmpfiles">
761 <term><command>systemd-tmpfiles</command></term>
762 <listitem>
[1118b17]763 <para>Creates, deletes and cleans up volatile and temporary files and
764 directories, based on the configuration file format and location
765 specified in
766 <filename class="directory">tmpfiles.d</filename> directories</para>
[cba2d4e]767 <indexterm zone="ch-system-systemd systemd-tmpfiles">
768 <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary>
769 </indexterm>
770 </listitem>
771 </varlistentry>
772
[78cc3be]773 <varlistentry id="systemd-umount">
774 <term><command>systemd-umount</command></term>
775 <listitem>
[9e7475a]776 <para>Unmounts mount points</para>
[78cc3be]777 <indexterm zone="ch-system-systemd systemd-umount">
778 <primary sortas="b-systemd-umount">systemd-umount</primary>
779 </indexterm>
780 </listitem>
781 </varlistentry>
782
[cba2d4e]783 <varlistentry id="systemd-tty-ask-password-agent">
784 <term><command>systemd-tty-ask-password-agent</command></term>
785 <listitem>
[d672ab7]786 <para>Is used to list and/or process pending systemd password
[9e7475a]787 requests</para>
[cba2d4e]788 <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
789 <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
790 </indexterm>
791 </listitem>
792 </varlistentry>
793
794 <varlistentry id="telinit">
795 <term><command>telinit</command></term>
796 <listitem>
[1118b17]797 <para>Tells <command>init</command> which run-level to change
798 to</para>
[cba2d4e]799 <indexterm zone="ch-system-systemd telinit">
800 <primary sortas="b-telinit">telinit</primary>
801 </indexterm>
802 </listitem>
803 </varlistentry>
804
805 <varlistentry id="timedatectl">
806 <term><command>timedatectl</command></term>
807 <listitem>
[9e7475a]808 <para>Is used to query and change the system clock and its settings
[cba2d4e]809 </para>
810 <indexterm zone="ch-system-systemd timedatectl">
811 <primary sortas="b-timedatectl">timedatectl</primary>
[f896e21c]812 </indexterm>
813 </listitem>
814 </varlistentry>
815
816 <varlistentry id="udevadm">
817 <term><command>udevadm</command></term>
818 <listitem>
[d672ab7]819 <para>Is a generic udev administration tool which controls the udevd
820 daemon, provides info from the Udev hardware database, monitors
821 uevents, waits for uevents to finish, tests udev configuration, and
[9e7475a]822 triggers uevents for a given device</para>
[cba2d4e]823 <indexterm zone="ch-system-systemd udevadm">
[f896e21c]824 <primary sortas="b-udevadm">udevadm</primary>
825 </indexterm>
826 </listitem>
827 </varlistentry>
828
[cba2d4e]829 <varlistentry id="libsystemd">
830 <term><filename class="libraryfile">libsystemd</filename></term>
[f896e21c]831 <listitem>
[9e7475a]832 <para>Is the main systemd utility library</para>
[cba2d4e]833 <indexterm zone="ch-system-systemd libsystemd">
834 <primary sortas="c-libsystemd">libsystemd</primary>
[f896e21c]835 </indexterm>
836 </listitem>
837 </varlistentry>
838
839 <varlistentry id="libudev">
840 <term><filename class="libraryfile">libudev</filename></term>
841 <listitem>
[9e7475a]842 <para>Is a library to access Udev device information</para>
[cba2d4e]843 <indexterm zone="ch-system-systemd libudev">
[f896e21c]844 <primary sortas="c-libudev">libudev</primary>
845 </indexterm>
846 </listitem>
847 </varlistentry>
848
849 </variablelist>
850
851 </sect2>
852
853</sect1>
Note: See TracBrowser for help on using the repository browser.