source: chapter08/systemd.xml@ e8179f4

xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/loongarch-12.2
Last change on this file since e8179f4 was 76ef88ee, checked in by Xi Ruoyao <xry111@…>, 15 months ago

loongarch: systemd: Add -Wno-format-overflow workaround

Without this, the package FTBFS. It wasn't detected in my manual build
because of my custom CFLAGS.

Need to investigate it later: it may be a systemd bug or GCC bug on
LoongArch.

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