systemd.xml 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756
  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. <sect1 id="ch-system-systemd" role="wrap" revision="systemd">
  8. <?dbhtml filename="systemd.html"?>
  9. <sect1info condition="script">
  10. <productname>systemd</productname>
  11. <productnumber>&systemd-version;</productnumber>
  12. <address>&systemd-url;</address>
  13. </sect1info>
  14. <title>Systemd-&systemd-version;</title>
  15. <indexterm zone="ch-system-systemd">
  16. <primary sortas="a-systemd">systemd</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The systemd package contains programs for controlling the startup,
  21. running, and shutdown of the system.</para>
  22. <segmentedlist>
  23. <segtitle>&buildtime;</segtitle>
  24. <segtitle>&diskspace;</segtitle>
  25. <seglistitem>
  26. <seg>&systemd-ch6-sbu;</seg>
  27. <seg>&systemd-ch6-du;</seg>
  28. </seglistitem>
  29. </segmentedlist>
  30. </sect2>
  31. <sect2 role="installation">
  32. <title>Installation of systemd</title>
  33. <para>First, fix a build error when using Util-Linux built in
  34. Chapter 5:</para>
  35. <screen><userinput remap="pre">sed -i "s:blkid/::" $(grep -rl "blkid/blkid.h")</userinput></screen>
  36. <!-- Not needed as of 231. -renodr
  37. <para>Fix a potential security issue with framebuffer devices:</para>
  38. <screen><userinput remap="pre">sed -e 's@DRI and frame buffer@DRI@' \
  39. -e '/SUBSYSTEM==\"graphics\", KERNEL==\"fb\*\"/d' \
  40. -i src/login/70-uaccess.rules</userinput></screen>
  41. -->
  42. <para>Disable two tests that always fail:</para>
  43. <screen><userinput remap="pre">sed -e 's@test/udev-test.pl @@' \
  44. -e 's@test-copy$(EXEEXT) @@' \
  45. -i Makefile.in</userinput></screen>
  46. <!-- Not needed as of 232... anyone notice a pattern here? -renodr
  47. <para>Apply a patch to fix a security issue:</para>
  48. <screen><userinput remap="pre">patch -Np1 -i ../systemd-231-security_fix-1.patch</userinput></screen>
  49. -->
  50. <para>Create a file to allow systemd to build when using Util-Linux
  51. built in Chapter 5, to disable LTO by default, and to build without
  52. xlstproc:</para>
  53. <screen><userinput remap="pre">cat &gt; config.cache &lt;&lt; "EOF"
  54. <literal>KILL=/bin/kill
  55. MOUNT_PATH=/bin/mount
  56. UMOUNT_PATH=/bin/umount
  57. HAVE_BLKID=1
  58. BLKID_LIBS="-lblkid"
  59. BLKID_CFLAGS="-I/tools/include/blkid"
  60. HAVE_LIBMOUNT=1
  61. MOUNT_LIBS="-lmount"
  62. MOUNT_CFLAGS="-I/tools/include/libmount"
  63. cc_cv_CFLAGS__flto=no
  64. SULOGIN="/sbin/sulogin"
  65. GPERF_LEN_TYPE=size_t
  66. XSLTPROC="/usr/bin/xsltproc"</literal>
  67. EOF</userinput></screen>
  68. <para>LTO is disabled by default because it causes
  69. <command>systemd</command> and other auxiliary programs to link to
  70. <filename class="libraryfile">libgcc_s.so</filename>, slows the build down
  71. and makes the compiled code larger.</para>
  72. <para>Prepare systemd for compilation:</para>
  73. <screen><userinput remap="configure">./configure --prefix=/usr \
  74. --sysconfdir=/etc \
  75. --localstatedir=/var \
  76. --config-cache \
  77. --with-rootprefix= \
  78. --with-rootlibdir=/lib \
  79. --enable-split-usr \
  80. --disable-firstboot \
  81. --disable-ldconfig \
  82. --disable-sysusers \
  83. --without-python \
  84. --with-default-dnssec=no \
  85. --docdir=/usr/share/doc/systemd-&systemd-version;</userinput></screen>
  86. <variablelist>
  87. <title>The meaning of the configure options:</title>
  88. <varlistentry>
  89. <term><parameter>--config-cache</parameter></term>
  90. <listitem>
  91. <para>This switch tells the build system to use
  92. the <filename>config.cache</filename> file which
  93. was created earlier.</para>
  94. </listitem>
  95. </varlistentry>
  96. <varlistentry>
  97. <term><parameter>--with-root*</parameter></term>
  98. <listitem>
  99. <para>These switches ensure that core programs and
  100. shared libraries are installed in the subdirectories
  101. of the root partition.</para>
  102. </listitem>
  103. </varlistentry>
  104. <varlistentry>
  105. <term><parameter>--enable-split-usr</parameter></term>
  106. <listitem>
  107. <para>This switch ensures that systemd will work on
  108. systems where /bin, /lib and /sbin directories are not
  109. symlinks to their /usr counterparts.</para>
  110. </listitem>
  111. </varlistentry>
  112. <varlistentry>
  113. <term><parameter>--without-python</parameter></term>
  114. <listitem>
  115. <para>This switch prevents <command>configure</command>
  116. from trying to use Python which isn't built
  117. in LFS.</para>
  118. </listitem>
  119. </varlistentry>
  120. <varlistentry>
  121. <term><parameter>--disable-firstboot</parameter></term>
  122. <listitem>
  123. <para>This switch prevents installation of systemd
  124. services responsible for setting up the system for
  125. the first time. They are not useful for LFS because
  126. everything is done manually.</para>
  127. </listitem>
  128. </varlistentry>
  129. <varlistentry>
  130. <term><parameter>--disable-ldconfig</parameter></term>
  131. <listitem>
  132. <para>This switch prevents installation of a systemd
  133. unit that runs <command>ldconfig</command> at
  134. boot, making the boot time longer. Remove it if the
  135. described feature is desired, even though it's not
  136. useful for source distributions such as LFS.</para>
  137. </listitem>
  138. </varlistentry>
  139. <varlistentry>
  140. <term><parameter>--disable-sysusers</parameter></term>
  141. <listitem>
  142. <para>This switch prevents installation of systemd
  143. services responsible for setting up the
  144. <filename>/etc/group</filename> and
  145. <filename>/etc/passwd</filename> files. Both files
  146. were created early in this chapter.</para>
  147. </listitem>
  148. </varlistentry>
  149. <varlistentry>
  150. <term><parameter>--with-default-dnssec=no</parameter></term>
  151. <listitem>
  152. <para>This switch turns off the experimental DNSSEC suport.</para>
  153. </listitem>
  154. </varlistentry>
  155. </variablelist>
  156. <para>Fix a generated file:</para>
  157. <screen><userinput remap="pre">sed -i s/size_t/GPERF_LEN_TYPE/ src/resolve/dns_type-from-name.h</userinput></screen>
  158. <para>Compile the package:</para>
  159. <screen><userinput remap="make">make LD_LIBRARY_PATH=/tools/lib</userinput></screen>
  160. <para>This package has a test suite, but it can only be run after the
  161. package has been installed.</para>
  162. <para>Install the package:</para>
  163. <screen><userinput remap="install">make LD_LIBRARY_PATH=/tools/lib install</userinput></screen>
  164. <!-- These get installed into /lib now by default.
  165. <para>Move the NSS libraries to <filename class="directory">/lib</filename>:</para>
  166. <screen><userinput remap="install">mv -v /usr/lib/libnss_{myhostname,mymachines,resolve}.so.2 /lib</userinput></screen>
  167. -->
  168. <para>Remove an unnecessary directory:</para>
  169. <screen><userinput remap="install">rm -rfv /usr/lib/rpm</userinput></screen>
  170. <para>Create the Sysvinit compatibility symlinks, so systemd is used
  171. as the default init system:</para>
  172. <screen><userinput remap="install">for tool in runlevel reboot shutdown poweroff halt telinit; do
  173. ln -sfv ../bin/systemctl /sbin/${tool}
  174. done
  175. ln -sfv ../lib/systemd/systemd /sbin/init</userinput></screen>
  176. <!--
  177. <para>Remove a reference to a non-existent group:</para>
  178. <screen><userinput remap="install">sed -i "s:0775 root lock:0755 root root:g" /usr/lib/tmpfiles.d/legacy.conf</userinput></screen>
  179. -->
  180. <para>Create the <filename>/etc/machine-id</filename> file needed by
  181. <command>systemd-journald</command>:</para>
  182. <screen><userinput remap="install">systemd-machine-id-setup</userinput></screen>
  183. <para>Since the testsuite largely depends on the host system kernel
  184. configuration, some tests may fail. It also needs a modification in
  185. order not to look for a program that will be installed by Util-Linux
  186. package later in this chapter. To test the results, issue:</para>
  187. <screen><userinput remap="test">sed -i "s:minix:ext4:g" src/test/test-path-util.c
  188. make LD_LIBRARY_PATH=/tools/lib -k check</userinput></screen>
  189. </sect2>
  190. <sect2 id="contents-systemd" role="content">
  191. <title>Contents of systemd</title>
  192. <segmentedlist>
  193. <segtitle>Installed programs</segtitle>
  194. <segtitle>Installed libraries</segtitle>
  195. <segtitle>Installed directories</segtitle>
  196. <seglistitem>
  197. <seg>bootctl, busctl, coredumpctl, halt, hostnamectl, init, journalctl,
  198. kernel-install, localectl, loginctl, machinectl, networkctl, poweroff,
  199. reboot, runlevel, shutdown, systemctl, systemd-analyze,
  200. systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop,
  201. systemd-delta, systemd-detect-virt, systemd-escape, systemd-hwdb,
  202. systemd-inhibit, systemd-machine-id-setup, systemd-mount,
  203. systemd-notify, systemd-nspawn, systemd-path, systemd-resolve,
  204. systemd-run, systemd-socket-activate,
  205. systemd-stdio-bridge, systemd-tmpfiles, systemd-tty-ask-password-agent,
  206. telinit, timedatectl, and udevadm</seg>
  207. <seg>libnss_myhostname.so.2, libnss_mymachines.so.2,
  208. libnss_resolve.so.2, libnss_systemd.so.2,
  209. libsystemd.so, libsystemd-shared-231.so,
  210. and libudev.so</seg>
  211. <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,
  212. /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
  213. /etc/xdg/systemd, /lib/systemd, /lib/udev, /usr/include/systemd,
  214. /usr/lib/binfmt.d, /usr/lib/kernel, /usr/lib/modules-load.d,
  215. /usr/lib/sysctl.d, /usr/lib/systemd, /usr/lib/tmpfiles.d,
  216. /usr/share/doc/systemd-&systemd-version;, /usr/share/factory,
  217. /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg>
  218. </seglistitem>
  219. </segmentedlist>
  220. <variablelist>
  221. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  222. <?dbfo list-presentation="list"?>
  223. <?dbhtml list-presentation="table"?>
  224. <varlistentry id="bootctl">
  225. <term><command>bootctl</command></term>
  226. <listitem>
  227. <para>used to query the firmware and boot manager settings</para>
  228. <indexterm zone="ch-system-systemd bootctl">
  229. <primary sortas="b-bootctl">bootctl</primary>
  230. </indexterm>
  231. </listitem>
  232. </varlistentry>
  233. <varlistentry id="busctl">
  234. <term><command>busctl</command></term>
  235. <listitem>
  236. <para>Used to introspect and monitor the D-Bus bus</para>
  237. <indexterm zone="ch-system-systemd busctl">
  238. <primary sortas="b-busctl">busctl</primary>
  239. </indexterm>
  240. </listitem>
  241. </varlistentry>
  242. <varlistentry id="coredumpctl">
  243. <term><command>coredumpctl</command></term>
  244. <listitem>
  245. <para>Used to retrieve coredumps from the systemd Journal</para>
  246. <indexterm zone="ch-system-systemd coredumpctl">
  247. <primary sortas="b-coredumpctl">coredumpctl</primary>
  248. </indexterm>
  249. </listitem>
  250. </varlistentry>
  251. <varlistentry id="halt">
  252. <term><command>halt</command></term>
  253. <listitem>
  254. <para>Normally invokes <command>shutdown</command> with the
  255. <parameter>-h</parameter> option, except when already in run-level 0,
  256. then it tells the kernel to halt the system; it notes in the
  257. file <filename>/var/log/wtmp</filename> that the system is being
  258. brought down</para>
  259. <indexterm zone="ch-system-systemd halt">
  260. <primary sortas="b-halt">halt</primary>
  261. </indexterm>
  262. </listitem>
  263. </varlistentry>
  264. <varlistentry id="hostnamectl">
  265. <term><command>hostnamectl</command></term>
  266. <listitem>
  267. <para>Used to query and change the system hostname and related
  268. settings</para>
  269. <indexterm zone="ch-system-systemd hostnamectl">
  270. <primary sortas="b-hostnamectl">hostnamectl</primary>
  271. </indexterm>
  272. </listitem>
  273. </varlistentry>
  274. <varlistentry id="init">
  275. <term><command>init</command></term>
  276. <listitem>
  277. <para>The first process to be started when the kernel has initialized
  278. the hardware which takes over the boot process and starts all the
  279. proceses it is instructed to</para>
  280. <indexterm zone="ch-system-systemd init">
  281. <primary sortas="b-init">init</primary>
  282. </indexterm>
  283. </listitem>
  284. </varlistentry>
  285. <varlistentry id="journalctl">
  286. <term><command>journalctl</command></term>
  287. <listitem>
  288. <para>Used to query the contents of the systemd Journal</para>
  289. <indexterm zone="ch-system-systemd journalctl">
  290. <primary sortas="b-journalctl">journalctl</primary>
  291. </indexterm>
  292. </listitem>
  293. </varlistentry>
  294. <varlistentry id="kernel-install">
  295. <term><command>kernel-install</command></term>
  296. <listitem>
  297. <para>Used to add and remove kernel and initramfs images to and
  298. from /boot</para>
  299. <indexterm zone="ch-system-systemd kernel-install">
  300. <primary sortas="b-kernel-install">kernel-install</primary>
  301. </indexterm>
  302. </listitem>
  303. </varlistentry>
  304. <varlistentry id="localectl">
  305. <term><command>localectl</command></term>
  306. <listitem>
  307. <para>Used to query and change the system locale and keyboard layout
  308. settings</para>
  309. <indexterm zone="ch-system-systemd localectl">
  310. <primary sortas="b-localectl">localectl</primary>
  311. </indexterm>
  312. </listitem>
  313. </varlistentry>
  314. <varlistentry id="loginctl">
  315. <term><command>loginctl</command></term>
  316. <listitem>
  317. <para>Used to introspect and control the state of the systemd Login
  318. Manager</para>
  319. <indexterm zone="ch-system-systemd loginctl">
  320. <primary sortas="b-loginctl">loginctl</primary>
  321. </indexterm>
  322. </listitem>
  323. </varlistentry>
  324. <varlistentry id="machinectl">
  325. <term><command>machinectl</command></term>
  326. <listitem>
  327. <para>Used to introspect and control the state of the systemd Virtual
  328. Machine and Container Registration Manager</para>
  329. <indexterm zone="ch-system-systemd machinectl">
  330. <primary sortas="b-machinectl">machinectl</primary>
  331. </indexterm>
  332. </listitem>
  333. </varlistentry>
  334. <varlistentry id="networkctl">
  335. <term><command>networkctl</command></term>
  336. <listitem>
  337. <para>Used to introspect the state of the network links as seen by
  338. systemd-networkd</para>
  339. <indexterm zone="ch-system-systemd networkctl">
  340. <primary sortas="b-networkctl">networkctl</primary>
  341. </indexterm>
  342. </listitem>
  343. </varlistentry>
  344. <varlistentry id="poweroff">
  345. <term><command>poweroff</command></term>
  346. <listitem>
  347. <para>Tells the kernel to halt the system and switch off the computer
  348. (see <command>halt</command>)</para>
  349. <indexterm zone="ch-system-systemd poweroff">
  350. <primary sortas="b-poweroff">poweroff</primary>
  351. </indexterm>
  352. </listitem>
  353. </varlistentry>
  354. <varlistentry id="reboot">
  355. <term><command>reboot</command></term>
  356. <listitem>
  357. <para>Tells the kernel to reboot the system (see
  358. <command>halt</command>)</para>
  359. <indexterm zone="ch-system-systemd reboot">
  360. <primary sortas="b-reboot">reboot</primary>
  361. </indexterm>
  362. </listitem>
  363. </varlistentry>
  364. <varlistentry id="runlevel">
  365. <term><command>runlevel</command></term>
  366. <listitem>
  367. <para>Reports the previous and the current run-level, as noted in the
  368. last run-level record in <filename>/var/run/utmp</filename></para>
  369. <indexterm zone="ch-system-systemd runlevel">
  370. <primary sortas="b-runlevel">runlevel</primary>
  371. </indexterm>
  372. </listitem>
  373. </varlistentry>
  374. <varlistentry id="shutdown">
  375. <term><command>shutdown</command></term>
  376. <listitem>
  377. <para>Brings the system down in a secure way, signaling all processes
  378. and notifying all logged-in users</para>
  379. <indexterm zone="ch-system-systemd shutdown">
  380. <primary sortas="b-shutdown">shutdown</primary>
  381. </indexterm>
  382. </listitem>
  383. </varlistentry>
  384. <varlistentry id="systemctl">
  385. <term><command>systemctl</command></term>
  386. <listitem>
  387. <para>Used to introspect and control the state of the systemd system
  388. and service manager</para>
  389. <indexterm zone="ch-system-systemd systemctl">
  390. <primary sortas="b-systemctl">systemctl</primary>
  391. </indexterm>
  392. </listitem>
  393. </varlistentry>
  394. <varlistentry id="systemd-analyze">
  395. <term><command>systemd-analyze</command></term>
  396. <listitem>
  397. <para>Used to determine system boot-up performance of the current
  398. boot</para>
  399. <indexterm zone="ch-system-systemd systemd-analyze">
  400. <primary sortas="b-systemd-analyze">systemd-analyze</primary>
  401. </indexterm>
  402. </listitem>
  403. </varlistentry>
  404. <varlistentry id="systemd-ask-password">
  405. <term><command>systemd-ask-password</command></term>
  406. <listitem>
  407. <para>Used to query a system password or passphrase from the user,
  408. using a question message specified on the command line</para>
  409. <indexterm zone="ch-system-systemd systemd-ask-password">
  410. <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
  411. </indexterm>
  412. </listitem>
  413. </varlistentry>
  414. <varlistentry id="systemd-cat">
  415. <term><command>systemd-cat</command></term>
  416. <listitem>
  417. <para>Used to connect STDOUT and STDERR of a process with the Journal
  418. </para>
  419. <indexterm zone="ch-system-systemd systemd-cat">
  420. <primary sortas="b-systemd-cat">systemd-cat</primary>
  421. </indexterm>
  422. </listitem>
  423. </varlistentry>
  424. <varlistentry id="systemd-cgls">
  425. <term><command>systemd-cgls</command></term>
  426. <listitem>
  427. <para>Recursively shows the contents of the selected Linux control
  428. group hierarchy in a tree</para>
  429. <indexterm zone="ch-system-systemd systemd-cgls">
  430. <primary sortas="b-systemd-cgls">systemd-cgls</primary>
  431. </indexterm>
  432. </listitem>
  433. </varlistentry>
  434. <varlistentry id="systemd-cgtop">
  435. <term><command>systemd-cgtop</command></term>
  436. <listitem>
  437. <para>Shows the top control groups of the local Linux control group
  438. hierarchy, ordered by their CPU, memory and disk I/O load</para>
  439. <indexterm zone="ch-system-systemd systemd-cgtop">
  440. <primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
  441. </indexterm>
  442. </listitem>
  443. </varlistentry>
  444. <varlistentry id="systemd-delta">
  445. <term><command>systemd-delta</command></term>
  446. <listitem>
  447. <para>Used to identify and compare configuration files in
  448. <filename class="directory">/etc</filename> that override default
  449. counterparts in <filename class="directory">/usr</filename></para>
  450. <indexterm zone="ch-system-systemd systemd-delta">
  451. <primary sortas="b-systemd-delta">systemd-delta</primary>
  452. </indexterm>
  453. </listitem>
  454. </varlistentry>
  455. <varlistentry id="systemd-detect-virt">
  456. <term><command>systemd-detect-virt</command></term>
  457. <listitem>
  458. <para>Detects execution in a virtualized environment</para>
  459. <indexterm zone="ch-system-systemd systemd-detect-virt">
  460. <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
  461. </indexterm>
  462. </listitem>
  463. </varlistentry>
  464. <varlistentry id="systemd-escape">
  465. <term><command>systemd-escape</command></term>
  466. <listitem>
  467. <para>Used to escape strings for inclusion in systemd unit
  468. names</para>
  469. <indexterm zone="ch-system-systemd systemd-escape">
  470. <primary sortas="b-systemd-escape">systemd-escape</primary>
  471. </indexterm>
  472. </listitem>
  473. </varlistentry>
  474. <varlistentry id="systemd-hwdb">
  475. <term><command>systemd-hwdb</command></term>
  476. <listitem>
  477. <para>Used to manage hardware database (hwdb)</para>
  478. <indexterm zone="ch-system-systemd systemd-hwdb">
  479. <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
  480. </indexterm>
  481. </listitem>
  482. </varlistentry>
  483. <varlistentry id="systemd-inhibit">
  484. <term><command>systemd-inhibit</command></term>
  485. <listitem>
  486. <para>Used to execute a program with a shutdown, sleep or idle
  487. inhibitor lock taken</para>
  488. <indexterm zone="ch-system-systemd systemd-inhibit">
  489. <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
  490. </indexterm>
  491. </listitem>
  492. </varlistentry>
  493. <varlistentry id="systemd-machine-id-setup">
  494. <term><command>systemd-machine-id-setup</command></term>
  495. <listitem>
  496. <para>Used by system installer tools to initialize the machine ID
  497. stored in <filename>/etc/machine-id</filename> at install time with a
  498. randomly generated ID</para>
  499. <indexterm zone="ch-system-systemd systemd-machine-id-setup">
  500. <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary>
  501. </indexterm>
  502. </listitem>
  503. </varlistentry>
  504. <varlistentry id="systemd-mount">
  505. <term><command>systemd-mount</command></term>
  506. <listitem>
  507. <para>is a tool to temporarily mount or auto-mount a drive.</para>
  508. <indexterm zone="ch-system-systemd systemd-mount">
  509. <primary sortas="b-systemd-mount">systemd-mount</primary>
  510. </indexterm>
  511. </listitem>
  512. </varlistentry>
  513. <varlistentry id="systemd-notify">
  514. <term><command>systemd-notify</command></term>
  515. <listitem>
  516. <para>Used by daemon scripts to notify the init system about status
  517. changes</para>
  518. <indexterm zone="ch-system-systemd systemd-notify">
  519. <primary sortas="b-systemd-notify">systemd-notify</primary>
  520. </indexterm>
  521. </listitem>
  522. </varlistentry>
  523. <varlistentry id="systemd-nspawn">
  524. <term><command>systemd-nspawn</command></term>
  525. <listitem>
  526. <para>Used to run a command or OS in a light-weight namespace
  527. container</para>
  528. <indexterm zone="ch-system-systemd systemd-nspawn">
  529. <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
  530. </indexterm>
  531. </listitem>
  532. </varlistentry>
  533. <varlistentry id="systemd-path">
  534. <term><command>systemd-path</command></term>
  535. <listitem>
  536. <para>Used to query system and user paths</para>
  537. <indexterm zone="ch-system-systemd systemd-path">
  538. <primary sortas="b-systemd-path">systemd-path</primary>
  539. </indexterm>
  540. </listitem>
  541. </varlistentry>
  542. <varlistentry id="systemd-resolve">
  543. <term><command>systemd-resolve</command></term>
  544. <listitem>
  545. <para>Used to resolve domain names, IPV4 and IPv6 addresses, DNS
  546. resource records, and services</para>
  547. <indexterm zone="ch-system-systemd systemd-resolve">
  548. <primary sortas="b-systemd-resolve">systemd-resolve</primary>
  549. </indexterm>
  550. </listitem>
  551. </varlistentry>
  552. <varlistentry id="systemd-run">
  553. <term><command>systemd-run</command></term>
  554. <listitem>
  555. <para>Used to create and start a transient .service or a .scope unit
  556. and run the specified command in it</para>
  557. <indexterm zone="ch-system-systemd systemd-run">
  558. <primary sortas="b-systemd-run">systemd-run</primary>
  559. </indexterm>
  560. </listitem>
  561. </varlistentry>
  562. <!-- <varlistentry id="systemd-stdio-bridge">
  563. <term><command>systemd-stdio-bridge</command></term>
  564. <listitem>
  565. <para>To be completed</para>
  566. <indexterm zone="ch-system-systemd systemd-stdio-bridge">
  567. <primary sortas="b-systemd-stdio-bridge">systemd-stdio-bridge</primary>
  568. </indexterm>
  569. </listitem>
  570. </varlistentry> -->
  571. <varlistentry id="systemd-socket-activate">
  572. <term><command>systemd-socket-activate</command></term>
  573. <listitem>
  574. <para>is a tool to listen on socket devices and launch a process upon
  575. connection.</para>
  576. <indexterm zone="ch-system-systemd systemd-socket-activate">
  577. <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
  578. </indexterm>
  579. </listitem>
  580. </varlistentry>
  581. <varlistentry id="systemd-tmpfiles">
  582. <term><command>systemd-tmpfiles</command></term>
  583. <listitem>
  584. <para>Creates, deletes and cleans up volatile and temporary files and
  585. directories, based on the configuration file format and location
  586. specified in
  587. <filename class="directory">tmpfiles.d</filename> directories</para>
  588. <indexterm zone="ch-system-systemd systemd-tmpfiles">
  589. <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary>
  590. </indexterm>
  591. </listitem>
  592. </varlistentry>
  593. <varlistentry id="systemd-tty-ask-password-agent">
  594. <term><command>systemd-tty-ask-password-agent</command></term>
  595. <listitem>
  596. <para>Used to list or process pending systemd password requests</para>
  597. <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
  598. <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
  599. </indexterm>
  600. </listitem>
  601. </varlistentry>
  602. <varlistentry id="telinit">
  603. <term><command>telinit</command></term>
  604. <listitem>
  605. <para>Tells <command>init</command> which run-level to change
  606. to</para>
  607. <indexterm zone="ch-system-systemd telinit">
  608. <primary sortas="b-telinit">telinit</primary>
  609. </indexterm>
  610. </listitem>
  611. </varlistentry>
  612. <varlistentry id="timedatectl">
  613. <term><command>timedatectl</command></term>
  614. <listitem>
  615. <para>Used to query and change the system clock and its settings
  616. </para>
  617. <indexterm zone="ch-system-systemd timedatectl">
  618. <primary sortas="b-timedatectl">timedatectl</primary>
  619. </indexterm>
  620. </listitem>
  621. </varlistentry>
  622. <varlistentry id="udevadm">
  623. <term><command>udevadm</command></term>
  624. <listitem>
  625. <para>Generic Udev administration tool: controls the udevd daemon,
  626. provides info from the Udev database, monitors uevents, waits for
  627. uevents to finish, tests Udev configuration, and triggers uevents
  628. for a given device</para>
  629. <indexterm zone="ch-system-systemd udevadm">
  630. <primary sortas="b-udevadm">udevadm</primary>
  631. </indexterm>
  632. </listitem>
  633. </varlistentry>
  634. <varlistentry id="libsystemd">
  635. <term><filename class="libraryfile">libsystemd</filename></term>
  636. <listitem>
  637. <para>systemd utility library</para>
  638. <indexterm zone="ch-system-systemd libsystemd">
  639. <primary sortas="c-libsystemd">libsystemd</primary>
  640. </indexterm>
  641. </listitem>
  642. </varlistentry>
  643. <varlistentry id="libudev">
  644. <term><filename class="libraryfile">libudev</filename></term>
  645. <listitem>
  646. <para>A library to access Udev device information</para>
  647. <indexterm zone="ch-system-systemd libudev">
  648. <primary sortas="c-libudev">libudev</primary>
  649. </indexterm>
  650. </listitem>
  651. </varlistentry>
  652. </variablelist>
  653. </sect2>
  654. </sect1>