source: chapter08/systemd.xml@ c413fb5

multilib xry111/multilib
Last change on this file since c413fb5 was d394d13e, checked in by Thomas Trepl <thomas@…>, 7 months ago

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