source: chapter06/systemd.xml@ 7354a12

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

MultiLib: Merge changes from trunk

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