systemd.xml 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831
  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. <!--
  34. <para>First, apply a patch to fix various bugs since the release
  35. of systemd-243.</para>
  36. <screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-consolidated_fixes-2.patch</userinput></screen>
  37. -->
  38. <para>Create a symlink to work around missing xsltproc:</para>
  39. <screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen>
  40. <para>Because we have not yet installed the final version of Util-Linux,
  41. create links to the libraries in the appropriate location:</para>
  42. <screen><userinput remap="pre">for file in /tools/lib/lib{blkid,mount,uuid}.so*; do
  43. ln -sf $file /usr/lib/
  44. done</userinput></screen>
  45. <para>Set up the man pages:</para>
  46. <screen><userinput remap="pre">tar -xf ../systemd-man-pages-&systemd-version;.tar.xz</userinput></screen>
  47. <para>Remove tests that cannot be built in chroot:</para>
  48. <screen><userinput remap="pre">sed '179,$ d' -i src/resolve/meson.build</userinput></screen>
  49. <para>Remove an unneeded group,
  50. <systemitem class="groupname">render</systemitem>, from the default udev
  51. rules:</para>
  52. <screen><userinput remap="pre">sed -i 's/GROUP="render", //' rules.d/50-udev-default.rules.in</userinput></screen>
  53. <para>Prepare systemd for compilation:</para>
  54. <screen><userinput remap="configure">mkdir -p build
  55. cd build
  56. PKG_CONFIG_PATH="/usr/lib/pkgconfig:/tools/lib/pkgconfig" \
  57. LANG=en_US.UTF-8 \
  58. meson --prefix=/usr \
  59. --sysconfdir=/etc \
  60. --localstatedir=/var \
  61. -Dblkid=true \
  62. -Dbuildtype=release \
  63. -Ddefault-dnssec=no \
  64. -Dfirstboot=false \
  65. -Dinstall-tests=false \
  66. -Dkmod-path=/bin/kmod \
  67. -Dldconfig=false \
  68. -Dmount-path=/bin/mount \
  69. -Drootprefix= \
  70. -Drootlibdir=/lib \
  71. -Dsplit-usr=true \
  72. -Dsulogin-path=/sbin/sulogin \
  73. -Dsysusers=false \
  74. -Dumount-path=/bin/umount \
  75. -Db_lto=false \
  76. -Drpmmacrosdir=no \
  77. -Dhomed=false \
  78. -Duserdb=false \
  79. ..</userinput></screen>
  80. <variablelist>
  81. <title>The meaning of the meson options:</title>
  82. <varlistentry>
  83. <term><parameter>-D*-path=*</parameter></term>
  84. <listitem>
  85. <para>These switches provide location of binaries needed by
  86. systemd at runtime that have not yet been installed, or who's
  87. pkgconfig files are currently only in
  88. <filename>/tools/lib/pkgconfig</filename>.</para>
  89. </listitem>
  90. </varlistentry>
  91. <varlistentry>
  92. <term><parameter>-Ddefault-dnssec=no</parameter></term>
  93. <listitem>
  94. <para>This switch turns off the experimental DNSSEC support.</para>
  95. </listitem>
  96. </varlistentry>
  97. <varlistentry>
  98. <term><parameter>-Dfirstboot=false</parameter></term>
  99. <listitem>
  100. <para>This switch prevents installation of systemd
  101. services responsible for setting up the system for
  102. the first time. They are not useful for LFS because
  103. everything is done manually.</para>
  104. </listitem>
  105. </varlistentry>
  106. <varlistentry>
  107. <term><parameter>-Dinstall-tests=false</parameter></term>
  108. <listitem>
  109. <para>This switch prevents installation of the compiled tests.</para>
  110. </listitem>
  111. </varlistentry>
  112. <varlistentry>
  113. <term><parameter>-Dldconfig=false</parameter></term>
  114. <listitem>
  115. <para>This switch prevents installation of a systemd unit that runs
  116. <command>ldconfig</command> at boot, which is not useful for source
  117. distributions such as LFS and makes the boot time longer. Remove it
  118. if the described feature is desired.</para>
  119. </listitem>
  120. </varlistentry>
  121. <varlistentry>
  122. <term><parameter>-Droot*</parameter></term>
  123. <listitem>
  124. <para>These switches ensure that core programs and
  125. shared libraries are installed in the subdirectories
  126. of the root partition.</para>
  127. </listitem>
  128. </varlistentry>
  129. <varlistentry>
  130. <term><parameter>-Dsplit-usr=true</parameter></term>
  131. <listitem>
  132. <para>This switch ensures that systemd will work on
  133. systems where /bin, /lib and /sbin directories are not
  134. symlinks to their /usr counterparts.</para>
  135. </listitem>
  136. </varlistentry>
  137. <varlistentry>
  138. <term><parameter>-Dsysusers=false</parameter></term>
  139. <listitem>
  140. <para>This switch prevents installation of systemd
  141. services responsible for setting up the
  142. <filename>/etc/group</filename> and
  143. <filename>/etc/passwd</filename> files. Both files
  144. were created earlier in this chapter.</para>
  145. </listitem>
  146. </varlistentry>
  147. <varlistentry>
  148. <term><parameter>-Drpmmacrosdir=no</parameter></term>
  149. <listitem>
  150. <para>This switch disables installation of RPM Macros
  151. for use with systemd because LFS does not support RPM.</para>
  152. </listitem>
  153. </varlistentry>
  154. <varlistentry>
  155. <term><parameter>-D{userdb,homed}=false</parameter></term>
  156. <listitem>
  157. <para>Remove two daemons that have dependencies that do not fit
  158. the scope of LFS.</para>
  159. </listitem>
  160. </varlistentry>
  161. </variablelist>
  162. <para>Compile the package:</para>
  163. <screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
  164. <!--
  165. <para>To test the package, execute the following command:</para>
  166. <screen><userinput remap="test">LANG=en_US.UTF-8 ninja test</userinput></screen>
  167. -->
  168. <para>Install the package:</para>
  169. <screen><userinput remap="install">LANG=en_US.UTF-8 ninja install</userinput></screen>
  170. <para>Remove an unnecessary symbolic link:</para>
  171. <screen><userinput remap="install">rm -f /usr/bin/xsltproc</userinput></screen>
  172. <para>Create the <filename>/etc/machine-id</filename> file needed by
  173. <command>systemd-journald</command>:</para>
  174. <screen><userinput remap="adjust">systemd-machine-id-setup</userinput></screen>
  175. <para>Setup the basic target structure:</para>
  176. <screen><userinput remap="adjust">systemctl preset-all</userinput></screen>
  177. <para>Disable a service that is known to cause problems with systems that
  178. use a network configuration other than what is provided by
  179. systemd-networkd:</para>
  180. <!-- Observed halting startup with dhcpcd handling the primary NIC -->
  181. <screen><userinput remap="adjust">systemctl disable systemd-time-wait-sync.service</userinput></screen>
  182. <para>Prevent systemd from resetting the maximum PID value which causes
  183. some problems with packages and units in BLFS:</para>
  184. <screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen>
  185. <para>Cleanup symbolic links to Util-Linux libraries:</para>
  186. <screen><userinput remap="adjust">rm -fv /usr/lib/lib{blkid,uuid,mount}.so*</userinput></screen>
  187. <!--
  188. <para>Prevent systemd from creating <filename>/run/nologin</filename>
  189. to allow unprivileged user logins without
  190. <application>systemd-logind</application>:</para>
  191. <screen><userinput remap="adjust">rm -f /usr/lib/tmpfiles.d/systemd-nologin.conf</userinput></screen>
  192. -->
  193. </sect2>
  194. <sect2 id="contents-systemd" role="content">
  195. <title>Contents of systemd</title>
  196. <segmentedlist>
  197. <segtitle>Installed programs</segtitle>
  198. <segtitle>Installed libraries</segtitle>
  199. <segtitle>Installed directories</segtitle>
  200. <seglistitem>
  201. <seg>bootctl, busctl, coredumpctl, halt (symlink to systemctl),
  202. hostnamectl, init, journalctl, kernel-install, localectl, loginctl,
  203. machinectl, networkctl, portablectl, poweroff (symlink to
  204. systemctl), reboot (symlink to systemctl), resolvconf (symlink to
  205. resolvectl), resolvectl, runlevel (symlink to systemctl), shutdown
  206. (symlink to systemctl), systemctl, systemd-analyze,
  207. systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop,
  208. systemd-delta, systemd-detect-virt, systemd-escape, systemd-hwdb,
  209. systemd-id128, systemd-inhibit, systemd-machine-id-setup,
  210. systemd-mount, systemd-notify, systemd-nspawn, systemd-path,
  211. systemd-repart, systemd-resolve (symlink to resolvectl), systemd-run,
  212. systemd-socket-activate, systemd-stdio-bridge, systemd-tmpfiles,
  213. systemd-tty-ask-password-agent, systemd-umount (symlink to
  214. systemd-mount), telinit (symlink to systemctl), timedatectl, and
  215. udevadm</seg>
  216. <seg>libnss_myhostname.so.2, libnss_mymachines.so.2,
  217. libnss_resolve.so.2, libnss_systemd.so.2,
  218. libsystemd.so, libsystemd-shared-&systemd-version;.so (in /lib/systemd),
  219. and libudev.so</seg>
  220. <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,
  221. /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
  222. /etc/xdg/systemd, /lib/systemd, /lib/udev, /usr/include/systemd,
  223. /usr/lib/binfmt.d, /usr/lib/kernel, /usr/lib/modules-load.d,
  224. /usr/lib/sysctl.d, /usr/lib/systemd, /usr/lib/tmpfiles.d,
  225. /usr/share/doc/systemd-&systemd-version;, /usr/share/factory,
  226. /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg>
  227. </seglistitem>
  228. </segmentedlist>
  229. <variablelist>
  230. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  231. <?dbfo list-presentation="list"?>
  232. <?dbhtml list-presentation="table"?>
  233. <varlistentry id="bootctl">
  234. <term><command>bootctl</command></term>
  235. <listitem>
  236. <para>Used to query the firmware and boot manager settings</para>
  237. <indexterm zone="ch-system-systemd bootctl">
  238. <primary sortas="b-bootctl">bootctl</primary>
  239. </indexterm>
  240. </listitem>
  241. </varlistentry>
  242. <varlistentry id="busctl">
  243. <term><command>busctl</command></term>
  244. <listitem>
  245. <para>Used to introspect and monitor the D-Bus bus</para>
  246. <indexterm zone="ch-system-systemd busctl">
  247. <primary sortas="b-busctl">busctl</primary>
  248. </indexterm>
  249. </listitem>
  250. </varlistentry>
  251. <varlistentry id="coredumpctl">
  252. <term><command>coredumpctl</command></term>
  253. <listitem>
  254. <para>Used to retrieve coredumps from the systemd journal</para>
  255. <indexterm zone="ch-system-systemd coredumpctl">
  256. <primary sortas="b-coredumpctl">coredumpctl</primary>
  257. </indexterm>
  258. </listitem>
  259. </varlistentry>
  260. <varlistentry id="halt">
  261. <term><command>halt</command></term>
  262. <listitem>
  263. <para>Normally invokes <command>shutdown</command> with the
  264. <parameter>-h</parameter> option, except when already in run-level 0,
  265. then it tells the kernel to halt the system; it notes in the
  266. file <filename>/var/log/wtmp</filename> that the system is being
  267. brought down</para>
  268. <indexterm zone="ch-system-systemd halt">
  269. <primary sortas="b-halt">halt</primary>
  270. </indexterm>
  271. </listitem>
  272. </varlistentry>
  273. <varlistentry id="hostnamectl">
  274. <term><command>hostnamectl</command></term>
  275. <listitem>
  276. <para>Used to query and change the system hostname and related
  277. settings</para>
  278. <indexterm zone="ch-system-systemd hostnamectl">
  279. <primary sortas="b-hostnamectl">hostnamectl</primary>
  280. </indexterm>
  281. </listitem>
  282. </varlistentry>
  283. <varlistentry id="init">
  284. <term><command>init</command></term>
  285. <listitem>
  286. <para>The first process to be started when the kernel has initialized
  287. the hardware which takes over the boot process and starts all
  288. processes according to its configuration files</para>
  289. <indexterm zone="ch-system-systemd init">
  290. <primary sortas="b-init">init</primary>
  291. </indexterm>
  292. </listitem>
  293. </varlistentry>
  294. <varlistentry id="journalctl">
  295. <term><command>journalctl</command></term>
  296. <listitem>
  297. <para>Used to query the contents of the systemd journal</para>
  298. <indexterm zone="ch-system-systemd journalctl">
  299. <primary sortas="b-journalctl">journalctl</primary>
  300. </indexterm>
  301. </listitem>
  302. </varlistentry>
  303. <varlistentry id="kernel-install">
  304. <term><command>kernel-install</command></term>
  305. <listitem>
  306. <para>Used to add and remove kernel and initramfs images to and
  307. from /boot</para>
  308. <indexterm zone="ch-system-systemd kernel-install">
  309. <primary sortas="b-kernel-install">kernel-install</primary>
  310. </indexterm>
  311. </listitem>
  312. </varlistentry>
  313. <varlistentry id="localectl">
  314. <term><command>localectl</command></term>
  315. <listitem>
  316. <para>Used to query and change the system locale and keyboard layout
  317. settings</para>
  318. <indexterm zone="ch-system-systemd localectl">
  319. <primary sortas="b-localectl">localectl</primary>
  320. </indexterm>
  321. </listitem>
  322. </varlistentry>
  323. <varlistentry id="loginctl">
  324. <term><command>loginctl</command></term>
  325. <listitem>
  326. <para>Used to introspect and control the state of the systemd Login
  327. Manager</para>
  328. <indexterm zone="ch-system-systemd loginctl">
  329. <primary sortas="b-loginctl">loginctl</primary>
  330. </indexterm>
  331. </listitem>
  332. </varlistentry>
  333. <varlistentry id="machinectl">
  334. <term><command>machinectl</command></term>
  335. <listitem>
  336. <para>Used to introspect and control the state of the systemd Virtual
  337. Machine and Container Registration Manager</para>
  338. <indexterm zone="ch-system-systemd machinectl">
  339. <primary sortas="b-machinectl">machinectl</primary>
  340. </indexterm>
  341. </listitem>
  342. </varlistentry>
  343. <varlistentry id="networkctl">
  344. <term><command>networkctl</command></term>
  345. <listitem>
  346. <para>Used to introspect the state of the network links as seen by
  347. systemd-networkd</para>
  348. <indexterm zone="ch-system-systemd networkctl">
  349. <primary sortas="b-networkctl">networkctl</primary>
  350. </indexterm>
  351. </listitem>
  352. </varlistentry>
  353. <varlistentry id="portablectl">
  354. <term><command>portablectl</command></term>
  355. <listitem>
  356. <para>Used to attach or detach portable services from the local
  357. system</para>
  358. <indexterm zone="ch-system-systemd portablectl">
  359. <primary sortas="b-portablectl">portablectl</primary>
  360. </indexterm>
  361. </listitem>
  362. </varlistentry>
  363. <varlistentry id="poweroff">
  364. <term><command>poweroff</command></term>
  365. <listitem>
  366. <para>Tells the kernel to halt the system and switch off the computer
  367. (see <command>halt</command>)</para>
  368. <indexterm zone="ch-system-systemd poweroff">
  369. <primary sortas="b-poweroff">poweroff</primary>
  370. </indexterm>
  371. </listitem>
  372. </varlistentry>
  373. <varlistentry id="reboot">
  374. <term><command>reboot</command></term>
  375. <listitem>
  376. <para>Tells the kernel to reboot the system (see
  377. <command>halt</command>)</para>
  378. <indexterm zone="ch-system-systemd reboot">
  379. <primary sortas="b-reboot">reboot</primary>
  380. </indexterm>
  381. </listitem>
  382. </varlistentry>
  383. <varlistentry id="resolvconf">
  384. <term><command>resolvconf</command></term>
  385. <listitem>
  386. <para>Register DNS server and domain configuration with
  387. <command>systemd-resolved</command></para>
  388. <indexterm zone="ch-system-systemd resolvconf">
  389. <primary sortas="b-resolvconf">resolvconf</primary>
  390. </indexterm>
  391. </listitem>
  392. </varlistentry>
  393. <varlistentry id="resolvectl">
  394. <term><command>resolvectl</command></term>
  395. <listitem>
  396. <para>Send control commands to the network name resolution
  397. manager, or resolve domain names, IPv4 and IPv6 addresses,
  398. DNS records, and services.</para>
  399. <indexterm zone="ch-system-systemd resolvectl">
  400. <primary sortas="b-resolvectl">resolvectl</primary>
  401. </indexterm>
  402. </listitem>
  403. </varlistentry>
  404. <varlistentry id="runlevel">
  405. <term><command>runlevel</command></term>
  406. <listitem>
  407. <para>Reports the previous and the current run-level, as noted in the
  408. last run-level record in <filename>/var/run/utmp</filename></para>
  409. <indexterm zone="ch-system-systemd runlevel">
  410. <primary sortas="b-runlevel">runlevel</primary>
  411. </indexterm>
  412. </listitem>
  413. </varlistentry>
  414. <varlistentry id="shutdown">
  415. <term><command>shutdown</command></term>
  416. <listitem>
  417. <para>Brings the system down in a secure way, signaling all processes
  418. and notifying all logged-in users</para>
  419. <indexterm zone="ch-system-systemd shutdown">
  420. <primary sortas="b-shutdown">shutdown</primary>
  421. </indexterm>
  422. </listitem>
  423. </varlistentry>
  424. <varlistentry id="systemctl">
  425. <term><command>systemctl</command></term>
  426. <listitem>
  427. <para>Used to introspect and control the state of the systemd system
  428. and service manager</para>
  429. <indexterm zone="ch-system-systemd systemctl">
  430. <primary sortas="b-systemctl">systemctl</primary>
  431. </indexterm>
  432. </listitem>
  433. </varlistentry>
  434. <varlistentry id="systemd-analyze">
  435. <term><command>systemd-analyze</command></term>
  436. <listitem>
  437. <para>Used to determine system boot-up performance of the current
  438. boot</para>
  439. <indexterm zone="ch-system-systemd systemd-analyze">
  440. <primary sortas="b-systemd-analyze">systemd-analyze</primary>
  441. </indexterm>
  442. </listitem>
  443. </varlistentry>
  444. <varlistentry id="systemd-ask-password">
  445. <term><command>systemd-ask-password</command></term>
  446. <listitem>
  447. <para>Used to query a system password or passphrase from the user,
  448. using a question message specified on the command line</para>
  449. <indexterm zone="ch-system-systemd systemd-ask-password">
  450. <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
  451. </indexterm>
  452. </listitem>
  453. </varlistentry>
  454. <varlistentry id="systemd-cat">
  455. <term><command>systemd-cat</command></term>
  456. <listitem>
  457. <para>Used to connect STDOUT and STDERR of a process with the Journal
  458. </para>
  459. <indexterm zone="ch-system-systemd systemd-cat">
  460. <primary sortas="b-systemd-cat">systemd-cat</primary>
  461. </indexterm>
  462. </listitem>
  463. </varlistentry>
  464. <varlistentry id="systemd-cgls">
  465. <term><command>systemd-cgls</command></term>
  466. <listitem>
  467. <para>Recursively shows the contents of the selected Linux control
  468. group hierarchy in a tree</para>
  469. <indexterm zone="ch-system-systemd systemd-cgls">
  470. <primary sortas="b-systemd-cgls">systemd-cgls</primary>
  471. </indexterm>
  472. </listitem>
  473. </varlistentry>
  474. <varlistentry id="systemd-cgtop">
  475. <term><command>systemd-cgtop</command></term>
  476. <listitem>
  477. <para>Shows the top control groups of the local Linux control group
  478. hierarchy, ordered by their CPU, memory and disk I/O load</para>
  479. <indexterm zone="ch-system-systemd systemd-cgtop">
  480. <primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
  481. </indexterm>
  482. </listitem>
  483. </varlistentry>
  484. <varlistentry id="systemd-delta">
  485. <term><command>systemd-delta</command></term>
  486. <listitem>
  487. <para>Used to identify and compare configuration files in
  488. <filename class="directory">/etc</filename> that override default
  489. counterparts in <filename class="directory">/usr</filename></para>
  490. <indexterm zone="ch-system-systemd systemd-delta">
  491. <primary sortas="b-systemd-delta">systemd-delta</primary>
  492. </indexterm>
  493. </listitem>
  494. </varlistentry>
  495. <varlistentry id="systemd-detect-virt">
  496. <term><command>systemd-detect-virt</command></term>
  497. <listitem>
  498. <para>Detects execution in a virtualized environment</para>
  499. <indexterm zone="ch-system-systemd systemd-detect-virt">
  500. <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
  501. </indexterm>
  502. </listitem>
  503. </varlistentry>
  504. <varlistentry id="systemd-escape">
  505. <term><command>systemd-escape</command></term>
  506. <listitem>
  507. <para>Used to escape strings for inclusion in systemd unit
  508. names</para>
  509. <indexterm zone="ch-system-systemd systemd-escape">
  510. <primary sortas="b-systemd-escape">systemd-escape</primary>
  511. </indexterm>
  512. </listitem>
  513. </varlistentry>
  514. <varlistentry id="systemd-hwdb">
  515. <term><command>systemd-hwdb</command></term>
  516. <listitem>
  517. <para>Used to manage hardware database (hwdb)</para>
  518. <indexterm zone="ch-system-systemd systemd-hwdb">
  519. <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
  520. </indexterm>
  521. </listitem>
  522. </varlistentry>
  523. <varlistentry id="systemd-id128">
  524. <term><command>systemd-id128</command></term>
  525. <listitem>
  526. <para>Generate and print id128 strings</para>
  527. <indexterm zone="ch-system-systemd systemd-id128">
  528. <primary sortas="b-systemd-id128">systemd-id128</primary>
  529. </indexterm>
  530. </listitem>
  531. </varlistentry>
  532. <varlistentry id="systemd-inhibit">
  533. <term><command>systemd-inhibit</command></term>
  534. <listitem>
  535. <para>Used to execute a program with a shutdown, sleep or idle
  536. inhibitor lock taken</para>
  537. <indexterm zone="ch-system-systemd systemd-inhibit">
  538. <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
  539. </indexterm>
  540. </listitem>
  541. </varlistentry>
  542. <varlistentry id="systemd-machine-id-setup">
  543. <term><command>systemd-machine-id-setup</command></term>
  544. <listitem>
  545. <para>Used by system installer tools to initialize the machine ID
  546. stored in <filename>/etc/machine-id</filename> at install time with a
  547. randomly generated ID</para>
  548. <indexterm zone="ch-system-systemd systemd-machine-id-setup">
  549. <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary>
  550. </indexterm>
  551. </listitem>
  552. </varlistentry>
  553. <varlistentry id="systemd-mount">
  554. <term><command>systemd-mount</command></term>
  555. <listitem>
  556. <para>A tool to temporarily mount or auto-mount a drive.</para>
  557. <indexterm zone="ch-system-systemd systemd-mount">
  558. <primary sortas="b-systemd-mount">systemd-mount</primary>
  559. </indexterm>
  560. </listitem>
  561. </varlistentry>
  562. <varlistentry id="systemd-notify">
  563. <term><command>systemd-notify</command></term>
  564. <listitem>
  565. <para>Used by daemon scripts to notify the init system about status
  566. changes</para>
  567. <indexterm zone="ch-system-systemd systemd-notify">
  568. <primary sortas="b-systemd-notify">systemd-notify</primary>
  569. </indexterm>
  570. </listitem>
  571. </varlistentry>
  572. <varlistentry id="systemd-nspawn">
  573. <term><command>systemd-nspawn</command></term>
  574. <listitem>
  575. <para>Used to run a command or OS in a light-weight namespace
  576. container</para>
  577. <indexterm zone="ch-system-systemd systemd-nspawn">
  578. <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
  579. </indexterm>
  580. </listitem>
  581. </varlistentry>
  582. <varlistentry id="systemd-path">
  583. <term><command>systemd-path</command></term>
  584. <listitem>
  585. <para>Used to query system and user paths</para>
  586. <indexterm zone="ch-system-systemd systemd-path">
  587. <primary sortas="b-systemd-path">systemd-path</primary>
  588. </indexterm>
  589. </listitem>
  590. </varlistentry>
  591. <varlistentry id="systemd-repart">
  592. <term><command>systemd-repart</command></term>
  593. <listitem>
  594. <para>Used go grow and add partitions to a partition table when
  595. systemd is used in an OS image (e.g. a container).</para>
  596. <indexterm zone="ch-system-systemd systemd-repart">
  597. <primary sortas="b-systemd-repart">systemd-repart</primary>
  598. </indexterm>
  599. </listitem>
  600. </varlistentry>
  601. <varlistentry id="systemd-resolve">
  602. <term><command>systemd-resolve</command></term>
  603. <listitem>
  604. <para>Used to resolve domain names, IPV4 and IPv6 addresses, DNS
  605. resource records, and services</para>
  606. <indexterm zone="ch-system-systemd systemd-resolve">
  607. <primary sortas="b-systemd-resolve">systemd-resolve</primary>
  608. </indexterm>
  609. </listitem>
  610. </varlistentry>
  611. <varlistentry id="systemd-run">
  612. <term><command>systemd-run</command></term>
  613. <listitem>
  614. <para>Used to create and start a transient .service or a .scope unit
  615. and run the specified command in it</para>
  616. <indexterm zone="ch-system-systemd systemd-run">
  617. <primary sortas="b-systemd-run">systemd-run</primary>
  618. </indexterm>
  619. </listitem>
  620. </varlistentry>
  621. <!-- <varlistentry id="systemd-stdio-bridge">
  622. <term><command>systemd-stdio-bridge</command></term>
  623. <listitem>
  624. <para>To be completed</para>
  625. <indexterm zone="ch-system-systemd systemd-stdio-bridge">
  626. <primary sortas="b-systemd-stdio-bridge">systemd-stdio-bridge</primary>
  627. </indexterm>
  628. </listitem>
  629. </varlistentry> -->
  630. <varlistentry id="systemd-socket-activate">
  631. <term><command>systemd-socket-activate</command></term>
  632. <listitem>
  633. <para>A tool to listen on socket devices and launch a process upon
  634. connection.</para>
  635. <indexterm zone="ch-system-systemd systemd-socket-activate">
  636. <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
  637. </indexterm>
  638. </listitem>
  639. </varlistentry>
  640. <varlistentry id="systemd-tmpfiles">
  641. <term><command>systemd-tmpfiles</command></term>
  642. <listitem>
  643. <para>Creates, deletes and cleans up volatile and temporary files and
  644. directories, based on the configuration file format and location
  645. specified in
  646. <filename class="directory">tmpfiles.d</filename> directories</para>
  647. <indexterm zone="ch-system-systemd systemd-tmpfiles">
  648. <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary>
  649. </indexterm>
  650. </listitem>
  651. </varlistentry>
  652. <varlistentry id="systemd-umount">
  653. <term><command>systemd-umount</command></term>
  654. <listitem>
  655. <para>Unmount mount points</para>
  656. <indexterm zone="ch-system-systemd systemd-umount">
  657. <primary sortas="b-systemd-umount">systemd-umount</primary>
  658. </indexterm>
  659. </listitem>
  660. </varlistentry>
  661. <varlistentry id="systemd-tty-ask-password-agent">
  662. <term><command>systemd-tty-ask-password-agent</command></term>
  663. <listitem>
  664. <para>Used to list or process pending systemd password requests</para>
  665. <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
  666. <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
  667. </indexterm>
  668. </listitem>
  669. </varlistentry>
  670. <varlistentry id="telinit">
  671. <term><command>telinit</command></term>
  672. <listitem>
  673. <para>Tells <command>init</command> which run-level to change
  674. to</para>
  675. <indexterm zone="ch-system-systemd telinit">
  676. <primary sortas="b-telinit">telinit</primary>
  677. </indexterm>
  678. </listitem>
  679. </varlistentry>
  680. <varlistentry id="timedatectl">
  681. <term><command>timedatectl</command></term>
  682. <listitem>
  683. <para>Used to query and change the system clock and its settings
  684. </para>
  685. <indexterm zone="ch-system-systemd timedatectl">
  686. <primary sortas="b-timedatectl">timedatectl</primary>
  687. </indexterm>
  688. </listitem>
  689. </varlistentry>
  690. <varlistentry id="udevadm">
  691. <term><command>udevadm</command></term>
  692. <listitem>
  693. <para>Generic udev administration tool: controls the udevd daemon,
  694. provides info from the Udev database, monitors uevents, waits for
  695. uevents to finish, tests udev configuration, and triggers uevents
  696. for a given device</para>
  697. <indexterm zone="ch-system-systemd udevadm">
  698. <primary sortas="b-udevadm">udevadm</primary>
  699. </indexterm>
  700. </listitem>
  701. </varlistentry>
  702. <varlistentry id="libsystemd">
  703. <term><filename class="libraryfile">libsystemd</filename></term>
  704. <listitem>
  705. <para>The main systemd utility library</para>
  706. <indexterm zone="ch-system-systemd libsystemd">
  707. <primary sortas="c-libsystemd">libsystemd</primary>
  708. </indexterm>
  709. </listitem>
  710. </varlistentry>
  711. <varlistentry id="libudev">
  712. <term><filename class="libraryfile">libudev</filename></term>
  713. <listitem>
  714. <para>A library to access Udev device information</para>
  715. <indexterm zone="ch-system-systemd libudev">
  716. <primary sortas="c-libudev">libudev</primary>
  717. </indexterm>
  718. </listitem>
  719. </varlistentry>
  720. </variablelist>
  721. </sect2>
  722. </sect1>