diff options
Diffstat (limited to 'chapter06')
-rw-r--r-- | chapter06/adjusting.xml | 2 | ||||
-rw-r--r-- | chapter06/bc.xml | 4 | ||||
-rw-r--r-- | chapter06/dbus.xml | 24 | ||||
-rw-r--r-- | chapter06/expat.xml | 4 | ||||
-rw-r--r-- | chapter06/gcc.xml | 3 | ||||
-rw-r--r-- | chapter06/glibc.xml | 13 | ||||
-rw-r--r-- | chapter06/introduction.xml | 8 | ||||
-rw-r--r-- | chapter06/libcap.xml | 21 | ||||
-rw-r--r-- | chapter06/m4.xml | 2 | ||||
-rw-r--r-- | chapter06/perl.xml | 2 | ||||
-rw-r--r-- | chapter06/pkgconfig.xml | 2 | ||||
-rw-r--r-- | chapter06/procps.xml | 4 | ||||
-rw-r--r-- | chapter06/readline.xml | 4 | ||||
-rw-r--r-- | chapter06/shadow.xml | 4 | ||||
-rw-r--r-- | chapter06/systemd.xml | 31 | ||||
-rw-r--r-- | chapter06/util-linux.xml | 2 | ||||
-rw-r--r-- | chapter06/vim.xml | 11 |
17 files changed, 71 insertions, 70 deletions
diff --git a/chapter06/adjusting.xml b/chapter06/adjusting.xml index 1231c2ca8..5852d2958 100644 --- a/chapter06/adjusting.xml +++ b/chapter06/adjusting.xml @@ -110,7 +110,7 @@ SEARCH_DIR("/lib")</computeroutput></screen> at all, then something is seriously wrong. Investigate and retrace the steps to find out where the problem is and correct it. The most likely reason is that something went wrong with the specs file adjustment. Any - issues will need to be resolved before continuing on with the process.</para> + issues will need to be resolved before continuing with the process.</para> <para os="u">Once everything is working correctly, clean up the test files:</para> diff --git a/chapter06/bc.xml b/chapter06/bc.xml index 2b168fbc0..e538c0466 100644 --- a/chapter06/bc.xml +++ b/chapter06/bc.xml @@ -128,7 +128,7 @@ ln -sfv libncurses.so.6 /usr/lib/libncurses.so</userinput></screen> <varlistentry id="bc"> <term><command>bc</command></term> <listitem> - <para>is a command line calculator</para> + <para>A command line calculator</para> <indexterm zone="ch-system-bc bc"> <primary sortas="b-bc">bc</primary> </indexterm> @@ -138,7 +138,7 @@ ln -sfv libncurses.so.6 /usr/lib/libncurses.so</userinput></screen> <varlistentry id="dc"> <term><command>dc</command></term> <listitem> - <para>is a reverse-polish command line calculator</para> + <para>A reverse-polish command line calculator</para> <indexterm zone="ch-system-bc dc"> <primary sortas="b-dc">dc</primary> </indexterm> diff --git a/chapter06/dbus.xml b/chapter06/dbus.xml index 8b7b6a582..06b66851e 100644 --- a/chapter06/dbus.xml +++ b/chapter06/dbus.xml @@ -125,7 +125,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>is 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> @@ -135,7 +135,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>is 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> @@ -145,7 +145,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-launch"> <term><command>dbus-launch</command></term> <listitem> - <para>starts <command>dbus-daemon</command> from a shell + <para>Starts <command>dbus-daemon</command> from a shell script</para> <indexterm zone="ch-system-dbus dbus-launch"> <primary sortas="b-dbus-launch">dbus-launch</primary> @@ -156,7 +156,7 @@ 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> @@ -166,7 +166,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-run-session"> <term><command>dbus-run-session</command></term> <listitem> - <para>starts a session bus instance of <command>dbus-daemon</command> + <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"> @@ -178,7 +178,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <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> @@ -188,8 +188,8 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-test-tool"> <term><command>dbus-test-tool</command></term> <listitem> - <para>is a tool to help packages test - <application>D-Bus</application>.</para> + <para>A tool to help packages test + <application>D-Bus</application></para> <indexterm zone="ch-system-dbus dbus-test-tool"> <primary sortas="b-dbus-test-tool">dbus-test-tool</primary> </indexterm> @@ -200,8 +200,8 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="dbus-update-activation-environment"> <term><command>dbus-update-activation-environment</command></term> <listitem> - <para>updates environment variables that will be set for - <application>D-Bus</application> session services.</para> + <para>Updates environment variables that will be set for + <application>D-Bus</application> session services</para> <indexterm zone="ch-system-dbus dbus-update-activation-environment"> <primary sortas="b-dbus-update-activation-environment">dbus-update-activation-environment</primary> </indexterm> @@ -211,7 +211,7 @@ 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> @@ -221,7 +221,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri <varlistentry id="libdbus-1"> <term><filename class="libraryfile">libdbus-1</filename></term> <listitem> - <para>contains API functions used to communicate with the D-Bus + <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> diff --git a/chapter06/expat.xml b/chapter06/expat.xml index c11a9e28f..7b71c8481 100644 --- a/chapter06/expat.xml +++ b/chapter06/expat.xml @@ -91,7 +91,7 @@ install -v -m644 doc/*.{html,png,css} /usr/share/doc/expat-&expat-version;</user <varlistentry id="xmlwf"> <term><command>xmlwf </command></term> <listitem> - <para>is a non-validating utility to check whether or not + <para>Is a non-validating utility to check whether or not XML documents are well formed</para> <indexterm zone="ch-system-expat xmlwf"> <primary sortas="b-xmlwf">xmlwf</primary> @@ -102,7 +102,7 @@ install -v -m644 doc/*.{html,png,css} /usr/share/doc/expat-&expat-version;</user <varlistentry id="libexpat"> <term><filename class="libraryfile">libexpat</filename></term> <listitem> - <para> contains API functions for parsing XML</para> + <para>Contains API functions for parsing XML</para> <indexterm zone="ch-system-expat libexpat"> <primary sortas="c-libexpat">libexpat</primary> </indexterm> diff --git a/chapter06/gcc.xml b/chapter06/gcc.xml index 289885a72..f54ed6c75 100644 --- a/chapter06/gcc.xml +++ b/chapter06/gcc.xml @@ -219,10 +219,13 @@ ln -sfv ../../libexec/gcc/$(gcc -dumpmachine)/&gcc-version;/liblto_plugin.so \ <para>Again, note that the directory named after your target triplet may be different than the above, depending on your architecture.</para> +<!-- This appears to be obsolete + <note><para>As of version 4.3.0, GCC now unconditionally installs the <filename>limits.h</filename> file into the private <filename class="directory">include-fixed</filename> directory, and that directory is required to be in place.</para></note> +--> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="adjusting.xml" diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml index 8a40aee02..07cbe969d 100644 --- a/chapter06/glibc.xml +++ b/chapter06/glibc.xml @@ -50,7 +50,7 @@ Glibc autoconf tests would give false results and defeat the goal of achieving a clean build.</para></note> - <para>Some of the Glibc programs use non-FHS compilant + <para>Some of the Glibc programs use the non-FHS compilant <filename class="directory">/var/db</filename> directory to store their runtime data. Apply the following patch to make such programs store their runtime data in the FHS-compliant locations:</para> @@ -123,10 +123,9 @@ unset GCC_INCDIR</userinput></screen> <varlistentry> <term><parameter>--enable-stack-protector=strong</parameter></term> <listitem> - <para>This option increases system security by adding a known canary - (a random integer) to the stack during a function preamble, and checks - it when the function returns. If it changed, there was a stack - overflow, and the program aborts.</para> + <para>This option increases system security by adding + extra code to check for buffer overflows, such as stack + smashing attacks.</para> </listitem> </varlistentry> @@ -149,8 +148,8 @@ unset GCC_INCDIR</userinput></screen> Do not skip it under any circumstance.</para> </important> - <para>Generally a few tests do not pass, but you can generally ignore - any of the test failures listed below. Now test the build results:</para> + <para>Generally a few tests do not pass. The test failures listed below + are usually safe to ignore.</para> <screen><userinput remap="test">make check</userinput></screen> diff --git a/chapter06/introduction.xml b/chapter06/introduction.xml index 4671662c6..fd96b574a 100644 --- a/chapter06/introduction.xml +++ b/chapter06/introduction.xml @@ -68,11 +68,11 @@ do the linking) may not even be known.</para> <para>In the procedures in Chapter 6, we remove or disable installation of - most static libraries. In a few cases, especially glibc and gcc, the use - of static libraries remains essential to the general package building - process. Usually this is done by passing a + most static libraries. Usually this is done by passing a <option>--disable-static</option> option to <command>configure</command>. - In other cases, alternate means are needed.</para> + In other cases, alternate means are needed. In a few cases, especially + glibc and gcc, the use of static libraries remains essential to the general + package building process. </para> <para>For a more complete discussion of libraries, see the discussion <ulink url="&blfs-root;/view/&short-version;/introduction/libraries.html"> diff --git a/chapter06/libcap.xml b/chapter06/libcap.xml index cabcb1774..94fc94468 100644 --- a/chapter06/libcap.xml +++ b/chapter06/libcap.xml @@ -140,17 +140,6 @@ ln -sfv ../../lib/$(readlink /usr/lib/libcap.so) /usr/lib/libcap.so</userinput>< </listitem> </varlistentry> - <varlistentry id="libcap"> - <term><filename class="libraryfile">libcap</filename></term> - <listitem> - <para>Contains the library functions for manipulating POSIX 1003.1e - capabilities</para> - <indexterm zone="ch-system-libcap libcap"> - <primary sortas="c-libcap">libcap</primary> - </indexterm> - </listitem> - </varlistentry> - <varlistentry id="setcap"> <term><command>setcap</command></term> <listitem> @@ -161,6 +150,16 @@ ln -sfv ../../lib/$(readlink /usr/lib/libcap.so) /usr/lib/libcap.so</userinput>< </listitem> </varlistentry> + <varlistentry id="libcap"> + <term><filename class="libraryfile">libcap</filename></term> + <listitem> + <para>Contains the library functions for manipulating POSIX 1003.1e + capabilities</para> + <indexterm zone="ch-system-libcap libcap"> + <primary sortas="c-libcap">libcap</primary> + </indexterm> + </listitem> + </varlistentry> </variablelist> diff --git a/chapter06/m4.xml b/chapter06/m4.xml index 1bb55fed3..9308347e6 100644 --- a/chapter06/m4.xml +++ b/chapter06/m4.xml @@ -78,7 +78,7 @@ <!-- Don't remove the extra space, it prevet a FOP warning. --> <term><command>m4 </command></term> <listitem> - <para>copies the given files while expanding the macros that they + <para>Copies the given files while expanding the macros that they contain [These macros are either built-in or user-defined and can take any number of arguments. Besides performing macro expansion, <command>m4</command> has built-in functions for including named diff --git a/chapter06/perl.xml b/chapter06/perl.xml index cf1b1b2b2..f48ce59d4 100644 --- a/chapter06/perl.xml +++ b/chapter06/perl.xml @@ -242,7 +242,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen> <term><command>instmodsh</command></term> <listitem> <para>Shell script for examining installed Perl modules, - and can even create a tarball from an installed module</para> + and can create a tarball from an installed module</para> <indexterm zone="ch-system-perl instmodsh"> <primary sortas="b-instmodsh">instmodsh</primary> </indexterm> diff --git a/chapter06/pkgconfig.xml b/chapter06/pkgconfig.xml index a4383b11c..95b837ed3 100644 --- a/chapter06/pkgconfig.xml +++ b/chapter06/pkgconfig.xml @@ -106,7 +106,7 @@ <!-- Don't remove the extra space, it prevents a FOP warning. --> <term><command>pkg-config </command></term> <listitem> - <para>returns meta information for the specified library or package + <para>Returns meta information for the specified library or package </para> <indexterm zone="ch-system-pkgconfig pkgconfig"> <primary sortas="b-pkgconfig">pkg-config</primary> diff --git a/chapter06/procps.xml b/chapter06/procps.xml index d3a7e52cc..1a42ce68c 100644 --- a/chapter06/procps.xml +++ b/chapter06/procps.xml @@ -40,7 +40,7 @@ <sect2 role="installation"> <title>Installation of Procps-ng</title> - <para>Now prepare procps-ng for compilation:</para> + <para>Prepare procps-ng for compilation:</para> <screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr \ --exec-prefix= \ @@ -193,7 +193,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libprocps.so) /usr/lib/libprocps.so</useri <varlistentry id="slabtop"> <term><command>slabtop</command></term> <listitem> - <para>Displays detailed kernel slap cache information in real time</para> + <para>Displays detailed kernel slab cache information in real time</para> <indexterm zone="ch-system-procps slabtop"> <primary sortas="b-slabtop">slabtop</primary> </indexterm> diff --git a/chapter06/readline.xml b/chapter06/readline.xml index d7f27b334..da1eb34a7 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -124,8 +124,8 @@ ln -sfv ../../lib/$(readlink /usr/lib/libhistory.so ) /usr/lib/libhistory.so</us <varlistentry id="libreadline"> <term><filename class="libraryfile">libreadline</filename></term> <listitem> - <para>Aids in the consistency of user interface across discrete - programs that need to provide a command line interface</para> + <para>Provides a set of commands for manipulating text entered in an + interactive session of a program.</para> <indexterm zone="ch-system-readline libreadline"> <primary sortas="c-libreadline">libreadline</primary> </indexterm> diff --git a/chapter06/shadow.xml b/chapter06/shadow.xml index d90210985..c1f3b9a6a 100644 --- a/chapter06/shadow.xml +++ b/chapter06/shadow.xml @@ -76,8 +76,8 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /' {} \;</userinput></s <screen role="nodump"><userinput>sed -i 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@' etc/login.defs</userinput></screen> </note> - <para>Make a minor change to make the default useradd consistent with the LFS - groups file:</para> + <para>Make a minor change to make the first group number generated + by useradd 1000:</para> <screen><userinput remap="pre">sed -i 's/1000/999/' etc/useradd</userinput></screen> diff --git a/chapter06/systemd.xml b/chapter06/systemd.xml index 9bd8fd6d0..6c8a79e19 100644 --- a/chapter06/systemd.xml +++ b/chapter06/systemd.xml @@ -123,13 +123,12 @@ meson --prefix=/usr \ </varlistentry> <varlistentry> - <term><parameter>-Dldconfig=no</parameter></term> + <term><parameter>-Dldconfig=false</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> + <para>This switch prevents installation of a systemd unit that runs + <command>ldconfig</command> at boot, which is not useful for source + distributions such as LFS and makes the boot time longer. Remove it + if the described feature is desired.</para> </listitem> </varlistentry> @@ -158,7 +157,7 @@ meson --prefix=/usr \ 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> + were created earlier in this chapter.</para> </listitem> </varlistentry> @@ -250,7 +249,7 @@ chmod 755 /lib/systemd/systemd-user-sessions</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> @@ -306,8 +305,8 @@ chmod 755 /lib/systemd/systemd-user-sessions</userinput></screen> <term><command>init</command></term> <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> + the hardware which takes over the boot process and starts all + processes according to its configuration files</para> <indexterm zone="ch-system-systemd init"> <primary sortas="b-init">init</primary> </indexterm> @@ -317,7 +316,7 @@ chmod 755 /lib/systemd/systemd-user-sessions</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> @@ -558,7 +557,7 @@ chmod 755 /lib/systemd/systemd-user-sessions</userinput></screen> <varlistentry id="systemd-mount"> <term><command>systemd-mount</command></term> <listitem> - <para>is a tool to temporarily mount or auto-mount a drive.</para> + <para>A tool to temporarily mount or auto-mount a drive.</para> <indexterm zone="ch-system-systemd systemd-mount"> <primary sortas="b-systemd-mount">systemd-mount</primary> </indexterm> @@ -632,7 +631,7 @@ chmod 755 /lib/systemd/systemd-user-sessions</userinput></screen> <varlistentry id="systemd-socket-activate"> <term><command>systemd-socket-activate</command></term> <listitem> - <para>is a tool to listen on socket devices and launch a process upon + <para>A tool to listen on socket devices and launch a process upon connection.</para> <indexterm zone="ch-system-systemd systemd-socket-activate"> <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary> @@ -688,9 +687,9 @@ chmod 755 /lib/systemd/systemd-user-sessions</userinput></screen> <varlistentry id="udevadm"> <term><command>udevadm</command></term> <listitem> - <para>Generic Udev administration tool: controls the udevd daemon, + <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 + 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> @@ -701,7 +700,7 @@ chmod 755 /lib/systemd/systemd-user-sessions</userinput></screen> <varlistentry id="libsystemd"> <term><filename class="libraryfile">libsystemd</filename></term> <listitem> - <para>systemd utility library</para> + <para>The main systemd utility library</para> <indexterm zone="ch-system-systemd libsystemd"> <primary sortas="c-libsystemd">libsystemd</primary> </indexterm> diff --git a/chapter06/util-linux.xml b/chapter06/util-linux.xml index 1a78af502..5973081e4 100644 --- a/chapter06/util-linux.xml +++ b/chapter06/util-linux.xml @@ -1124,7 +1124,7 @@ su nobody -s /bin/bash -c "PATH=$PATH make -k check"</userinput></screen> <term><command>uuidd</command></term> <listitem> <para>A daemon used by the UUID library to generate time-based - UUIDs in a secure and guranteed-unique fashion</para> + UUIDs in a secure and guaranteed-unique fashion</para> <indexterm zone="ch-system-util-linux uuidd"> <primary sortas="b-uuidd">uuidd</primary> </indexterm> diff --git a/chapter06/vim.xml b/chapter06/vim.xml index 52e136c92..6b06c01f1 100644 --- a/chapter06/vim.xml +++ b/chapter06/vim.xml @@ -70,10 +70,11 @@ <screen><userinput remap="test">make -j1 test &> vim-test.log</userinput></screen> - <para>However, this test suite outputs a lot of binary data to the screen, - which can cause issues with the settings of the current terminal. This can - be resolved by redirecting the output to a log file. A successful test - will result in the words "ALL DONE" at completion.</para> + <para>The test suite outputs a lot of binary data to the screen. This can + cause issues with the settings of the current terminal. The problem can be + avoided by redirecting the output to a log file as shown above. A + successful test will result in the words "ALL DONE" in the log file + at completion.</para> <para>Install the package:</para> @@ -272,7 +273,7 @@ set spell</literal></screen> <term><command>vimdiff</command></term> <listitem> <para>Edits two or three versions of a file with <command>vim</command> - and show differences</para> + and shows differences</para> <indexterm zone="ch-system-vim vimdiff"> <primary sortas="b-vimdiff">vimdiff</primary> </indexterm> |