source: chapter08/systemd.xml@ e4b4c5a0

xry111/clfs-ng
Last change on this file since e4b4c5a0 was c04d98d, checked in by Xi Ruoyao <xry111@…>, 3 months ago

systemd: Reword test failure notice

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