source: chapter08/systemd.xml@ 1053282

12.0 12.0-rc1 12.1 12.1-rc1 multilib renodr/libudev-from-systemd trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/update-glibc
Last change on this file since 1053282 was cd8339a, checked in by Bruce Dubbs <bdubbs@…>, 14 months ago

Minor grammar fix

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