source: chapter06/systemd.xml@ ede49cd

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

MultiLib: Merge changes from trunk

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@11747 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

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