Changeset 9e7475a for chapter08

Timestamp:

06/12/2020 09:04:48 PM (4 years ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

4234aea6

Parents:

a3d0817

Message:

Updates to chapter09 for systemd

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

Location:

chapter08

Files:

• dbus.xml (modified) (5 diffs)
• systemd.xml (modified) (48 diffs)

chapter08/dbus.xml

@@ -64 +64 @@
         <term><parameter>--with-console-auth-dir=/run/console</parameter></term>
         <listitem>
-          <para>This specifies the location of the ConsoleKit auth
+          <para>This specifies the location of the ConsoleKit authorization
           directory.</para>
         </listitem>
@@ -92 +92 @@
 ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</userinput></screen>
 
-    <para>Create a symlink, so that D-Bus and systemd can use the same
+    <para>Create a symlink so that D-Bus and systemd can use the same
     <filename>machine-id</filename> file:</para>
 
@@ -131 +131 @@
         <term><command>dbus-cleanup-sockets</command></term>
         <listitem>
-          <para>Used to clean up leftover sockets in a directory</para>
+          <para>is used to remove leftover sockets in a directory</para>
           <indexterm zone="ch-system-dbus dbus-cleanup-sockets">
             <primary sortas="b-dbus-cleanup-sockets">dbus-cleanup-sockets</primary>
@@ -141 +141 @@
         <term><command>dbus-daemon</command></term>
         <listitem>
-          <para>The D-Bus message bus daemon</para>
+          <para>Is the D-Bus message bus daemon</para>
           <indexterm zone="ch-system-dbus dbus-daemon">
             <primary sortas="b-dbus-daemon">dbus-daemon</primary>
@@ -194 +194 @@
         <term><command>dbus-test-tool</command></term>
         <listitem>
-          <para>A tool to help packages test
+          <para>Is a tool to help packages test
           <application>D-Bus</application></para>
           <indexterm zone="ch-system-dbus dbus-test-tool">

chapter08/systemd.xml

@@ -45 +45 @@
 <screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-gcc_10-fixes-1.patch</userinput></screen>
 
-
-    <para>Create a symlink to work around missing xsltproc:</para>
+    <para>Create a symlink to work around the xsltproc command not being installed:</para>
 
 <screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
@@ -97 +96 @@
       <title>The meaning of the meson options:</title>
 
-<!--
-      <varlistentry>
-        <term><parameter>-Dc_args=-Wno-format-overflow</parameter></term>
-        <listitem>
-          <para>The defaults flags passed to gcc contain
-          <parameter>-Werror=format-overflow</parameter>, which generates
-          an error with GCC 10. Passing this parameter prevents the error
-          from occuring.</para>
-        </listitem>
-      </varlistentry>
--->
-
       <varlistentry>
         <term><parameter>-D*-path=*</parameter></term>
         <listitem>
-          <para>These switches provide location of binaries needed by
+          <para>These switches provide the location of binaries needed by
           systemd at runtime that have not yet been installed.</para>
         </listitem>
@@ -155 +142 @@
         <listitem>
           <para>These switches ensure that core programs and
-          shared libraries are installed in the subdirectories
+          shared libraries are installed in subdirectories
           of the root partition.</para>
         </listitem>
@@ -201 +188 @@
 
 <screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
-<!--
-    <para>To test the package, execute the following command:</para>
-
-<screen><userinput remap="test">LANG=en_US.UTF-8 ninja test</userinput></screen>
--->
+
     <para>Install the package:</para>
 
@@ -233 +216 @@
     some problems with packages and units in BLFS:</para>
     
-
 <screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen>
 
-    <!--
-    <para>Prevent systemd from creating <filename>/run/nologin</filename>
-    to allow unprivileged user logins without
-    <application>systemd-logind</application>:</para>
-
-<screen><userinput remap="adjust">rm -f /usr/lib/tmpfiles.d/systemd-nologin.conf</userinput></screen>
-    -->
   </sect2>
 
@@ -291 +266 @@
         <term><command>bootctl</command></term>
         <listitem>
-          <para>Used to query the firmware and boot manager settings</para>
+          <para>Is used to query the firmware and boot manager settings</para>
           <indexterm zone="ch-system-systemd bootctl">
             <primary sortas="b-bootctl">bootctl</primary>
@@ -301 +276 @@
         <term><command>busctl</command></term>
         <listitem>
-          <para>Used to introspect and monitor the D-Bus bus</para>
+          <para>Is used to introspect and monitor the D-Bus bus</para>
           <indexterm zone="ch-system-systemd busctl">
             <primary sortas="b-busctl">busctl</primary>
@@ -311 +286 @@
         <term><command>coredumpctl</command></term>
         <listitem>
-          <para>Used to retrieve coredumps from the systemd journal</para>
+          <para>Is used to retrieve coredumps from the systemd journal</para>
           <indexterm zone="ch-system-systemd coredumpctl">
             <primary sortas="b-coredumpctl">coredumpctl</primary>
@@ -335 +310 @@
         <term><command>hostnamectl</command></term>
         <listitem>
-          <para>Used to query and change the system hostname and related
+          <para>Is used to query and change the system hostname and related
           settings</para>
           <indexterm zone="ch-system-systemd hostnamectl">
@@ -346 +321 @@
         <term><command>init</command></term>
         <listitem>
-          <para>The first process to be started when the kernel has initialized
+          <para>Is the first process to be started when the kernel has initialized
           the hardware which takes over the boot process and starts all 
-          processes according to its configuration files</para>
+          processes according to its configuration files. In this case, it starts
+          systemd.</para>
           <indexterm zone="ch-system-systemd init">
             <primary sortas="b-init">init</primary>
@@ -358 +334 @@
         <term><command>journalctl</command></term>
         <listitem>
-          <para>Used to query the contents of the systemd journal</para>
+          <para>Is used to query the contents of the systemd journal</para>
           <indexterm zone="ch-system-systemd journalctl">
             <primary sortas="b-journalctl">journalctl</primary>
@@ -368 +344 @@
         <term><command>kernel-install</command></term>
         <listitem>
-          <para>Used to add and remove kernel and initramfs images to and
-          from /boot</para>
+          <para>Is used to add and remove kernel and initramfs images to and
+          from /boot. In LFS, this is done manually.</para>
           <indexterm zone="ch-system-systemd kernel-install">
             <primary sortas="b-kernel-install">kernel-install</primary>
@@ -379 +355 @@
         <term><command>localectl</command></term>
         <listitem>
-          <para>Used to query and change the system locale and keyboard layout
+          <para>Is used to query and change the system locale and keyboard layout
           settings</para>
           <indexterm zone="ch-system-systemd localectl">
@@ -390 +366 @@
         <term><command>loginctl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd Login
+          <para>Is used to introspect and control the state of the systemd Login
           Manager</para>
           <indexterm zone="ch-system-systemd loginctl">
@@ -401 +377 @@
         <term><command>machinectl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd Virtual
+          <para>Is used to introspect and control the state of the systemd Virtual
           Machine and Container Registration Manager</para>
           <indexterm zone="ch-system-systemd machinectl">
@@ -412 +388 @@
         <term><command>networkctl</command></term>
         <listitem>
-          <para>Used to introspect the state of the network links as seen by
-          systemd-networkd</para>
+          <para>Is used to introspect and configure the state of the network 
+          links configured by systemd-networkd</para>
           <indexterm zone="ch-system-systemd networkctl">
             <primary sortas="b-networkctl">networkctl</primary>
@@ -423 +399 @@
         <term><command>portablectl</command></term>
         <listitem>
-          <para>Used to attach or detach portable services from the local
+          <para>Is used to attach or detach portable services from the local
           system</para>
           <indexterm zone="ch-system-systemd portablectl">
@@ -434 +410 @@
         <term><command>poweroff</command></term>
         <listitem>
-          <para>Tells the kernel to halt the system and switch off the computer
+          <para>Instructs the kernel to halt the system and switch off the computer
           (see <command>halt</command>)</para>
           <indexterm zone="ch-system-systemd poweroff">
@@ -445 +421 @@
         <term><command>reboot</command></term>
         <listitem>
-          <para>Tells the kernel to reboot the system (see
+          <para>Instructs the kernel to reboot the system (see
           <command>halt</command>)</para>
           <indexterm zone="ch-system-systemd reboot">
@@ -456 +432 @@
         <term><command>resolvconf</command></term>
         <listitem>
-          <para>Register DNS server and domain configuration with
+          <para>Registers DNS server and domain configuration with
           <command>systemd-resolved</command></para>
           <indexterm zone="ch-system-systemd resolvconf">
@@ -467 +443 @@
         <term><command>resolvectl</command></term>
         <listitem>
-          <para>Send control commands to the network name resolution
-          manager, or resolve domain names, IPv4 and IPv6 addresses,
+          <para>Sends control commands to the network name resolution
+          manager, or resolves domain names, IPv4 and IPv6 addresses,
           DNS records, and services.</para>
           <indexterm zone="ch-system-systemd resolvectl">
@@ -479 +455 @@
         <term><command>runlevel</command></term>
         <listitem>
-          <para>Reports the previous and the current run-level, as noted in the
+          <para>Outputs the previous and the current run-level, as noted in the
           last run-level record in <filename>/var/run/utmp</filename></para>
           <indexterm zone="ch-system-systemd runlevel">
@@ -490 +466 @@
         <term><command>shutdown</command></term>
         <listitem>
-          <para>Brings the system down in a secure way, signaling all processes
-          and notifying all logged-in users</para>
+          <para>Brings the system down in a safe and secure manner, signaling 
+          all processes and notifying all logged-in users</para>
           <indexterm zone="ch-system-systemd shutdown">
             <primary sortas="b-shutdown">shutdown</primary>
@@ -501 +477 @@
         <term><command>systemctl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd system
+          <para>Is used to introspect and control the state of the systemd system
           and service manager</para>
           <indexterm zone="ch-system-systemd systemctl">
@@ -512 +488 @@
         <term><command>systemd-analyze</command></term>
         <listitem>
-          <para>Used to determine system boot-up performance of the current
-          boot</para>
+          <para>Is used to determine system startup performance of the current
+          boot, as well as identify troublesome systemd units</para>
           <indexterm zone="ch-system-systemd systemd-analyze">
             <primary sortas="b-systemd-analyze">systemd-analyze</primary>
@@ -523 +499 @@
         <term><command>systemd-ask-password</command></term>
         <listitem>
-          <para>Used to query a system password or passphrase from the user,
+          <para>Is used to query a system password or passphrase from the user,
           using a question message specified on the command line</para>
           <indexterm zone="ch-system-systemd systemd-ask-password">
@@ -534 +510 @@
         <term><command>systemd-cat</command></term>
         <listitem>
-          <para>Used to connect STDOUT and STDERR of a process with the Journal
+          <para>Is used to connect the STDOUT and STDERR outputs of a process
+          with the systemd journal.
           </para>
           <indexterm zone="ch-system-systemd systemd-cat">
@@ -567 +544 @@
         <term><command>systemd-delta</command></term>
         <listitem>
-          <para>Used to identify and compare configuration files in
+          <para>Is used to identify and compare configuration files in
           <filename class="directory">/etc</filename> that override default
           counterparts in <filename class="directory">/usr</filename></para>
@@ -579 +556 @@
         <term><command>systemd-detect-virt</command></term>
         <listitem>
-          <para>Detects execution in a virtualized environment</para>
+          <para>Detects whether the system is being run in a virtual
+          environment, and adjusts udev accordingly.</para>
           <indexterm zone="ch-system-systemd systemd-detect-virt">
             <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
@@ -589 +567 @@
         <term><command>systemd-escape</command></term>
         <listitem>
-          <para>Used to escape strings for inclusion in systemd unit
+          <para>Is used to escape strings for inclusion in systemd unit
           names</para>
           <indexterm zone="ch-system-systemd systemd-escape">
@@ -600 +578 @@
         <term><command>systemd-hwdb</command></term>
         <listitem>
-          <para>Used to manage hardware database (hwdb)</para>
+          <para>Is used to manage the hardware database (hwdb)</para>
           <indexterm zone="ch-system-systemd systemd-hwdb">
             <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
@@ -610 +588 @@
         <term><command>systemd-id128</command></term>
         <listitem>
-          <para>Generate and print id128 strings</para>
+          <para>Generates and prints id128 strings</para>
           <indexterm zone="ch-system-systemd systemd-id128">
             <primary sortas="b-systemd-id128">systemd-id128</primary>
@@ -620 +598 @@
         <term><command>systemd-inhibit</command></term>
         <listitem>
-          <para>Used to execute a program with a shutdown, sleep or idle
-          inhibitor lock taken</para>
+          <para>Is used to execute a program with a shutdown, sleep or idle
+          inhibitor lock taken, preventing an action such as a system shutdown
+          until the process is completed.</para>
           <indexterm zone="ch-system-systemd systemd-inhibit">
             <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
@@ -631 +610 @@
         <term><command>systemd-machine-id-setup</command></term>
         <listitem>
-          <para>Used by system installer tools to initialize the machine ID
+          <para>Is used by system installer tools to initialize the machine ID
           stored in <filename>/etc/machine-id</filename> at install time with a
           randomly generated ID</para>
@@ -643 +622 @@
         <term><command>systemd-mount</command></term>
         <listitem>
-          <para>A tool to temporarily mount or auto-mount a drive.</para>
+          <para>Is used to temporarily mount or automount disks.</para>
           <indexterm zone="ch-system-systemd systemd-mount">
             <primary sortas="b-systemd-mount">systemd-mount</primary>
@@ -653 +632 @@
         <term><command>systemd-notify</command></term>
         <listitem>
-          <para>Used by daemon scripts to notify the init system about status
+          <para>Is used by daemon scripts to notify the init system about status
           changes</para>
           <indexterm zone="ch-system-systemd systemd-notify">
@@ -664 +643 @@
         <term><command>systemd-nspawn</command></term>
         <listitem>
-          <para>Used to run a command or OS in a light-weight namespace
+          <para>Is used to run a command or OS in a light-weight namespace
           container</para>
           <indexterm zone="ch-system-systemd systemd-nspawn">
@@ -675 +654 @@
         <term><command>systemd-path</command></term>
         <listitem>
-          <para>Used to query system and user paths</para>
+          <para>Is used to query system and user paths</para>
           <indexterm zone="ch-system-systemd systemd-path">
             <primary sortas="b-systemd-path">systemd-path</primary>
@@ -685 +664 @@
         <term><command>systemd-repart</command></term>
         <listitem>
-          <para>Used go grow and add partitions to a partition table when
+          <para>Is used to grow and add partitions to a partition table when
           systemd is used in an OS image (e.g. a container).</para>
           <indexterm zone="ch-system-systemd systemd-repart">
@@ -696 +675 @@
         <term><command>systemd-resolve</command></term>
         <listitem>
-          <para>Used to resolve domain names, IPV4 and IPv6 addresses, DNS
+          <para>Is used to resolve domain names, IPV4 and IPv6 addresses, DNS
           resource records, and services</para>
           <indexterm zone="ch-system-systemd systemd-resolve">
@@ -707 +686 @@
         <term><command>systemd-run</command></term>
         <listitem>
-          <para>Used to create and start a transient .service or a .scope unit
-          and run the specified command in it</para>
+          <para>Is used to create and start a transient .service or a .scope
+          unit and run the specified command in it. This is useful for
+          validating systemd units.</para>
           <indexterm zone="ch-system-systemd systemd-run">
             <primary sortas="b-systemd-run">systemd-run</primary>
@@ -715 +695 @@
       </varlistentry>
 
-      <!-- <varlistentry id="systemd-stdio-bridge">
-        <term><command>systemd-stdio-bridge</command></term>
-        <listitem>
-          <para>To be completed</para>
-          <indexterm zone="ch-system-systemd systemd-stdio-bridge">
-            <primary sortas="b-systemd-stdio-bridge">systemd-stdio-bridge</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry> -->
-
       <varlistentry id="systemd-socket-activate">
         <term><command>systemd-socket-activate</command></term>
         <listitem>
-          <para>A tool to listen on socket devices and launch a process upon
-          connection.</para>
+          <para>Is used to listen on socket devices and launch a process upon
+          a successful connection to the socket.</para>
           <indexterm zone="ch-system-systemd systemd-socket-activate">
             <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
@@ -752 +722 @@
         <term><command>systemd-umount</command></term>
         <listitem>
-          <para>Unmount mount points</para>
+          <para>Unmounts mount points</para>
           <indexterm zone="ch-system-systemd systemd-umount">
             <primary sortas="b-systemd-umount">systemd-umount</primary>
@@ -762 +732 @@
         <term><command>systemd-tty-ask-password-agent</command></term>
         <listitem>
-          <para>Used to list or process pending systemd password requests</para>
+          <para>Is used to list and/or process pending systemd password 
+          requests</para>
           <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
             <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
@@ -783 +754 @@
         <term><command>timedatectl</command></term>
         <listitem>
-          <para>Used to query and change the system clock and its settings
+          <para>Is used to query and change the system clock and its settings
           </para>
           <indexterm zone="ch-system-systemd timedatectl">
@@ -794 +765 @@
         <term><command>udevadm</command></term>
         <listitem>
-          <para>Generic udev administration tool: controls the udevd daemon,
-          provides info from the Udev database, monitors uevents, waits for
-          uevents to finish, tests udev configuration, and triggers uevents
-          for a given device</para>
+          <para>Is a generic udev administration tool which controls the udevd 
+          daemon, provides info from the Udev hardware database, monitors 
+          uevents, waits for uevents to finish, tests udev configuration, and 
+          triggers uevents for a given device</para>
           <indexterm zone="ch-system-systemd udevadm">
             <primary sortas="b-udevadm">udevadm</primary>
@@ -807 +778 @@
         <term><filename class="libraryfile">libsystemd</filename></term>
         <listitem>
-          <para>The main systemd utility library</para>
+          <para>Is the main systemd utility library</para>
           <indexterm zone="ch-system-systemd libsystemd">
             <primary sortas="c-libsystemd">libsystemd</primary>
@@ -817 +788 @@
         <term><filename class="libraryfile">libudev</filename></term>
         <listitem>
-          <para>A library to access Udev device information</para>
+          <para>Is a library to access Udev device information</para>
           <indexterm zone="ch-system-systemd libudev">
             <primary sortas="c-libudev">libudev</primary>