Changeset 37e35d2 for chapter08/systemd.xml

Timestamp:

06/29/2020 07:55:01 AM (4 years ago)

Author:

Thomas Trepl <thomas@…>

Branches:

multilib-10.1

Children:

c4804e8

Parents:

d4fdde6

Message:

Update to new lfs structure

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

File:

• chapter08/systemd.xml (moved) (moved from chapter06/systemd.xml ) (56 diffs)

chapter08/systemd.xml

@@ -32 +32 @@
 
       <seglistitem>
-        <seg>&systemd-ch6-sbu;</seg>
-        <seg>&systemd-ch6-du;</seg>
+        <seg>&systemd-fin-sbu;</seg>
+        <seg>&systemd-fin-du;</seg>
       </seglistitem>
     </segmentedlist>
@@ -40 +40 @@
   <sect2 role="installation">
     <title>Installation of systemd</title>
-<!--
-    <para>First, apply a patch to fix various bugs since the release
-    of systemd-243.</para>
-
-<screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-consolidated_fixes-2.patch</userinput></screen>
--->
-
-    <para>Create a symlink to work around missing xsltproc:</para>
-
-<screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen>
+
+    <para>First, apply a patch to fix the build with GCC-10 and fix a segfault:</para>
+
+<screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-gcc_10-fixes-2.patch</userinput></screen>
+
+    <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>
 
     <para>Set up the man pages:</para>
@@ -74 +72 @@
       --sysconfdir=/etc             \
       --localstatedir=/var          \
-      -Dc_args=-Wno-format-overflow \
       -Dblkid=true                  \
       -Dbuildtype=release           \
@@ -100 +97 @@
 
       <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
-          systemd at runtime that have not yet been installed, or who's
-          pkgconfig files are currently only in
-          <filename>/tools/lib/pkgconfig</filename>.</para>
+          <para>These switches provide the location of binaries needed by
+          systemd at runtime that have not yet been installed.</para>
         </listitem>
       </varlistentry>
@@ -157 +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>
@@ -203 +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>
 
@@ -235 +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>
 
-<!-- ====== 32-bit ===== -->
-
+  <!-- - - - - - - - - - -->
+  <!-- Multilib - 32bit  -->
+  <!-- - - - - - - - - - -->
+  
   <sect2 arch="ml_32,ml_all" role="installation">
     <title>Installation of systemd - 32-bit</title>
 
-    <para>If still in the build directory, step out:</para>
-<screen><userinput remap="pre">cd ..</userinput></screen>
-
     <para>Clean previous build:</para>
 
-<screen><userinput remap="pre">rm -rf build</userinput></screen>
+<screen><userinput remap="pre">rm -rf *</userinput></screen>
 
     <para>Create a symlink to work around missing xsltproc:</para>
 
-<screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen>
-
+<!-- screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen -->
+<screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
+
+<!-- with cross-LFS we have util-linux in place:
     <para>Because we have not yet installed the final version of Util-Linux,
     create links to the libraries in the approprite location:</para>
@@ -269 +243 @@
     ln -sf $file /usr/lib32/
 done</userinput></screen>
-
-    <para>Set up the man pages:</para>
-
-<screen><userinput remap="pre">tar -xf ../systemd-man-pages-&systemd-version;.tar.xz</userinput></screen>
+-->
 
     <para>Prepare systemd for compilation:</para>
 
-    <screen><userinput remap="configure">cd build
-PKG_CONFIG_PATH="/usr/lib32/pkgconfig:/tools/lib32/pkgconfig" \
+    <screen><userinput remap="configure">PKG_CONFIG_PATH="&usr-lib-m32;/pkgconfig" \
 CC="gcc -m32 -march=i686"              \
 CXX="g++ -m32 -march=i686"             \
@@ -294 +264 @@
       -Dmount-path=/bin/mount          \
       -Drootprefix=                    \
-      -Drootlibdir=/usr/lib32          \
+      -Drootlibdir=&usr-lib-m32;          \
       -Dsplit-usr=true                 \
       -Dsulogin-path=/sbin/sulogin     \
@@ -309 +279 @@
 
 <screen><userinput remap="install">LANG=en_US.UTF-8 DESTDIR=$PWD/DESTDIR ninja install
-cp -Rv DESTDIR/usr/lib32/* /usr/lib32
+cp -Rv DESTDIR&usr-lib-m32;/* &usr-lib-m32;
 rm -rf DESTDIR
 rm -f /usr/bin/xsltproc</userinput></screen>
 
-  </sect2>
-
-<!-- ====== x32-bit ===== -->
-
+  </sect2><!-- m32 -->
+
+  <!-- - - - - - - - - - -->
+  <!-- Multilib - x32bit -->
+  <!-- - - - - - - - - - -->
+  
   <sect2 arch="ml_x32,ml_all" role="installation">
     <title>Installation of systemd - x32-bit</title>
 
-    <para>If still in the build directory, step out:</para>
-<screen><userinput remap="pre">cd ..</userinput></screen>
-
     <para>Clean previous build:</para>
 
-<screen><userinput remap="pre">rm -rf build</userinput></screen>
+<screen><userinput remap="pre">rm -rf *</userinput></screen>
 
     <para>Create a symlink to work around missing xsltproc:</para>
 
-<screen><userinput remap="pre">ln -sf /tools/bin/true /usr/bin/xsltproc</userinput></screen>
-
-    <para>Because we have not yet installed the final version of Util-Linux,
-    create links to the libraries in the approprite location:</para>
-
-<screen><userinput remap="pre">for file in /tools/libx32/lib{blkid,mount,uuid}*; do
-    ln -sf $file /usr/libx32/
-done</userinput></screen>
-
-    <para>Set up the man pages:</para>
-
-<screen><userinput remap="pre">tar -xf ../systemd-man-pages-&systemd-version;.tar.xz</userinput></screen>
+<screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
 
     <para>Fix an issue on x32:</para>
@@ -349 +307 @@
     <para>Prepare systemd for compilation:</para>
 
-<screen><userinput remap="configure">cd build
-PKG_CONFIG_PATH="/tools/libx32/pkgconfig:/usr/libx32/pkgconfig" \
+<screen><userinput remap="configure">PKG_CONFIG_PATH="&usr-lib-mx32;/pkgconfig" \
 CC="gcc -mx32"                          \
 CXX="g++ -mx32"                         \
@@ -369 +326 @@
       -Dmount-path=/bin/mount           \
       -Drootprefix=                     \
-      -Drootlibdir=/usr/libx32          \
+      -Drootlibdir=&usr-lib-mx32;          \
       -Dsplit-usr=true                  \
       -Dsulogin-path=/sbin/sulogin      \
@@ -384 +341 @@
 
 <screen><userinput remap="install">LANG=en_US.UTF-8 DESTDIR=$PWD/DESTDIR ninja install
-cp -Rv DESTDIR/usr/libx32/* /usr/libx32
+cp -Rv DESTDIR&usr-lib-m32;/* &usr-lib-m32;
 rm -rf DESTDIR
 rm -f /usr/bin/xsltproc</userinput></screen>
 
-  </sect2>
+  </sect2><!-- mx32 -->
 
   <sect2 id="contents-systemd" role="content">
@@ -436 +393 @@
         <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>
@@ -446 +403 @@
         <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>
@@ -456 +413 @@
         <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>
@@ -480 +437 @@
         <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">
@@ -491 +448 @@
         <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>
@@ -503 +461 @@
         <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>
@@ -513 +471 @@
         <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>
@@ -524 +482 @@
         <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">
@@ -535 +493 @@
         <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">
@@ -546 +504 @@
         <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">
@@ -557 +515 @@
         <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>
@@ -568 +526 @@
         <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">
@@ -579 +537 @@
         <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">
@@ -590 +548 @@
         <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">
@@ -601 +559 @@
         <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">
@@ -612 +570 @@
         <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">
@@ -624 +582 @@
         <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">
@@ -635 +593 @@
         <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>
@@ -646 +604 @@
         <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">
@@ -657 +615 @@
         <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>
@@ -668 +626 @@
         <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">
@@ -679 +637 @@
         <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">
@@ -712 +671 @@
         <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>
@@ -724 +683 @@
         <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>
@@ -734 +694 @@
         <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">
@@ -745 +705 @@
         <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>
@@ -755 +715 @@
         <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>
@@ -765 +725 @@
         <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>
@@ -776 +737 @@
         <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>
@@ -788 +749 @@
         <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>
@@ -798 +759 @@
         <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">
@@ -809 +770 @@
         <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">
@@ -820 +781 @@
         <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>
@@ -830 +791 @@
         <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">
@@ -841 +802 @@
         <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">
@@ -852 +813 @@
         <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>
@@ -860 +822 @@
       </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>
@@ -897 +849 @@
         <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>
@@ -907 +859 @@
         <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>
@@ -928 +881 @@
         <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">
@@ -939 +892 @@
         <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>
@@ -952 +905 @@
         <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>
@@ -962 +915 @@
         <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>