source: chapter08/systemd.xml@ d24dc0f

multilib
Last change on this file since d24dc0f was d24dc0f, checked in by Thomas Trepl (Moody) <thomas@…>, 2 years ago

Merge upstream changes
  • Property mode set to 100644
File size: 36.6 KB
Line 
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
8<sect1 id="ch-system-systemd" role="wrap" revision="systemd">
9 <?dbhtml filename="systemd.html"?>
10
11 <sect1info condition="script">
12 <productname>systemd</productname>
13 <productnumber>&systemd-version;</productnumber>
14 <address>&systemd-url;</address>
15 </sect1info>
16
17 <title>Systemd-&systemd-version;</title>
18
19 <indexterm zone="ch-system-systemd">
20 <primary sortas="a-systemd">systemd</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The systemd package contains programs for controlling the startup,
27 running, and shutdown of the system.</para>
28
29 <segmentedlist>
30 <segtitle>&buildtime;</segtitle>
31 <segtitle>&diskspace;</segtitle>
32
33 <seglistitem>
34 <seg>&systemd-fin-sbu;</seg>
35 <seg>&systemd-fin-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of systemd</title>
42
43 <!--Fix CVE-2021-33910 -->
44 <para>First, apply a patch to fix a security vulnerability:</para>
45
46<screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-upstream_fixes-1.patch</userinput></screen>
47
48<!-- Seems to be not needed anymore with 248
49 <para>Remove tests that cannot be built in chroot:</para>
50
51<screen><userinput remap="pre">sed '177,$ d' -i src/resolve/meson.build</userinput></screen>
52-->
53
54 <para>Remove two unneeded groups,
55 <systemitem class="groupname">render</systemitem> and
56 <systemitem class="groupname">sgx</systemitem>, from the default udev
57 rules:</para>
58
59 <screen><userinput remap="pre">sed -i -e 's/GROUP="render"/GROUP="video"/' \
60 -e 's/GROUP="sgx", //' rules.d/50-udev-default.rules.in</userinput></screen>
61
62 <para>Fix a meson problem:</para>
63
64 <screen><userinput remap="pre">sed -i 's/+ want_libfuzzer.*$/and want_libfuzzer/' meson.build</userinput></screen>
65
66 <para>Fix a problem when building with kernel headers from Linux-5.14 and
67 later:</para>
68
69 <screen><userinput remap="pre">sed -i '/ARPHRD_CAN/a#define ARPHRD_MCTP 290' src/basic/linux/if_arp.h</userinput></screen>
70
71 <para>Prepare systemd for compilation:</para>
72
73<screen><userinput remap="configure">mkdir -p build
74cd build
75
76LANG=en_US.UTF-8 \
77meson --prefix=/usr \
78 --sysconfdir=/etc \
79 --localstatedir=/var \
80 --buildtype=release \
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 \
91 -Dman=false \
92 -Dmode=release \
93 -Ddocdir=/usr/share/doc/systemd-&systemd-version; \
94 ..</userinput></screen>
95
96 <variablelist>
97 <title>The meaning of the meson options:</title>
98
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
108 <varlistentry>
109 <term><parameter>-Ddefault-dnssec=no</parameter></term>
110 <listitem>
111 <para>This switch turns off the experimental DNSSEC support.</para>
112 </listitem>
113 </varlistentry>
114
115 <varlistentry>
116 <term><parameter>-Dfirstboot=false</parameter></term>
117 <listitem>
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>
122 </listitem>
123 </varlistentry>
124
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
132 <varlistentry>
133 <term><parameter>-Dldconfig=false</parameter></term>
134 <listitem>
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>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry>
143 <term><parameter>-Dsysusers=false</parameter></term>
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
149 were created earlier in this chapter.</para>
150 </listitem>
151 </varlistentry>
152
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>
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
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
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
186 </variablelist>
187
188 <para>Compile the package:</para>
189
190<screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
191
192 <para>Install the package:</para>
193
194<screen><userinput remap="install">LANG=en_US.UTF-8 ninja install</userinput></screen>
195
196 <para>Install the man pages:</para>
197
198<screen><userinput remap="install">tar -xf ../../systemd-man-pages-&systemd-man-version;.tar.xz --strip-components=1 -C /usr/share/man</userinput></screen>
199
200 <para>Remove a useless directory:</para>
201
202<screen><userinput remap="install">rm -rf /usr/lib/pam.d</userinput></screen>
203
204 <para>Create the <filename>/etc/machine-id</filename> file needed by
205 <command>systemd-journald</command>:</para>
206
207<screen><userinput remap="adjust">systemd-machine-id-setup</userinput></screen>
208
209 <para>Setup the basic target structure:</para>
210
211<screen><userinput remap="adjust">systemctl preset-all</userinput></screen>
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 -->
217
218<screen><userinput remap="adjust">systemctl disable systemd-time-wait-sync.service</userinput></screen>
219
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<!--
223 <para>Prevent systemd from resetting the maximum PID value which causes
224 some problems with packages and units in BLFS:</para>
225
226<screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen>
227-->
228
229 </sect2>
230
231 <!-- - - - - - - - - - -->
232 <!-- Multilib - 32bit -->
233 <!-- - - - - - - - - - -->
234
235 <sect2 arch="ml_32,ml_all" role="installation">
236 <title>Installation of systemd - 32-bit</title>
237
238 <para>Clean previous build:</para>
239
240<screen><userinput remap="pre">rm -rf *</userinput></screen>
241
242 <para>Create a symlink to work around missing xsltproc:</para>
243
244<!-- screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen -->
245<screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
246
247<!-- with cross-LFS we have util-linux in place:
248 <para>Because we have not yet installed the final version of Util-Linux,
249 create links to the libraries in the approprite location:</para>
250
251<screen><userinput remap="pre">for file in /tools/lib32/lib{blkid,mount,uuid}*; do
252 ln -sf $file /usr/lib32/
253done</userinput></screen>
254-->
255
256 <para>Prepare systemd for compilation:</para>
257
258 <screen><userinput remap="configure">PKG_CONFIG_PATH="/usr/lib32/pkgconfig" \
259CC="gcc -m32 -march=i686" \
260CXX="g++ -m32 -march=i686" \
261LANG=en_US.UTF-8 \
262meson --prefix=/usr \
263 --sysconfdir=/etc \
264 --localstatedir=/var \
265 -Dblkid=true \
266 -Dbuildtype=release \
267 -Ddefault-dnssec=no \
268 -Dfirstboot=false \
269 -Dinstall-tests=false \
270 -Dkill-path=/bin/kill \
271 -Dkmod-path=/bin/kmod \
272 -Dldconfig=false \
273 -Dmount-path=/bin/mount \
274 -Drootprefix= \
275 -Drootlibdir=/usr/lib32 \
276 -Dsplit-usr=true \
277 -Dsulogin-path=/sbin/sulogin \
278 -Dsysusers=false \
279 -Dumount-path=/bin/umount \
280 -Db_lto=false \
281 ..</userinput></screen>
282
283 <para>Compile the package:</para>
284
285<screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
286
287 <para>Install the package:</para>
288
289<screen><userinput remap="install">LANG=en_US.UTF-8 DESTDIR=$PWD/DESTDIR ninja install
290cp -Rv DESTDIR/usr/lib32/* /usr/lib32
291rm -rf DESTDIR
292rm -f /usr/bin/xsltproc</userinput></screen>
293
294 </sect2><!-- m32 -->
295
296 <!-- - - - - - - - - - -->
297 <!-- Multilib - x32bit -->
298 <!-- - - - - - - - - - -->
299
300 <sect2 arch="ml_x32,ml_all" role="installation">
301 <title>Installation of systemd - x32-bit</title>
302
303 <para>Clean previous build:</para>
304
305<screen><userinput remap="pre">rm -rf *</userinput></screen>
306
307 <para>Create a symlink to work around missing xsltproc:</para>
308
309<screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
310
311 <para>Fix an issue on x32:</para>
312
313<screen><userinput remap="pre">sed '/log_debug/s@PRI_TIMEX@PRIi64@' -i src/timesync/timesyncd-manager.c
314sed '/long drift_freq;/s@long @int64_t @' -i src/timesync/timesyncd-manager.h</userinput></screen>
315
316 <para>Prepare systemd for compilation:</para>
317
318<screen><userinput remap="configure">PKG_CONFIG_PATH="/usr/libx32/pkgconfig" \
319CC="gcc -mx32" \
320CXX="g++ -mx32" \
321CFLAGS+="-Wno-error=shift-overflow" \
322CXXFLAGS+="-Wno-error=shift-overflow" \
323LANG=en_US.UTF-8 \
324meson --prefix=/usr \
325 --sysconfdir=/etc \
326 --localstatedir=/var \
327 -Dblkid=true \
328 -Dbuildtype=release \
329 -Ddefault-dnssec=no \
330 -Dfirstboot=false \
331 -Dinstall-tests=false \
332 -Dkill-path=/bin/kill \
333 -Dkmod-path=/bin/kmod \
334 -Dldconfig=false \
335 -Dmount-path=/bin/mount \
336 -Drootprefix= \
337 -Drootlibdir=/usr/libx32 \
338 -Dsplit-usr=true \
339 -Dsulogin-path=/sbin/sulogin \
340 -Dsysusers=false \
341 -Dumount-path=/bin/umount \
342 -Db_lto=false \
343 ..</userinput></screen>
344
345 <para>Compile the package:</para>
346
347<screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
348
349 <para>Install the package:</para>
350
351<screen><userinput remap="install">LANG=en_US.UTF-8 DESTDIR=$PWD/DESTDIR ninja install
352cp -Rv DESTDIR/usr/lib32/* /usr/lib32
353rm -rf DESTDIR
354rm -f /usr/bin/xsltproc</userinput></screen>
355
356 </sect2><!-- mx32 -->
357
358 <sect2 id="contents-systemd" role="content">
359 <title>Contents of systemd</title>
360
361 <segmentedlist>
362 <segtitle>Installed programs</segtitle>
363 <segtitle>Installed libraries</segtitle>
364 <segtitle>Installed directories</segtitle>
365
366 <seglistitem>
367 <seg>bootctl, busctl, coredumpctl, halt (symlink to systemctl),
368 hostnamectl, init, journalctl, kernel-install, localectl, loginctl,
369 machinectl, networkctl, oomctl, portablectl, poweroff (symlink to
370 systemctl), reboot (symlink to systemctl), resolvconf (symlink to
371 resolvectl), resolvectl, runlevel (symlink to systemctl), shutdown
372 (symlink to systemctl), systemctl, systemd-analyze,
373 systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop,
374 systemd-cryptenroll, systemd-delta, systemd-detect-virt,
375 systemd-dissect, systemd-escape, systemd-hwdb, systemd-id128,
376 systemd-inhibit, systemd-machine-id-setup,
377 systemd-mount, systemd-notify, systemd-nspawn, systemd-path,
378 systemd-repart, systemd-resolve (symlink to resolvectl), systemd-run,
379 systemd-socket-activate, systemd-stdio-bridge, systemd-sysext,
380 systemd-tmpfiles, systemd-tty-ask-password-agent,
381 systemd-umount (symlink to systemd-mount),
382 telinit (symlink to systemctl), timedatectl, and udevadm</seg>
383 <seg>libnss_myhostname.so.2, libnss_mymachines.so.2,
384 libnss_resolve.so.2, libnss_systemd.so.2,
385 libsystemd.so, libsystemd-shared-&systemd-version;.so (in /usr/lib/systemd),
386 and libudev.so</seg>
387 <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,
388 /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
389 /etc/xdg/systemd, /usr/lib/systemd, /usr/lib/udev, /usr/include/systemd,
390 /usr/lib/binfmt.d, /usr/lib/environment.d, /usr/lib/kernel,
391 /usr/lib/modules-load.d, /usr/lib/sysctl.d, /usr/lib/systemd,
392 /usr/lib/tmpfiles.d,
393 /usr/share/doc/systemd-&systemd-version;, /usr/share/factory,
394 /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg>
395 </seglistitem>
396 </segmentedlist>
397
398 <variablelist>
399 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
400 <?dbfo list-presentation="list"?>
401 <?dbhtml list-presentation="table"?>
402
403 <varlistentry id="bootctl">
404 <term><command>bootctl</command></term>
405 <listitem>
406 <para>Is used to query the firmware and boot manager settings</para>
407 <indexterm zone="ch-system-systemd bootctl">
408 <primary sortas="b-bootctl">bootctl</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 <varlistentry id="busctl">
414 <term><command>busctl</command></term>
415 <listitem>
416 <para>Is used to introspect and monitor the D-Bus bus</para>
417 <indexterm zone="ch-system-systemd busctl">
418 <primary sortas="b-busctl">busctl</primary>
419 </indexterm>
420 </listitem>
421 </varlistentry>
422
423 <varlistentry id="coredumpctl">
424 <term><command>coredumpctl</command></term>
425 <listitem>
426 <para>Is used to retrieve coredumps from the systemd journal</para>
427 <indexterm zone="ch-system-systemd coredumpctl">
428 <primary sortas="b-coredumpctl">coredumpctl</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="halt">
434 <term><command>halt</command></term>
435 <listitem>
436 <para>Normally invokes <command>shutdown</command> with the
437 <parameter>-h</parameter> option, except when already in run-level 0,
438 then it tells the kernel to halt the system; it notes in the
439 file <filename>/var/log/wtmp</filename> that the system is being
440 brought down</para>
441 <indexterm zone="ch-system-systemd halt">
442 <primary sortas="b-halt">halt</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="hostnamectl">
448 <term><command>hostnamectl</command></term>
449 <listitem>
450 <para>Is used to query and change the system hostname and related
451 settings</para>
452 <indexterm zone="ch-system-systemd hostnamectl">
453 <primary sortas="b-hostnamectl">hostnamectl</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 <varlistentry id="init">
459 <term><command>init</command></term>
460 <listitem>
461 <para>Is the first process to be started when the kernel has initialized
462 the hardware which takes over the boot process and starts all
463 processes according to its configuration files. In this case, it starts
464 systemd</para>
465 <indexterm zone="ch-system-systemd init">
466 <primary sortas="b-init">init</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="journalctl">
472 <term><command>journalctl</command></term>
473 <listitem>
474 <para>Is used to query the contents of the systemd journal</para>
475 <indexterm zone="ch-system-systemd journalctl">
476 <primary sortas="b-journalctl">journalctl</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="kernel-install">
482 <term><command>kernel-install</command></term>
483 <listitem>
484 <para>Is used to add and remove kernel and initramfs images to and
485 from /boot. In LFS, this is done manually</para>
486 <indexterm zone="ch-system-systemd kernel-install">
487 <primary sortas="b-kernel-install">kernel-install</primary>
488 </indexterm>
489 </listitem>
490 </varlistentry>
491
492 <varlistentry id="localectl">
493 <term><command>localectl</command></term>
494 <listitem>
495 <para>Is used to query and change the system locale and keyboard layout
496 settings</para>
497 <indexterm zone="ch-system-systemd localectl">
498 <primary sortas="b-localectl">localectl</primary>
499 </indexterm>
500 </listitem>
501 </varlistentry>
502
503 <varlistentry id="loginctl">
504 <term><command>loginctl</command></term>
505 <listitem>
506 <para>Is used to introspect and control the state of the systemd Login
507 Manager</para>
508 <indexterm zone="ch-system-systemd loginctl">
509 <primary sortas="b-loginctl">loginctl</primary>
510 </indexterm>
511 </listitem>
512 </varlistentry>
513
514 <varlistentry id="machinectl">
515 <term><command>machinectl</command></term>
516 <listitem>
517 <para>Is used to introspect and control the state of the systemd Virtual
518 Machine and Container Registration Manager</para>
519 <indexterm zone="ch-system-systemd machinectl">
520 <primary sortas="b-machinectl">machinectl</primary>
521 </indexterm>
522 </listitem>
523 </varlistentry>
524
525 <varlistentry id="networkctl">
526 <term><command>networkctl</command></term>
527 <listitem>
528 <para>Is used to introspect and configure the state of the network
529 links configured by systemd-networkd</para>
530 <indexterm zone="ch-system-systemd networkctl">
531 <primary sortas="b-networkctl">networkctl</primary>
532 </indexterm>
533 </listitem>
534 </varlistentry>
535
536 <varlistentry id="oomctl">
537 <term><command>oomctl</command></term>
538 <listitem>
539 <para>Controls the systemd Out Of Memory daemon</para>
540 <indexterm zone="ch-system-systemd oomctl">
541 <primary sortas="b-oomctl">oomctl</primary>
542 </indexterm>
543 </listitem>
544 </varlistentry>
545
546 <varlistentry id="portablectl">
547 <term><command>portablectl</command></term>
548 <listitem>
549 <para>Is used to attach or detach portable services from the local
550 system</para>
551 <indexterm zone="ch-system-systemd portablectl">
552 <primary sortas="b-portablectl">portablectl</primary>
553 </indexterm>
554 </listitem>
555 </varlistentry>
556
557 <varlistentry id="poweroff">
558 <term><command>poweroff</command></term>
559 <listitem>
560 <para>Instructs the kernel to halt the system and switch off the computer
561 (see <command>halt</command>)</para>
562 <indexterm zone="ch-system-systemd poweroff">
563 <primary sortas="b-poweroff">poweroff</primary>
564 </indexterm>
565 </listitem>
566 </varlistentry>
567
568 <varlistentry id="reboot">
569 <term><command>reboot</command></term>
570 <listitem>
571 <para>Instructs the kernel to reboot the system (see
572 <command>halt</command>)</para>
573 <indexterm zone="ch-system-systemd reboot">
574 <primary sortas="b-reboot">reboot</primary>
575 </indexterm>
576 </listitem>
577 </varlistentry>
578
579 <varlistentry id="resolvconf">
580 <term><command>resolvconf</command></term>
581 <listitem>
582 <para>Registers DNS server and domain configuration with
583 <command>systemd-resolved</command></para>
584 <indexterm zone="ch-system-systemd resolvconf">
585 <primary sortas="b-resolvconf">resolvconf</primary>
586 </indexterm>
587 </listitem>
588 </varlistentry>
589
590 <varlistentry id="resolvectl">
591 <term><command>resolvectl</command></term>
592 <listitem>
593 <para>Sends control commands to the network name resolution
594 manager, or resolves domain names, IPv4 and IPv6 addresses,
595 DNS records, and services</para>
596 <indexterm zone="ch-system-systemd resolvectl">
597 <primary sortas="b-resolvectl">resolvectl</primary>
598 </indexterm>
599 </listitem>
600 </varlistentry>
601
602 <varlistentry id="runlevel">
603 <term><command>runlevel</command></term>
604 <listitem>
605 <para>Outputs the previous and the current run-level, as noted in the
606 last run-level record in <filename>/run/utmp</filename></para>
607 <indexterm zone="ch-system-systemd runlevel">
608 <primary sortas="b-runlevel">runlevel</primary>
609 </indexterm>
610 </listitem>
611 </varlistentry>
612
613 <varlistentry id="shutdown">
614 <term><command>shutdown</command></term>
615 <listitem>
616 <para>Brings the system down in a safe and secure manner, signaling
617 all processes and notifying all logged-in users</para>
618 <indexterm zone="ch-system-systemd shutdown">
619 <primary sortas="b-shutdown">shutdown</primary>
620 </indexterm>
621 </listitem>
622 </varlistentry>
623
624 <varlistentry id="systemctl">
625 <term><command>systemctl</command></term>
626 <listitem>
627 <para>Is used to introspect and control the state of the systemd system
628 and service manager</para>
629 <indexterm zone="ch-system-systemd systemctl">
630 <primary sortas="b-systemctl">systemctl</primary>
631 </indexterm>
632 </listitem>
633 </varlistentry>
634
635 <varlistentry id="systemd-analyze">
636 <term><command>systemd-analyze</command></term>
637 <listitem>
638 <para>Is used to determine system startup performance of the current
639 boot, as well as identify troublesome systemd units</para>
640 <indexterm zone="ch-system-systemd systemd-analyze">
641 <primary sortas="b-systemd-analyze">systemd-analyze</primary>
642 </indexterm>
643 </listitem>
644 </varlistentry>
645
646 <varlistentry id="systemd-ask-password">
647 <term><command>systemd-ask-password</command></term>
648 <listitem>
649 <para>Is used to query a system password or passphrase from the user,
650 using a question message specified on the command line</para>
651 <indexterm zone="ch-system-systemd systemd-ask-password">
652 <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
653 </indexterm>
654 </listitem>
655 </varlistentry>
656
657 <varlistentry id="systemd-cat">
658 <term><command>systemd-cat</command></term>
659 <listitem>
660 <para>Is used to connect the STDOUT and STDERR outputs of a process
661 with the systemd journal
662 </para>
663 <indexterm zone="ch-system-systemd systemd-cat">
664 <primary sortas="b-systemd-cat">systemd-cat</primary>
665 </indexterm>
666 </listitem>
667 </varlistentry>
668
669 <varlistentry id="systemd-cgls">
670 <term><command>systemd-cgls</command></term>
671 <listitem>
672 <para>Recursively shows the contents of the selected Linux control
673 group hierarchy in a tree</para>
674 <indexterm zone="ch-system-systemd systemd-cgls">
675 <primary sortas="b-systemd-cgls">systemd-cgls</primary>
676 </indexterm>
677 </listitem>
678 </varlistentry>
679
680 <varlistentry id="systemd-cgtop">
681 <term><command>systemd-cgtop</command></term>
682 <listitem>
683 <para>Shows the top control groups of the local Linux control group
684 hierarchy, ordered by their CPU, memory and disk I/O load</para>
685 <indexterm zone="ch-system-systemd systemd-cgtop">
686 <primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
687 </indexterm>
688 </listitem>
689 </varlistentry>
690
691 <varlistentry id="systemd-cryptenroll">
692 <term><command>systemd-cryptenroll</command></term>
693 <listitem>
694 <para>Is used to enroll or remove a system from full disk encryption,
695 as well as set and query private keys and recovery keys</para>
696 <indexterm zone="ch-system-systemd systemd-cryptenroll">
697 <primary sortas="b-systemd-cryptenroll">systemd-cryptenroll</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
702 <varlistentry id="systemd-delta">
703 <term><command>systemd-delta</command></term>
704 <listitem>
705 <para>Is used to identify and compare configuration files in
706 <filename class="directory">/etc</filename> that override default
707 counterparts in <filename class="directory">/usr</filename></para>
708 <indexterm zone="ch-system-systemd systemd-delta">
709 <primary sortas="b-systemd-delta">systemd-delta</primary>
710 </indexterm>
711 </listitem>
712 </varlistentry>
713
714 <varlistentry id="systemd-detect-virt">
715 <term><command>systemd-detect-virt</command></term>
716 <listitem>
717 <para>Detects whether the system is being run in a virtual
718 environment, and adjusts udev accordingly</para>
719 <indexterm zone="ch-system-systemd systemd-detect-virt">
720 <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
721 </indexterm>
722 </listitem>
723 </varlistentry>
724
725 <varlistentry id="systemd-dissect">
726 <term><command>systemd-dissect</command></term>
727 <listitem>
728 <para>Is used to inspect OS disk images</para>
729 <indexterm zone="ch-system-systemd systemd-dissect">
730 <primary sortas="b-systemd-dissect">systemd-dissect</primary>
731 </indexterm>
732 </listitem>
733 </varlistentry>
734
735 <varlistentry id="systemd-escape">
736 <term><command>systemd-escape</command></term>
737 <listitem>
738 <para>Is used to escape strings for inclusion in systemd unit
739 names</para>
740 <indexterm zone="ch-system-systemd systemd-escape">
741 <primary sortas="b-systemd-escape">systemd-escape</primary>
742 </indexterm>
743 </listitem>
744 </varlistentry>
745
746 <varlistentry id="systemd-hwdb">
747 <term><command>systemd-hwdb</command></term>
748 <listitem>
749 <para>Is used to manage the hardware database (hwdb)</para>
750 <indexterm zone="ch-system-systemd systemd-hwdb">
751 <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
752 </indexterm>
753 </listitem>
754 </varlistentry>
755
756 <varlistentry id="systemd-id128">
757 <term><command>systemd-id128</command></term>
758 <listitem>
759 <para>Generates and prints id128 strings</para>
760 <indexterm zone="ch-system-systemd systemd-id128">
761 <primary sortas="b-systemd-id128">systemd-id128</primary>
762 </indexterm>
763 </listitem>
764 </varlistentry>
765
766 <varlistentry id="systemd-inhibit">
767 <term><command>systemd-inhibit</command></term>
768 <listitem>
769 <para>Is used to execute a program with a shutdown, sleep or idle
770 inhibitor lock taken, preventing an action such as a system shutdown
771 until the process is completed</para>
772 <indexterm zone="ch-system-systemd systemd-inhibit">
773 <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
774 </indexterm>
775 </listitem>
776 </varlistentry>
777
778 <varlistentry id="systemd-machine-id-setup">
779 <term><command>systemd-machine-id-setup</command></term>
780 <listitem>
781 <para>Is used by system installer tools to initialize the machine ID
782 stored in <filename>/etc/machine-id</filename> at install time with a
783 randomly generated ID</para>
784 <indexterm zone="ch-system-systemd systemd-machine-id-setup">
785 <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary>
786 </indexterm>
787 </listitem>
788 </varlistentry>
789
790 <varlistentry id="systemd-mount">
791 <term><command>systemd-mount</command></term>
792 <listitem>
793 <para>Is used to temporarily mount or automount disks</para>
794 <indexterm zone="ch-system-systemd systemd-mount">
795 <primary sortas="b-systemd-mount">systemd-mount</primary>
796 </indexterm>
797 </listitem>
798 </varlistentry>
799
800 <varlistentry id="systemd-notify">
801 <term><command>systemd-notify</command></term>
802 <listitem>
803 <para>Is used by daemon scripts to notify the init system about status
804 changes</para>
805 <indexterm zone="ch-system-systemd systemd-notify">
806 <primary sortas="b-systemd-notify">systemd-notify</primary>
807 </indexterm>
808 </listitem>
809 </varlistentry>
810
811 <varlistentry id="systemd-nspawn">
812 <term><command>systemd-nspawn</command></term>
813 <listitem>
814 <para>Is used to run a command or OS in a light-weight namespace
815 container</para>
816 <indexterm zone="ch-system-systemd systemd-nspawn">
817 <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
818 </indexterm>
819 </listitem>
820 </varlistentry>
821
822 <varlistentry id="systemd-path">
823 <term><command>systemd-path</command></term>
824 <listitem>
825 <para>Is used to query system and user paths</para>
826 <indexterm zone="ch-system-systemd systemd-path">
827 <primary sortas="b-systemd-path">systemd-path</primary>
828 </indexterm>
829 </listitem>
830 </varlistentry>
831
832 <varlistentry id="systemd-repart">
833 <term><command>systemd-repart</command></term>
834 <listitem>
835 <para>Is used to grow and add partitions to a partition table when
836 systemd is used in an OS image (e.g. a container)</para>
837 <indexterm zone="ch-system-systemd systemd-repart">
838 <primary sortas="b-systemd-repart">systemd-repart</primary>
839 </indexterm>
840 </listitem>
841 </varlistentry>
842
843 <varlistentry id="systemd-resolve">
844 <term><command>systemd-resolve</command></term>
845 <listitem>
846 <para>Is used to resolve domain names, IPV4 and IPv6 addresses, DNS
847 resource records, and services</para>
848 <indexterm zone="ch-system-systemd systemd-resolve">
849 <primary sortas="b-systemd-resolve">systemd-resolve</primary>
850 </indexterm>
851 </listitem>
852 </varlistentry>
853
854 <varlistentry id="systemd-run">
855 <term><command>systemd-run</command></term>
856 <listitem>
857 <para>Is used to create and start a transient .service or a .scope
858 unit and run the specified command in it. This is useful for
859 validating systemd units</para>
860 <indexterm zone="ch-system-systemd systemd-run">
861 <primary sortas="b-systemd-run">systemd-run</primary>
862 </indexterm>
863 </listitem>
864 </varlistentry>
865
866 <varlistentry id="systemd-socket-activate">
867 <term><command>systemd-socket-activate</command></term>
868 <listitem>
869 <para>Is used to listen on socket devices and launch a process upon
870 a successful connection to the socket</para>
871 <indexterm zone="ch-system-systemd systemd-socket-activate">
872 <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
873 </indexterm>
874 </listitem>
875 </varlistentry>
876
877 <varlistentry id="systemd-sysext">
878 <term><command>systemd-sysext</command></term>
879 <listitem>
880 <para>Activates system extension images</para>
881 <indexterm zone="ch-system-systemd systemd-sysext">
882 <primary sortas="b-systemd-sysext">systemd-sysext</primary>
883 </indexterm>
884 </listitem>
885 </varlistentry>
886
887 <varlistentry id="systemd-tmpfiles">
888 <term><command>systemd-tmpfiles</command></term>
889 <listitem>
890 <para>Creates, deletes and cleans up volatile and temporary files and
891 directories, based on the configuration file format and location
892 specified in
893 <filename class="directory">tmpfiles.d</filename> directories</para>
894 <indexterm zone="ch-system-systemd systemd-tmpfiles">
895 <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary>
896 </indexterm>
897 </listitem>
898 </varlistentry>
899
900 <varlistentry id="systemd-umount">
901 <term><command>systemd-umount</command></term>
902 <listitem>
903 <para>Unmounts mount points</para>
904 <indexterm zone="ch-system-systemd systemd-umount">
905 <primary sortas="b-systemd-umount">systemd-umount</primary>
906 </indexterm>
907 </listitem>
908 </varlistentry>
909
910 <varlistentry id="systemd-tty-ask-password-agent">
911 <term><command>systemd-tty-ask-password-agent</command></term>
912 <listitem>
913 <para>Is used to list and/or process pending systemd password
914 requests</para>
915 <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
916 <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
917 </indexterm>
918 </listitem>
919 </varlistentry>
920
921 <varlistentry id="telinit">
922 <term><command>telinit</command></term>
923 <listitem>
924 <para>Tells <command>init</command> which run-level to change
925 to</para>
926 <indexterm zone="ch-system-systemd telinit">
927 <primary sortas="b-telinit">telinit</primary>
928 </indexterm>
929 </listitem>
930 </varlistentry>
931
932 <varlistentry id="timedatectl">
933 <term><command>timedatectl</command></term>
934 <listitem>
935 <para>Is used to query and change the system clock and its settings
936 </para>
937 <indexterm zone="ch-system-systemd timedatectl">
938 <primary sortas="b-timedatectl">timedatectl</primary>
939 </indexterm>
940 </listitem>
941 </varlistentry>
942
943 <varlistentry id="udevadm">
944 <term><command>udevadm</command></term>
945 <listitem>
946 <para>Is a generic udev administration tool which controls the udevd
947 daemon, provides info from the Udev hardware database, monitors
948 uevents, waits for uevents to finish, tests udev configuration, and
949 triggers uevents for a given device</para>
950 <indexterm zone="ch-system-systemd udevadm">
951 <primary sortas="b-udevadm">udevadm</primary>
952 </indexterm>
953 </listitem>
954 </varlistentry>
955
956 <varlistentry id="libsystemd">
957 <term><filename class="libraryfile">libsystemd</filename></term>
958 <listitem>
959 <para>Is the main systemd utility library</para>
960 <indexterm zone="ch-system-systemd libsystemd">
961 <primary sortas="c-libsystemd">libsystemd</primary>
962 </indexterm>
963 </listitem>
964 </varlistentry>
965
966 <varlistentry id="libudev">
967 <term><filename class="libraryfile">libudev</filename></term>
968 <listitem>
969 <para>Is a library to access Udev device information</para>
970 <indexterm zone="ch-system-systemd libudev">
971 <primary sortas="c-libudev">libudev</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
976 </variablelist>
977
978 </sect2>
979
980</sect1>
Note: See TracBrowser for help on using the repository browser.