source: chapter08/systemd.xml@ dfde664

12.0 12.0-rc1 12.1 12.1-rc1 bdubbs/gcc13 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 dfde664 was dfde664, checked in by Xi Ruoyao <xry111@…>, 14 months ago

systemd: Set /dev/kvm mode to 0660

The default /dev/kvm mode is 0666 and we consider it "not so safe".
Like Tim said: "I'm also authenticating to my system all the time and
don't do a chmod -R 777 / after every boot."

With this option, the /dev/kvm mode is set to 0660 and it's tagged
"uaccess" so systemd-logind will add an ACL entry for users logged-in
locally.

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