diff options
Diffstat (limited to 'chapter06')
-rw-r--r-- | chapter06/acl.xml | 6 | ||||
-rw-r--r-- | chapter06/attr.xml | 5 | ||||
-rw-r--r-- | chapter06/autoconf.xml | 2 | ||||
-rw-r--r-- | chapter06/chapter06d.xml | 87 | ||||
-rw-r--r-- | chapter06/coreutils.xml | 8 | ||||
-rw-r--r-- | chapter06/createfiles.xml | 54 | ||||
-rw-r--r-- | chapter06/dbus.xml | 63 | ||||
-rw-r--r-- | chapter06/diffutils.xml | 2 | ||||
-rw-r--r-- | chapter06/e2fsprogs.xml | 13 | ||||
-rw-r--r-- | chapter06/findutils.xml | 15 | ||||
-rw-r--r-- | chapter06/glibc.xml | 48 | ||||
-rw-r--r-- | chapter06/gmp.xml | 2 | ||||
-rw-r--r-- | chapter06/m4.xml | 2 | ||||
-rw-r--r-- | chapter06/man-db.xml | 4 | ||||
-rw-r--r-- | chapter06/mpfr.xml | 5 | ||||
-rw-r--r-- | chapter06/ncurses.xml | 6 | ||||
-rw-r--r-- | chapter06/pkgmgt.xml | 24 | ||||
-rw-r--r-- | chapter06/procps.xml | 10 | ||||
-rw-r--r-- | chapter06/readline.xml | 2 | ||||
-rw-r--r-- | chapter06/systemd.xml | 379 | ||||
-rw-r--r-- | chapter06/util-linux.xml | 14 |
21 files changed, 501 insertions, 250 deletions
diff --git a/chapter06/acl.xml b/chapter06/acl.xml index 9dbc1b2a8..7d448c121 100644 --- a/chapter06/acl.xml +++ b/chapter06/acl.xml @@ -59,11 +59,15 @@ <para>Prepare Acl for compilation:</para> -<screen><userinput remap="configure">./configure --prefix=/usr \ +<screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr \ --bindir=/bin \ --disable-static \ --libexecdir=/usr/lib</userinput></screen> +<screen revision="systemd"><userinput remap="configure">./configure --prefix=/usr \ + --disable-static \ + --libexecdir=/usr/lib</userinput></screen> + <para>Compile the package:</para> <screen><userinput remap="make">make</userinput></screen> diff --git a/chapter06/attr.xml b/chapter06/attr.xml index 03044a745..65d509f9a 100644 --- a/chapter06/attr.xml +++ b/chapter06/attr.xml @@ -53,10 +53,13 @@ <para>Prepare Attr for compilation:</para> -<screen><userinput remap="configure">./configure --prefix=/usr \ +<screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr \ --bindir=/bin \ --disable-static</userinput></screen> +<screen revision="systemd"><userinput remap="configure">./configure --prefix=/usr \ + --disable-static</userinput></screen> + <para>Compile the package:</para> <screen><userinput remap="make">make</userinput></screen> diff --git a/chapter06/autoconf.xml b/chapter06/autoconf.xml index 519811692..bf3d9ac9a 100644 --- a/chapter06/autoconf.xml +++ b/chapter06/autoconf.xml @@ -56,7 +56,7 @@ <para>This takes a long time, about &autoconf-ch6-sbu-tests; SBUs. In addition, several tests are skipped that use Automake. For full test coverage, Autoconf can be re-tested after Automake has been installed. In addition, - two fail due to changes in libtool-2.4.3 and later.</para> + two tests fail due to changes in libtool-2.4.3 and later.</para> <para>Install the package:</para> diff --git a/chapter06/chapter06d.xml b/chapter06/chapter06d.xml new file mode 100644 index 000000000..d08135f7e --- /dev/null +++ b/chapter06/chapter06d.xml @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ + <!ENTITY % general-entities SYSTEM "../general.ent"> + %general-entities; +]> + +<chapter id="chapter-building-system" xreflabel="Chapter 6"> + <?dbhtml dir="chapter06"?> + <?dbhtml filename="chapter06.html"?> + + <title>Installing Basic System Software</title> + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="kernfs.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pkgmgt.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="chroot.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="creatingdirs.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="createfiles.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="linux-headers.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="man-pages.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glibc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="adjusting.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="zlib.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="file.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="binutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gmp.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mpfr.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mpc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bzip2.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pkgconfig.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ncurses.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="attr.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acl.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libcap.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sed.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="shadow.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="psmisc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iana-etc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="m4.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bison.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="flex.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="grep.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="readline.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bash.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bc.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libtool.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gdbm.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gperf.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="expat.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="inetutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="xml-parser.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="intltool.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="autoconf.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="automake.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="xz.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="kmod.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gettext.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="systemd.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="procps.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="e2fsprogs.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="coreutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="diffutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gawk.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="findutils.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="groff.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="grub.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="less.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gzip.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iproute2.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="kbd.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libpipeline.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="make.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="patch.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dbus.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="util-linux.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="man-db.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tar.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="texinfo.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="vim.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="aboutdebug.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="strippingagain.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="revisedchroot.xml"/> + +</chapter> diff --git a/chapter06/coreutils.xml b/chapter06/coreutils.xml index d40e4f716..18cfe5063 100644 --- a/chapter06/coreutils.xml +++ b/chapter06/coreutils.xml @@ -137,12 +137,16 @@ mv -v /usr/bin/chroot /usr/sbin mv -v /usr/share/man/man1/chroot.1 /usr/share/man/man8/chroot.8 sed -i s/\"1\"/\"8\"/1 /usr/share/man/man8/chroot.8</userinput></screen> - <para>Some of the scripts in the LFS-Bootscripts package depend on - <command>head</command>, <command>sleep</command>, and + <para revision="sysv">Some of the scripts in the LFS-Bootscripts package + depend on <command>head</command>, <command>sleep</command>, and <command>nice</command>. As <filename class="directory">/usr</filename> may not be available during the early stages of booting, those binaries need to be on the root partition:</para> + <para revision="systemd">Some packages in BLFS and beyond expect the + following programs in <filename class="directory">/bin</filename>, so make + sure they are placed there:</para> + <screen><userinput remap="install">mv -v /usr/bin/{head,sleep,nice,test,[} /bin</userinput></screen> </sect2> diff --git a/chapter06/createfiles.xml b/chapter06/createfiles.xml index 842336ab2..4c88468c3 100644 --- a/chapter06/createfiles.xml +++ b/chapter06/createfiles.xml @@ -146,7 +146,7 @@ ln -sv bash /bin/sh</userinput></screen> <para>Create the <filename>/etc/passwd</filename> file by running the following command:</para> -<screen><userinput>cat > /etc/passwd << "EOF" +<screen revision="sysv"><userinput>cat > /etc/passwd << "EOF" <literal>root:x:0:0:root:/root:/bin/bash bin:x:1:1:bin:/dev/null:/bin/false daemon:x:6:6:Daemon User:/dev/null:/bin/false @@ -154,13 +154,55 @@ messagebus:x:18:18:D-Bus Message Daemon User:/var/run/dbus:/bin/false nobody:x:99:99:Unprivileged User:/dev/null:/bin/false</literal> EOF</userinput></screen> +<screen revision="systmed"><userinput>cat > /etc/passwd << "EOF" +<literal>root:x:0:0:root:/root:/bin/bash +bin:x:1:1:bin:/dev/null:/bin/false +daemon:x:6:6:Daemon User:/dev/null:/bin/false +messagebus:x:18:18:D-Bus Message Daemon User:/var/run/dbus:/bin/false +systemd-bus-proxy:x:72:72:systemd Bus Proxy:/:/bin/false +systemd-journal-gateway:x:73:73:systemd Journal Gateway:/:/bin/false +systemd-journal-remote:x:74:74:systemd Journal Remote:/:/bin/false +systemd-journal-upload:x:75:75:systemd Journal Upload:/:/bin/false +systemd-network:x:76:76:systemd Network Management:/:/bin/false +systemd-resolve:x:77:77:systemd Resolver:/:/bin/false +systemd-timesync:x:78:78:systemd Time Synchronization:/:/bin/false +systemd-coredump:x:79:79:systemd Core Dumper:/:/bin/false +nobody:x:99:99:Unprivileged User:/dev/null:/bin/false</literal> +EOF</userinput></screen> + <para>The actual password for <systemitem class="username">root</systemitem> (the <quote>x</quote> used here is just a placeholder) will be set later.</para> <para>Create the <filename>/etc/group</filename> file by running the following command:</para> -<screen><userinput>cat > /etc/group << "EOF" +<screen revision="sysv"><userinput>cat > /etc/group << "EOF" +<literal>root:x:0: +bin:x:1:daemon +sys:x:2: +kmem:x:3: +tape:x:4: +tty:x:5: +daemon:x:6: +floppy:x:7: +disk:x:8: +lp:x:9: +dialout:x:10: +audio:x:11: +video:x:12: +utmp:x:13: +usb:x:14: +cdrom:x:15: +adm:x:16: +messagebus:x:18: +systemd-journal:x:23: +input:x:24: +mail:x:34: +nogroup:x:99: +users:x:999:</literal> +EOF</userinput></screen> + +<screen revision="systemd"><userinput>cat > /etc/group << "EOF" <literal>root:x:0: bin:x:1:daemon sys:x:2: @@ -182,6 +224,14 @@ messagebus:x:18: systemd-journal:x:23: input:x:24: mail:x:34: +systemd-bus-proxy:x:72: +systemd-journal-gateway:x:73: +systemd-journal-remote:x:74: +systemd-journal-upload:x:75: +systemd-network:x:76: +systemd-resolve:x:77: +systemd-timesync:x:78: +systemd-coredump:x:79: nogroup:x:99: users:x:999:</literal> EOF</userinput></screen> diff --git a/chapter06/dbus.xml b/chapter06/dbus.xml index 46f0439e4..ee5390137 100644 --- a/chapter06/dbus.xml +++ b/chapter06/dbus.xml @@ -48,11 +48,14 @@ <para>Prepare D-Bus for compilation:</para> -<screen><userinput remap="configure">./configure --prefix=/usr \ - --sysconfdir=/etc \ - --localstatedir=/var \ - --docdir=/usr/share/doc/dbus-&dbus-version; \ - --with-console-auth-dir=/run/console</userinput></screen> +<screen><userinput remap="configure"> ./configure --prefix=/usr \ + --sysconfdir=/etc \ + --localstatedir=/var \ + --disable-static \ + --disable-doxygen-docs \ + --disable-xml-docs \ + --docdir=/usr/share/doc/dbus-&dbus-version; \ + --with-console-auth-dir=/run/console</userinput></screen> <variablelist> <title>The meaning of the configure options:</title> @@ -74,7 +77,7 @@ <para>This package does come with a test suite, but it requires several packages that are not included in LFS. Instructions for running the test suite can be found in the BLFS book at - <ulink url="&blfs-root;/view/&short-version;/general/dbus.html"/>.</para> + <ulink url="&blfs-book;general/dbus.html"/>.</para> <para>Install the package:</para> @@ -88,15 +91,10 @@ <screen><userinput remap="install">mv -v /usr/lib/libdbus-1.so.* /lib 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> -<screen><userinput remap="install">ln -sv /etc/machine-id /var/lib/dbus</userinput></screen> - - <para>Finally, generate a D-Bus UUID to avoid possible warnings - when building some packages in BLFS:</para> - -<screen><userinput remap="install">dbus-uuidgen --ensure</userinput></screen> +<screen><userinput remap="install">ln -sfv /etc/machine-id /var/lib/dbus</userinput></screen> </sect2> @@ -110,11 +108,11 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <seglistitem> <seg>dbus-cleanup-sockets, dbus-daemon, dbus-launch, dbus-monitor, - dbus-send, and dbus-uuidgen</seg> + dbus-run-session, dbus-send, and dbus-uuidgen</seg> <seg>libdbus-1.{a,so}</seg> <seg>/etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0, /usr/share/dbus-1, /usr/share/doc/dbus-&dbus-version;, - /var/lib/dbus</seg> + and /var/lib/dbus</seg> </seglistitem> </segmentedlist> @@ -126,7 +124,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-cleanup-sockets"> <term><command>dbus-cleanup-sockets</command></term> <listitem> - <para>Used to clean up leftover sockets in a directory.</para> + <para>Used to clean up leftover sockets in a directory</para> <indexterm zone="ch-system-dbus dbus-cleanup-sockets"> <primary sortas="b-dbus-cleanup-sockets">dbus-cleanup-sockets</primary> </indexterm> @@ -136,7 +134,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-daemon"> <term><command>dbus-daemon</command></term> <listitem> - <para>The D-Bus message bus daemon.</para> + <para>The D-Bus message bus daemon</para> <indexterm zone="ch-system-dbus dbus-daemon"> <primary sortas="b-dbus-daemon">dbus-daemon</primary> </indexterm> @@ -147,7 +145,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <term><command>dbus-launch</command></term> <listitem> <para>Starts <command>dbus-daemon</command> from a shell - script.</para> + script</para> <indexterm zone="ch-system-dbus dbus-launch"> <primary sortas="b-dbus-launch">dbus-launch</primary> </indexterm> @@ -157,17 +155,29 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-monitor"> <term><command>dbus-monitor</command></term> <listitem> - <para>Monitors messages passing through a D-Bus message bus.</para> + <para>Monitors messages passing through a D-Bus message bus</para> <indexterm zone="ch-system-dbus dbus-monitor"> <primary sortas="b-dbus-monitor">dbus-monitor</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="dbus-run-session"> + <term><command>dbus-run-session</command></term> + <listitem> + <para>Starts a session bus instance of <command>dbus-daemon</command> + from a shell script and starts a specified program in that + session</para> + <indexterm zone="ch-system-dbus dbus-run-session"> + <primary sortas="b-dbus-run-session">dbus-run-session</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="dbus-send"> <term><command>dbus-send</command></term> <listitem> - <para>Sends a message to a D-Bus message bus.</para> + <para>Sends a message to a D-Bus message bus</para> <indexterm zone="ch-system-dbus dbus-send"> <primary sortas="b-dbus-send">dbus-send</primary> </indexterm> @@ -177,13 +187,24 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-uuidgen"> <term><command>dbus-uuidgen</command></term> <listitem> - <para>Generates a universally unique ID.</para> + <para>Generates a universally unique ID</para> <indexterm zone="ch-system-dbus dbus-uuidgen"> <primary sortas="b-dbus-uuidgen">dbus-uuidgen</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="libdbus-1"> + <term><filename class="libraryfile">libdbus-1</filename></term> + <listitem> + <para>Contains API functions used to communicate with the D-Bus + message bus</para> + <indexterm zone="ch-system-dbus libdbus-1"> + <primary sortas="c-libdbus-1">libdbus-1</primary> + </indexterm> + </listitem> + </varlistentry> + </variablelist> </sect2> diff --git a/chapter06/diffutils.xml b/chapter06/diffutils.xml index 782f2eb03..89bd81be7 100644 --- a/chapter06/diffutils.xml +++ b/chapter06/diffutils.xml @@ -57,7 +57,7 @@ <screen><userinput remap="test">make check</userinput></screen> - <para>The test-update-copyright.sh failure can be ignored.</para> + <para>The test-update-copyright.sh failure can be safely ignored.</para> <para>Install the package:</para> diff --git a/chapter06/e2fsprogs.xml b/chapter06/e2fsprogs.xml index 5927b3eb0..e7f7cf39b 100644 --- a/chapter06/e2fsprogs.xml +++ b/chapter06/e2fsprogs.xml @@ -521,18 +521,7 @@ install-info --dir-file=/usr/share/info/dir /usr/share/info/com_err.info</userin </indexterm> </listitem> </varlistentry> -<!-- - <varlistentry id="libquota"> - <term><filename class="libraryfile">libquota</filename></term> - <listitem> - <para>Provides an interface for creating and updating quota files - and ext4 superblock fields</para> - <indexterm zone="ch-system-e2fsprogs libquota"> - <primary sortas="c-libquota">libquota</primary> - </indexterm> - </listitem> - </varlistentry> ---> + <varlistentry id="libss"> <term><filename class="libraryfile">libss</filename></term> <listitem> diff --git a/chapter06/findutils.xml b/chapter06/findutils.xml index 8c6d77a2b..8eb46d515 100644 --- a/chapter06/findutils.xml +++ b/chapter06/findutils.xml @@ -73,11 +73,16 @@ <screen><userinput remap="install">make install</userinput></screen> - <para>Some of the scripts in the LFS-Bootscripts package depend on - <command>find</command>. As <filename class="directory">/usr</filename> - may not be available during the early stages of booting, this program - needs to be on the root partition. The <command>updatedb</command> - script also needs to be modified to correct an explicit path:</para> + <para revision="sysv">Some of the scripts in the LFS-Bootscripts package + depend on <command>find</command>. As <filename + class="directory">/usr</filename> may not be available during the early + stages of booting, this program needs to be on the root partition. The + <command>updatedb</command> script also needs to be modified to correct an + explicit path:</para> + + <para revision="systemd"> Some packages in BLFS and beyond expect the + <command>find</command> program in <filename + class="directory">/bin</filename>, so make sure it's placed there:</para> <screen><userinput remap="install">mv -v /usr/bin/find /bin sed -i 's|find:=${BINDIR}|find:=/bin|' /usr/bin/updatedb</userinput></screen> diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml index e577e229a..02abb3dad 100644 --- a/chapter06/glibc.xml +++ b/chapter06/glibc.xml @@ -153,6 +153,12 @@ cd build</userinput></screen> <screen><userinput remap="install">cp -v ../nscd/nscd.conf /etc/nscd.conf mkdir -pv /var/cache/nscd</userinput></screen> + <para revision="systemd">Install the systemd support files for + <command>nscd</command>:</para> + + <screen revision="systemd"><userinput remap="install">install -v -Dm644 ../nscd/nscd.tmpfiles /usr/lib/tmpfiles.d/nscd.conf +install -v -Dm644 ../nscd/nscd.service /lib/systemd/system/nscd.service</userinput></screen> + <para>Next, install the locales that can make the system respond in a different language. None of the locales are required, but if some of them are missing, the test suites of future packages would skip important @@ -326,7 +332,9 @@ unset ZONEINFO</userinput></screen> <para>Then create the <filename>/etc/localtime</filename> file by running:</para> -<screen><userinput>cp -v /usr/share/zoneinfo/<replaceable><xxx></replaceable> /etc/localtime</userinput></screen> +<screen revision="sysv"><userinput>cp -v /usr/share/zoneinfo/<replaceable><xxx></replaceable> /etc/localtime</userinput></screen> + +<screen revision="systemd"><userinput>ln -sfv /usr/share/zoneinfo/<replaceable><xxx></replaceable> /etc/localtime</userinput></screen> <para>Replace <replaceable><xxx></replaceable> with the name of the time zone selected (e.g., Canada/Eastern).</para> @@ -562,17 +570,7 @@ mkdir -pv /etc/ld.so.conf.d</userinput></screen> </indexterm> </listitem> </varlistentry> -<!-- - <varlistentry id="pcprofiledump"> - <term><command>pcprofiledump</command></term> - <listitem> - <para>Dumps information generated by PC profiling</para> - <indexterm zone="ch-system-glibc pcprofiledump"> - <primary sortas="b-pcprofiledump">pcprofiledump</primary> - </indexterm> - </listitem> - </varlistentry> ---> + <varlistentry id="pldd"> <term><command>pldd</command></term> <listitem> @@ -582,18 +580,7 @@ mkdir -pv /etc/ld.so.conf.d</userinput></screen> </indexterm> </listitem> </varlistentry> -<!-- - <varlistentry id="pt_chown"> - <term><command>pt_chown</command></term> - <listitem> - <para>A helper program for <command>grantpt</command> to set the owner, - group and access permissions of a slave pseudo terminal</para> - <indexterm zone="ch-system-glibc pt_chown"> - <primary sortas="b-pt_chown">pt_chown</primary> - </indexterm> - </listitem> - </varlistentry> ---> + <varlistentry id="rpcgen"> <term><command>rpcgen</command></term> <listitem> @@ -837,18 +824,7 @@ mkdir -pv /etc/ld.so.conf.d</userinput></screen> </indexterm> </listitem> </varlistentry> -<!-- - <varlistentry id="libpcprofile"> - <term><filename class="libraryfile">libpcprofile</filename></term> - <listitem> - <para>Contains profiling functions used to track the amount of CPU - time spent in specific source code lines</para> - <indexterm zone="ch-system-glibc libpcprofile"> - <primary sortas="c-libpcprofile">libpcprofile</primary> - </indexterm> - </listitem> - </varlistentry> ---> + <varlistentry id="libpthread"> <term><filename class="libraryfile">libpthread</filename></term> <listitem> diff --git a/chapter06/gmp.xml b/chapter06/gmp.xml index da655db6a..2950b6715 100644 --- a/chapter06/gmp.xml +++ b/chapter06/gmp.xml @@ -92,7 +92,7 @@ make html</userinput></screen> <screen><userinput remap="test">make check 2>&1 | tee gmp-check-log</userinput></screen> <caution><para>The code in gmp is highly optimized for the processor where - it is built. Occasionally the code that detects the processor misidentifies + it is built. Occasionally, the code that detects the processor misidentifies the system capabilities and there will be errors in the tests or other applications using the gmp libraries with the message "Illegal instruction". In this case, gmp should be reconfigured with the option diff --git a/chapter06/m4.xml b/chapter06/m4.xml index 29c6e8c49..804173a8f 100644 --- a/chapter06/m4.xml +++ b/chapter06/m4.xml @@ -52,7 +52,7 @@ <screen><userinput remap="test">make check</userinput></screen> - <para>The test-update-copyright.sh failure can be ignored.</para> + <para>The test-update-copyright.sh failure can safely be ignored.</para> <para>Install the package:</para> diff --git a/chapter06/man-db.xml b/chapter06/man-db.xml index 364074867..4e81cc998 100644 --- a/chapter06/man-db.xml +++ b/chapter06/man-db.xml @@ -91,6 +91,10 @@ <screen><userinput remap="install">make install</userinput></screen> + <para>Remove a reference to a non-existent user:</para> + +<screen><userinput remap="install">sed -i "s:man root:root root:g" /usr/lib/tmpfiles.d/man-db.conf</userinput></screen> + </sect2> <sect2> diff --git a/chapter06/mpfr.xml b/chapter06/mpfr.xml index b43c3d9aa..ff8e323b7 100644 --- a/chapter06/mpfr.xml +++ b/chapter06/mpfr.xml @@ -40,12 +40,7 @@ <sect2 role="installation"> <title>Installation of MPFR</title> -<!-- - <para>First, apply the following patch to fix various bugs that have been - addressed upstream:</para> -<screen><userinput remap="pre">patch -Np1 -i ../&mpfr-upstream-patch;</userinput></screen> ---> <para>Prepare MPFR for compilation:</para> <screen><userinput remap="configure">./configure --prefix=/usr \ diff --git a/chapter06/ncurses.xml b/chapter06/ncurses.xml index a78d573b2..b37f1f69c 100644 --- a/chapter06/ncurses.xml +++ b/chapter06/ncurses.xml @@ -142,9 +142,9 @@ cp -v -R doc/* /usr/share/doc/ncurses-&ncurses-version;</userinput></screen> <para>The instructions above don't create non-wide-character Ncurses libraries since no package installed by compiling from sources would link - against them at runtime. Currently, the only known binary-only - applications that link against non-wide-character Ncurses require version - 5. If you must have such libraries because of some binary-only + against them at runtime. However, the only known binary-only + applications that link against non-wide-character Ncurses libraries + require version 5. If you must have such libraries because of some binary-only application or to be compliant with LSB, build the package again with the following commands:</para> diff --git a/chapter06/pkgmgt.xml b/chapter06/pkgmgt.xml index a451f2162..d004e1e7c 100644 --- a/chapter06/pkgmgt.xml +++ b/chapter06/pkgmgt.xml @@ -260,21 +260,27 @@ make DESTDIR=/usr/pkg/libfoo/1.1 install</userinput></screen> <filename>/etc/fstab</filename>, <filename>/etc/passwd</filename>, <filename>/etc/group</filename>, - <filename>/etc/shadow</filename>, - <filename>/etc/ld.so.conf</filename>, - <filename>/etc/sysconfig/rc.site</filename>, - <filename>/etc/sysconfig/network</filename>, and - <filename>/etc/sysconfig/ifconfig.eth0</filename>. + <phrase revision="systemd"> + <filename>/etc/shadow</filename>, and + <filename>/etc/ld.so.conf</filename>. + </phrase> + <phrase revision="sysv"> + <filename>/etc/shadow</filename>, + <filename>/etc/ld.so.conf</filename>, + <filename>/etc/sysconfig/rc.site</filename>, + <filename>/etc/sysconfig/network</filename>, and + <filename>/etc/sysconfig/ifconfig.eth0</filename>. + </phrase> </para> <para>A custom kernel may need to be built for the new system depending on differences in system hardware and the original kernel configuration.</para> - <note><para>There have been some reports of issues when copying between - similar but not identical architectures. For instance the instruction set - for Intel architectures is not identical with AMD processors and later - versions of some processors may have instructions not available in + <note><para>There have been some reports of issues when copying between + similar but not identical architectures. For instance, the instruction set + for an Intel system is not identical with an AMD processor and later + versions of some processors may have instructions that are unavailable in earlier versions.</para></note> <para>Finally the new system has to be made bootable via <xref diff --git a/chapter06/procps.xml b/chapter06/procps.xml index 71c0e0b04..e4b1909fc 100644 --- a/chapter06/procps.xml +++ b/chapter06/procps.xml @@ -42,13 +42,21 @@ <para>Now prepare procps-ng for compilation:</para> -<screen><userinput remap="configure">./configure --prefix=/usr \ +<screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr \ --exec-prefix= \ --libdir=/usr/lib \ --docdir=/usr/share/doc/procps-ng-&procps-ng-version; \ --disable-static \ --disable-kill</userinput></screen> +<screen revision="systemd"><userinput remap="configure">./configure --prefix=/usr \ + --exec-prefix= \ + --libdir=/usr/lib \ + --docdir=/usr/share/doc/procps-ng-&procps-ng-version; \ + --disable-static \ + --disable-kill \ + --with-systemd</userinput></screen> + <variablelist> <title>The meaning of the configure options:</title> diff --git a/chapter06/readline.xml b/chapter06/readline.xml index 8ec5cddf1..3b162d5ea 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -106,7 +106,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libhistory.so ) /usr/lib/libhistory.so</us <seglistitem> <seg>libhistory.so and libreadline.so</seg> - <seg>/usr/include/readline and + <seg>/usr/include/readline, /usr/share/readline, and /usr/share/doc/readline-&readline-version;</seg> </seglistitem> </segmentedlist> diff --git a/chapter06/systemd.xml b/chapter06/systemd.xml index 107500f8f..bbfac9c61 100644 --- a/chapter06/systemd.xml +++ b/chapter06/systemd.xml @@ -17,13 +17,13 @@ <title>Systemd-&systemd-version;</title> <indexterm zone="ch-system-systemd"> - <primary sortas="a-Systemd">Systemd</primary> + <primary sortas="a-systemd">systemd</primary> </indexterm> <sect2 role="package"> <title/> - <para>The Systemd package contains programs for controlling the startup, + <para>The systemd package contains programs for controlling the startup, running, and shutdown of the system.</para> <segmentedlist> @@ -38,51 +38,67 @@ </sect2> <sect2 role="installation"> - <title>Installation of Systemd</title> + <title>Installation of systemd</title> - <note><para>If systemd is not desired at all, it can be skipped. However a - udev replacement must be installed. See the hint at <ulink - url="http://www.linuxfromscratch.org/hints/downloads/files/eudev-alt-hint.txt"/> - to find procedures to install - <application>eudev</application>.</para></note> + <para>First, fix a build error when using Util-Linux built in + Chapter 5:</para> + +<screen><userinput remap="pre">sed -i "s:blkid/::" $(grep -rl "blkid/blkid.h")</userinput></screen> + + <para>Apply the following patch so that compat + <command>pkg-config</command> files get installed without installing compat + libs which are useless on LFS:</para> + +<screen><userinput remap="pre">patch -Np1 -i ../&systemd-compat-patch;</userinput></screen> + + <para>Disable two tests that always fail:</para> + +<screen><userinput remap="pre">sed -e 's@test/udev-test.pl @@' \ + -e 's@test-copy$(EXEEXT) @@' \ + -i Makefile.in</userinput></screen> + + <para>Rebuild generated files after modifying Makefile.am and + Makefile.in:</para> - <para>First, create a file to allow Systemd to build when using Util-Linux - built in Chapter 5:</para> +<screen><userinput remap="pre">autoreconf -fi</userinput></screen> + + <para>Create a file to allow systemd to build when using Util-Linux + built in Chapter 5, to disable LTO by default, and to build without + xlstproc:</para> <screen><userinput remap="pre">cat > config.cache << "EOF" <literal>KILL=/bin/kill +MOUNT_PATH=/bin/mount +UMOUNT_PATH=/bin/umount HAVE_BLKID=1 BLKID_LIBS="-lblkid" BLKID_CFLAGS="-I/tools/include/blkid" -cc_cv_CFLAGS__flto=no</literal> +HAVE_LIBMOUNT=1 +MOUNT_LIBS="-lmount" +MOUNT_CFLAGS="-I/tools/include/libmount" +cc_cv_CFLAGS__flto=no +XSLTPROC="/usr/bin/xsltproc"</literal> EOF</userinput></screen> - <para>Additionally, fix a build error when using Util-Linux built in - Chapter 5:</para> - -<screen><userinput remap="pre">sed -i "s:blkid/::" $(grep -rl "blkid/blkid.h")</userinput></screen> - - <para>Apply a patch so that compat <command>pkg-config</command> files get - installed without installing compat libs which are useless on LFS:</para> - -<screen><userinput remap="pre">patch -Np1 -i ../&systemd-compat-patch;</userinput></screen> - - <para>Prepare Systemd for compilation:</para> - -<screen><userinput remap="configure">./configure --prefix=/usr \ - --sysconfdir=/etc \ - --localstatedir=/var \ - --config-cache \ - --with-rootprefix= \ - --with-rootlibdir=/lib \ - --enable-split-usr \ - --disable-gudev \ - --without-python \ - --docdir=/usr/share/doc/systemd-&systemd-version; \ - --with-dbuspolicydir=/etc/dbus-1/system.d \ - --with-dbusinterfacedir=/usr/share/dbus-1/interfaces \ - --with-dbussessionservicedir=/usr/share/dbus-1/services \ - --with-dbussystemservicedir=/usr/share/dbus-1/system-services</userinput></screen> + <para>LTO is disabled by default because it causes + <command>systemd</command> and other auxiliary programs to link to + <filename class="libraryfile">libgcc_s.so</filename>, slows the build down + and makes the compiled code larger.</para> + + <para>Prepare systemd for compilation:</para> + +<screen><userinput remap="configure">./configure --prefix=/usr \ + --sysconfdir=/etc \ + --localstatedir=/var \ + --config-cache \ + --with-rootprefix= \ + --with-rootlibdir=/lib \ + --enable-split-usr \ + --disable-firstboot \ + --disable-ldconfig \ + --disable-sysusers \ + --without-python \ + --docdir=/usr/share/doc/systemd-&systemd-version;</userinput></screen> <variablelist> <title>The meaning of the configure options:</title> @@ -108,25 +124,50 @@ EOF</userinput></screen> <varlistentry> <term><parameter>--enable-split-usr</parameter></term> <listitem> - <para>This switch ensures that Systemd will work on + <para>This switch ensures that systemd will work on systems where /bin, /lib and /sbin directories are not symlinks to their /usr counterparts.</para> </listitem> </varlistentry> <varlistentry> - <term><parameter>--disable-gudev --without-python</parameter></term> + <term><parameter>--without-python</parameter></term> <listitem> - <para>These switches disable optional features because - LFS does not provide their dependencies.</para> + <para>This switch prevents <command>configure</command> + from trying to use Python which isn't built + in LFS.</para> </listitem> </varlistentry> <varlistentry> - <term><parameter>--with-dbus*</parameter></term> + <term><parameter>--disable-firstboot</parameter></term> <listitem> - <para>These switches ensure that D-Bus configuratil files - get installed in the correct locations.</para> + <para>This switch prevents installation of systemd + services responsible for setting up the system for + the first time. They are not useful for LFS because + everything is done manually.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--disable-ldconfig</parameter></term> + <listitem> + <para>This switch prevents installation of a systemd + unit that runs <command>ldconfig</command> at + boot, making the boot time longer. Remove it if the + described feature is desired, even though it's not + useful for source distributions such as LFS.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><parameter>--disable-sysusers</parameter></term> + <listitem> + <para>This switch prevents installation of systemd + services responsible for setting up the + <filename>/etc/group</filename> and + <filename>/etc/passwd</filename> files. Both files + were created early in this chapter.</para> </listitem> </varlistentry> @@ -136,64 +177,52 @@ EOF</userinput></screen> <screen><userinput remap="make">make LIBRARY_PATH=/tools/lib</userinput></screen> - <para>First prevent few broken test cases from running:</para> - -<screen><userinput remap="test">sed -e "s:test/udev-test.pl::g" \ - -e "s:test-bus-cleanup\$(EXEEXT) ::g" \ - -e "s:test-bus-gvariant\$(EXEEXT) ::g" \ - -i Makefile</userinput></screen> - - <para>To test the results, issue:</para> - -<screen><userinput remap="test">make -k check</userinput></screen> - - <para>Note that some tests might fail because the test are being run in a - chroot environment. For full test coverage, the test suite should be run - from a system booted using Systemd.</para> + <para>This package has a test suite, but it can only be run after the + package has been installed.</para> <para>Install the package:</para> <screen><userinput remap="install">make LD_LIBRARY_PATH=/tools/lib install</userinput></screen> - <para>Move NSS myhostname library to <filename - class="directory">/lib</filename>:</para> + <para>Move NSS libraries to <filename class="directory">/lib</filename>:</para> -<screen><userinput remap="install">mv -v /usr/lib/libnss_myhostname.so.2 /lib</userinput></screen> +<screen><userinput remap="install">mv -v /usr/lib/libnss_{myhostname,mymachines,resolve}.so.2 /lib</userinput></screen> <para>Remove an unnecessary directory:</para> <screen><userinput remap="install">rm -rfv /usr/lib/rpm</userinput></screen> - <para>Create the Sysvinit compatibility symlinks, and move some man pages - and a library that conflict with <xref linkend="ch-system-sysvinit"/> so - both systems can be installed side-by-side:</para> + <para>Create the Sysvinit compatibility symlinks, so systemd is used + as the default init system:</para> <screen><userinput remap="install">for tool in runlevel reboot shutdown poweroff halt telinit; do - ln -sfv ../bin/systemctl /sbin/${tool}-systemd - mv -v /usr/share/man/man8/${tool}.8 /usr/share/man/man8/${tool}-systemd.8 + ln -sfv ../bin/systemctl /sbin/${tool} done +ln -sfv ../lib/systemd/systemd /sbin/init</userinput></screen> -ln -sfv ../lib/systemd/systemd /sbin/init-systemd -mv -v /etc/init.d /etc/init.d-systemd</userinput></screen> - +<!-- <para>Remove a reference to a non-existent group:</para> <screen><userinput remap="install">sed -i "s:0775 root lock:0755 root root:g" /usr/lib/tmpfiles.d/legacy.conf</userinput></screen> +--> <para>Create the <filename>/etc/machine-id</filename> file needed by - Journald:</para> + <command>systemd-journald</command>:</para> <screen><userinput remap="install">systemd-machine-id-setup</userinput></screen> - <para>Finally install some LFS specific udev rules:</para> + <para>Since the testsuite largely depends on the host system kernel + configuration, some tests may fail. It also needs a modification in + order not to look for a program that will be installed by Util-Linux + package later in this chapter. To test the results, issue:</para> -<screen><userinput remap="install">tar -xf ../&udev-lfs-version;.tar.bz2 -make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> +<screen><userinput remap="test">sed -i "s:minix:ext4:g" src/test/test-path-util.c +make LD_LIBRARY_PATH=/tools/lib -k check</userinput></screen> </sect2> <sect2 id="contents-systemd" role="content"> - <title>Contents of Systemd</title> + <title>Contents of systemd</title> <segmentedlist> <segtitle>Installed programs</segtitle> @@ -201,22 +230,24 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <segtitle>Installed directories</segtitle> <seglistitem> - <seg>bootctl, busctl, halt, hostnamectl, init, journalctl, kernel-install, - localectl, loginctl, machinectl, poweroff, reboot, runlevel, shutdown, - systemctl, systemd-analyze, systemd-ask-password, systemd-cat, systemd-cgls, - systemd-cgtop, systemd-coredumpctl, systemd-delta, systemd-detect-virt, - systemd-inhibit, systemd-machine-id-setup, systemd-notify, systemd-nspawn, - systemd-run, systemd-stdio-bridge, systemd-tmpfiles, systemd-tty-ask-password-agent, + <seg>bootctl, busctl, coredumpctl, halt, hostnamectl, init, journalctl, + kernel-install, localectl, loginctl, machinectl, networkctl, poweroff, + reboot, runlevel, shutdown, systemctl, systemd-analyze, + systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop, + systemd-delta, systemd-detect-virt, systemd-escape, systemd-hwdb, + systemd-inhibit, systemd-machine-id-setup, systemd-notify, + systemd-nspawn, systemd-path, systemd-resolve, systemd-run, + systemd-stdio-bridge, systemd-tmpfiles, systemd-tty-ask-password-agent, telinit, timedatectl, and udevadm</seg> - - <seg>libnss_myhostname.so.2, libsystemd.so, libudev.so</seg> + <seg>libnss_myhostname.so.2, libnss_mymachines.so.2, + libnss_resolve.so.2, libsystemd.so, and libudev.so</seg> <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d, /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev, /etc/xdg/systemd, /lib/systemd, /lib/udev, /usr/include/systemd, /usr/lib/binfmt.d, /usr/lib/kernel, /usr/lib/modules-load.d, /usr/lib/sysctl.d, /usr/lib/systemd, /usr/lib/tmpfiles.d, - /usr/share/doc/systemd-&systemd-version;, /usr/share/systemd, - /var/lib/systemd, /var/log/journal</seg> + /usr/share/doc/systemd-&systemd-version;, /usr/share/factory, + /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg> </seglistitem> </segmentedlist> @@ -228,7 +259,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="bootctl"> <term><command>bootctl</command></term> <listitem> - <para>used to query the firmware and boot manager settings.</para> + <para>used to query the firmware and boot manager settings</para> <indexterm zone="ch-system-systemd bootctl"> <primary sortas="b-bootctl">bootctl</primary> </indexterm> @@ -238,13 +269,23 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="busctl"> <term><command>busctl</command></term> <listitem> - <para>used to introspect and monitor the D-Bus bus.</para> + <para>Used to introspect and monitor the D-Bus bus</para> <indexterm zone="ch-system-systemd busctl"> <primary sortas="b-busctl">busctl</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="coredumpctl"> + <term><command>coredumpctl</command></term> + <listitem> + <para>Used to retrieve coredumps from the systemd Journal</para> + <indexterm zone="ch-system-systemd coredumpctl"> + <primary sortas="b-coredumpctl">coredumpctl</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="halt"> <term><command>halt</command></term> <listitem> @@ -252,7 +293,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <parameter>-h</parameter> option, except when already in run-level 0, then it tells the kernel to halt the system; it notes in the file <filename>/var/log/wtmp</filename> that the system is being - brought down.</para> + brought down</para> <indexterm zone="ch-system-systemd halt"> <primary sortas="b-halt">halt</primary> </indexterm> @@ -262,8 +303,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="hostnamectl"> <term><command>hostnamectl</command></term> <listitem> - <para>used to query and change the system hostname and related - settings.</para> + <para>Used to query and change the system hostname and related + settings</para> <indexterm zone="ch-system-systemd hostnamectl"> <primary sortas="b-hostnamectl">hostnamectl</primary> </indexterm> @@ -275,7 +316,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <listitem> <para>The first process to be started when the kernel has initialized the hardware which takes over the boot process and starts all the - proceses it is instructed to.</para> + proceses it is instructed to</para> <indexterm zone="ch-system-systemd init"> <primary sortas="b-init">init</primary> </indexterm> @@ -285,7 +326,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="journalctl"> <term><command>journalctl</command></term> <listitem> - <para>used to query the contents of the Systemd Journal.</para> + <para>Used to query the contents of the systemd Journal</para> <indexterm zone="ch-system-systemd journalctl"> <primary sortas="b-journalctl">journalctl</primary> </indexterm> @@ -295,8 +336,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="kernel-install"> <term><command>kernel-install</command></term> <listitem> - <para>used to add and remove kernel and initramfs images to and - from /boot.</para> + <para>Used to add and remove kernel and initramfs images to and + from /boot</para> <indexterm zone="ch-system-systemd kernel-install"> <primary sortas="b-kernel-install">kernel-install</primary> </indexterm> @@ -306,8 +347,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="localectl"> <term><command>localectl</command></term> <listitem> - <para>used to query and change the system locale and keyboard layout - settings.</para> + <para>Used to query and change the system locale and keyboard layout + settings</para> <indexterm zone="ch-system-systemd localectl"> <primary sortas="b-localectl">localectl</primary> </indexterm> @@ -317,8 +358,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="loginctl"> <term><command>loginctl</command></term> <listitem> - <para>used to introspect and control the state of the Systemd Login - Manager.</para> + <para>Used to introspect and control the state of the systemd Login + Manager</para> <indexterm zone="ch-system-systemd loginctl"> <primary sortas="b-loginctl">loginctl</primary> </indexterm> @@ -328,7 +369,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="machinectl"> <term><command>machinectl</command></term> <listitem> - <para>used to introspect and control the state of the Systemd Virtual + <para>Used to introspect and control the state of the systemd Virtual Machine and Container Registration Manager</para> <indexterm zone="ch-system-systemd machinectl"> <primary sortas="b-machinectl">machinectl</primary> @@ -336,11 +377,22 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> </listitem> </varlistentry> + <varlistentry id="networkctl"> + <term><command>networkctl</command></term> + <listitem> + <para>Used to introspect the state of the network links as seen by + systemd-networkd</para> + <indexterm zone="ch-system-systemd networkctl"> + <primary sortas="b-networkctl">networkctl</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="poweroff"> <term><command>poweroff</command></term> <listitem> <para>Tells the kernel to halt the system and switch off the computer - (see <command>halt</command>).</para> + (see <command>halt</command>)</para> <indexterm zone="ch-system-systemd poweroff"> <primary sortas="b-poweroff">poweroff</primary> </indexterm> @@ -351,7 +403,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <term><command>reboot</command></term> <listitem> <para>Tells the kernel to reboot the system (see - <command>halt</command>).</para> + <command>halt</command>)</para> <indexterm zone="ch-system-systemd reboot"> <primary sortas="b-reboot">reboot</primary> </indexterm> @@ -362,7 +414,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <term><command>runlevel</command></term> <listitem> <para>Reports the previous and the current run-level, as noted in the - last run-level record in <filename>/var/run/utmp</filename>.</para> + last run-level record in <filename>/var/run/utmp</filename></para> <indexterm zone="ch-system-systemd runlevel"> <primary sortas="b-runlevel">runlevel</primary> </indexterm> @@ -373,7 +425,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <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> + and notifying all logged-in users</para> <indexterm zone="ch-system-systemd shutdown"> <primary sortas="b-shutdown">shutdown</primary> </indexterm> @@ -383,8 +435,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemctl"> <term><command>systemctl</command></term> <listitem> - <para>used to introspect and control the state of the Systemd system and - service manager.</para> + <para>Used to introspect and control the state of the systemd system + and service manager</para> <indexterm zone="ch-system-systemd systemctl"> <primary sortas="b-systemctl">systemctl</primary> </indexterm> @@ -394,8 +446,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-analyze"> <term><command>systemd-analyze</command></term> <listitem> - <para>used to determine system boot-up performance of the current boot. - </para> + <para>Used to determine system boot-up performance of the current + boot</para> <indexterm zone="ch-system-systemd systemd-analyze"> <primary sortas="b-systemd-analyze">systemd-analyze</primary> </indexterm> @@ -405,8 +457,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-ask-password"> <term><command>systemd-ask-password</command></term> <listitem> - <para>used to query a system password or passphrase from the user, using a - question message specified on the command line.</para> + <para>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"> <primary sortas="b-systemd-ask-password">systemd-ask-password</primary> </indexterm> @@ -416,7 +468,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-cat"> <term><command>systemd-cat</command></term> <listitem> - <para>used to connect STDOUT and STDERR of a process with the Journal. + <para>Used to connect STDOUT and STDERR of a process with the Journal </para> <indexterm zone="ch-system-systemd systemd-cat"> <primary sortas="b-systemd-cat">systemd-cat</primary> @@ -427,8 +479,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-cgls"> <term><command>systemd-cgls</command></term> <listitem> - <para>recursively shows the contents of the selected Linux control group - hierarchy in a tree.</para> + <para>Recursively shows the contents of the selected Linux control + group hierarchy in a tree</para> <indexterm zone="ch-system-systemd systemd-cgls"> <primary sortas="b-systemd-cgls">systemd-cgls</primary> </indexterm> @@ -438,30 +490,20 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-cgtop"> <term><command>systemd-cgtop</command></term> <listitem> - <para>shows the top control groups of the local Linux control group hierarchy, - ordered by their CPU, memory and disk I/O load.</para> + <para>Shows the top control groups of the local Linux control group + hierarchy, ordered by their CPU, memory and disk I/O load</para> <indexterm zone="ch-system-systemd systemd-cgtop"> <primary sortas="b-systemd-cgtop">systemd-cgtop</primary> </indexterm> </listitem> </varlistentry> - <varlistentry id="systemd-coredumpctl"> - <term><command>systemd-coredumpctl</command></term> - <listitem> - <para>used to retrieve coredumps from the Systemd Journal</para> - <indexterm zone="ch-system-systemd systemd-coredumpctl"> - <primary sortas="b-systemd-coredumpctl">systemd-coredumpctl</primary> - </indexterm> - </listitem> - </varlistentry> - <varlistentry id="systemd-delta"> <term><command>systemd-delta</command></term> <listitem> - <para>used to identify and compare configuration files in + <para>Used to identify and compare configuration files in <filename class="directory">/etc</filename> that override default - counterparts in <filename class="directory">/usr</filename>.</para> + counterparts in <filename class="directory">/usr</filename></para> <indexterm zone="ch-system-systemd systemd-delta"> <primary sortas="b-systemd-delta">systemd-delta</primary> </indexterm> @@ -471,18 +513,39 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-detect-virt"> <term><command>systemd-detect-virt</command></term> <listitem> - <para>detects execution in a virtualized environment.</para> + <para>Detects execution in a virtualized environment</para> <indexterm zone="ch-system-systemd systemd-detect-virt"> <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="systemd-escape"> + <term><command>systemd-escape</command></term> + <listitem> + <para>Used to escape strings for inclusion in systemd unit + names</para> + <indexterm zone="ch-system-systemd systemd-escape"> + <primary sortas="b-systemd-escape">systemd-escape</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="systemd-hwdb"> + <term><command>systemd-hwdb</command></term> + <listitem> + <para>Used to manage hardware database (hwdb)</para> + <indexterm zone="ch-system-systemd systemd-hwdb"> + <primary sortas="b-systemd-hwdb">systemd-hwdb</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="systemd-inhibit"> <term><command>systemd-inhibit</command></term> <listitem> - <para>used to execute a program with a shutdown, sleep or idle inhibitor lock - taken.</para> + <para>Used to execute a program with a shutdown, sleep or idle + inhibitor lock taken</para> <indexterm zone="ch-system-systemd systemd-inhibit"> <primary sortas="b-systemd-inhibit">systemd-inhibit</primary> </indexterm> @@ -492,9 +555,9 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-machine-id-setup"> <term><command>systemd-machine-id-setup</command></term> <listitem> - <para>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> + <para>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> <indexterm zone="ch-system-systemd systemd-machine-id-setup"> <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary> </indexterm> @@ -504,8 +567,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-notify"> <term><command>systemd-notify</command></term> <listitem> - <para>used by daemon scripts to notify the init system about status changes. - </para> + <para>Used by daemon scripts to notify the init system about status + changes</para> <indexterm zone="ch-system-systemd systemd-notify"> <primary sortas="b-systemd-notify">systemd-notify</primary> </indexterm> @@ -515,25 +578,47 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-nspawn"> <term><command>systemd-nspawn</command></term> <listitem> - <para>used to run a command or OS in a light-weight namespace container.</para> + <para>Used to run a command or OS in a light-weight namespace + container</para> <indexterm zone="ch-system-systemd systemd-nspawn"> <primary sortas="b-systemd-nspawn">systemd-nspawn</primary> </indexterm> </listitem> </varlistentry> + <varlistentry id="systemd-path"> + <term><command>systemd-path</command></term> + <listitem> + <para>Used to query system and user paths</para> + <indexterm zone="ch-system-systemd systemd-path"> + <primary sortas="b-systemd-path">systemd-path</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="systemd-resolve"> + <term><command>systemd-resolve</command></term> + <listitem> + <para>Used to resolve domain names, IPV4 and IPv6 addresses, DNS + resource records, and services</para> + <indexterm zone="ch-system-systemd systemd-resolve"> + <primary sortas="b-systemd-resolve">systemd-resolve</primary> + </indexterm> + </listitem> + </varlistentry> + <varlistentry id="systemd-run"> <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>Used to create and start a transient .service or a .scope unit + and run the specified command in it</para> <indexterm zone="ch-system-systemd systemd-run"> <primary sortas="b-systemd-run">systemd-run</primary> </indexterm> </listitem> </varlistentry> -<!-- <varlistentry id="systemd-stdio-bridge"> + <!-- <varlistentry id="systemd-stdio-bridge"> <term><command>systemd-stdio-bridge</command></term> <listitem> <para>To be completed</para> @@ -546,9 +631,10 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-tmpfiles"> <term><command>systemd-tmpfiles</command></term> <listitem> - <para>creates, deletes and cleans up volatile and temporary files and directories, - based on the configuration file format and location specified in - <filename class="directory">tmpfiles.d</filename> directories.</para> + <para>Creates, deletes and cleans up volatile and temporary files and + directories, based on the configuration file format and location + specified in + <filename class="directory">tmpfiles.d</filename> directories</para> <indexterm zone="ch-system-systemd systemd-tmpfiles"> <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary> </indexterm> @@ -558,7 +644,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="systemd-tty-ask-password-agent"> <term><command>systemd-tty-ask-password-agent</command></term> <listitem> - <para>used to list or process pending Systemd password requests</para> + <para>Used to list 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> </indexterm> @@ -568,7 +654,8 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="telinit"> <term><command>telinit</command></term> <listitem> - <para>Tells <command>init</command> which run-level to change to.</para> + <para>Tells <command>init</command> which run-level to change + to</para> <indexterm zone="ch-system-systemd telinit"> <primary sortas="b-telinit">telinit</primary> </indexterm> @@ -578,7 +665,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="timedatectl"> <term><command>timedatectl</command></term> <listitem> - <para>used to query and change the system clock and its settings. + <para>Used to query and change the system clock and its settings </para> <indexterm zone="ch-system-systemd timedatectl"> <primary sortas="b-timedatectl">timedatectl</primary> @@ -592,7 +679,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <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> + for a given device</para> <indexterm zone="ch-system-systemd udevadm"> <primary sortas="b-udevadm">udevadm</primary> </indexterm> @@ -602,7 +689,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="libsystemd"> <term><filename class="libraryfile">libsystemd</filename></term> <listitem> - <para>Systemd utility library.</para> + <para>systemd utility library</para> <indexterm zone="ch-system-systemd libsystemd"> <primary sortas="c-libsystemd">libsystemd</primary> </indexterm> @@ -612,7 +699,7 @@ make -f &udev-lfs-version;/Makefile.lfs install</userinput></screen> <varlistentry id="libudev"> <term><filename class="libraryfile">libudev</filename></term> <listitem> - <para>A library to access Udev device information.</para> + <para>A library to access Udev device information</para> <indexterm zone="ch-system-systemd libudev"> <primary sortas="c-libudev">libudev</primary> </indexterm> diff --git a/chapter06/util-linux.xml b/chapter06/util-linux.xml index 6a81f3186..f4a7c5640 100644 --- a/chapter06/util-linux.xml +++ b/chapter06/util-linux.xml @@ -62,7 +62,7 @@ --> <para>Prepare Util-linux for compilation:</para> -<screen><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \ +<screen revision="sysv"><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \ --docdir=/usr/share/doc/util-linux-&util-linux-version; \ --disable-chfn-chsh \ --disable-login \ @@ -76,6 +76,18 @@ --without-systemd \ --without-systemdsystemunitdir</userinput></screen> +<screen revision="systemd"><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \ + --docdir=/usr/share/doc/util-linux-&util-linux-version; \ + --disable-chfn-chsh \ + --disable-login \ + --disable-nologin \ + --disable-su \ + --disable-setpriv \ + --disable-runuser \ + --disable-pylibmount \ + --disable-static \ + --without-python</userinput></screen> + <para>The --disable and --without options prevent warnings about building components that require packages not in LFS or are inconsistent with programs installed by other packages.</para> |