source: chapter08/systemd.xml@ efa633e

multilib-10.1
Last change on this file since efa633e was efa633e, checked in by Thomas Trepl <thomas@…>, 3 years ago

Merge changes from trunk to multilib

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@12142 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

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