source: chapter08/systemd.xml@ 86e2762

12.2 12.2-rc1 multilib trunk xry111/arm64 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.2 xry111/mips64el xry111/multilib
Last change on this file since 86e2762 was 86e2762, checked in by Xi Ruoyao <xry111@…>, 2 months ago

systemd: Update known failures

I can only reproduce test-namespace failure now with 256.1.

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