From 54948b710c6976f5de159da89b8431497e5b7e2f Mon Sep 17 00:00:00 2001 From: David Bryant Date: Mon, 21 Nov 2022 16:13:06 -0600 Subject: [PATCH] Straighten out capitalization, correct a few grammatical errors, improve English idiom, clarify a few things, remove superfluous verbiage, etc. --- chapter08/acl.xml | 12 +++---- chapter08/attr.xml | 6 ++-- chapter08/libcap.xml | 8 ++--- chapter08/mpfr.xml | 2 +- chapter08/shadow.xml | 85 ++++++++++++++++++++++---------------------- 5 files changed, 56 insertions(+), 57 deletions(-) diff --git a/chapter08/acl.xml b/chapter08/acl.xml index 48bf73a75..6702af90f 100644 --- a/chapter08/acl.xml +++ b/chapter08/acl.xml @@ -24,7 +24,7 @@ <para>The Acl package contains utilities to administer Access Control Lists, - which are used to define more fine-grained discretionary access rights for + which are used to define fine-grained discretionary access rights for files and directories.</para> <segmentedlist> @@ -52,11 +52,11 @@ <screen><userinput remap="make">make</userinput></screen> - <para>The Acl tests need to be run on a filesystem that supports access - controls after <application>Coreutils</application> has been built with the - Acl libraries. If desired, return to this package and run <command>make - check</command> after <application>Coreutils</application> has been built - later in this chapter.</para> + <para>The Acl tests must be run on a filesystem that supports access + controls, but not until the <application>Coreutils</application> package has been built, + using the <application>Acl</application> libraries. If desired, return to this package + and run <command>make check</command> after the <application>Coreutils</application> + package has been built.</para> <para>Install the package:</para> diff --git a/chapter08/attr.xml b/chapter08/attr.xml index a7a9bb426..5272cfcb2 100644 --- a/chapter08/attr.xml +++ b/chapter08/attr.xml @@ -23,8 +23,8 @@ <sect2 role="package"> <title/> - <para>The attr package contains utilities to administer the extended - attributes on filesystem objects.</para> + <para>The Attr package contains utilities to administer the extended + attributes of filesystem objects.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> @@ -52,7 +52,7 @@ <screen><userinput remap="make">make</userinput></screen> - <para>The tests need to be run on a filesystem that supports extended + <para>The tests must be run on a filesystem that supports extended attributes such as the ext2, ext3, or ext4 filesystems. To test the results, issue:</para> diff --git a/chapter08/libcap.xml b/chapter08/libcap.xml index d696a3e3f..89348db88 100644 --- a/chapter08/libcap.xml +++ b/chapter08/libcap.xml @@ -23,9 +23,9 @@ <sect2 role="package"> <title/> - <para>The Libcap package implements the user-space interfaces to the POSIX - 1003.1e capabilities available in Linux kernels. These capabilities are a - partitioning of the all powerful root privilege into a set of distinct + <para>The Libcap package implements the user-space interface to the POSIX + 1003.1e capabilities available in Linux kernels. These capabilities + partition the all-powerful root privilege into a set of distinct privileges.</para> <segmentedlist> @@ -116,7 +116,7 @@ <varlistentry id="getpcaps"> <term><command>getpcaps</command></term> <listitem> - <para>Displays the capabilities on the queried process(es)</para> + <para>Displays the capabilities of the queried process(es)</para> <indexterm zone="ch-system-libcap getpcaps"> <primary sortas="b-getpcaps">getpcaps</primary> </indexterm> diff --git a/chapter08/mpfr.xml b/chapter08/mpfr.xml index f2344facb..7237b1ecb 100644 --- a/chapter08/mpfr.xml +++ b/chapter08/mpfr.xml @@ -58,7 +58,7 @@ make html</userinput></screen> Do not skip it under any circumstances.</para> </important> - <para>Test the results and ensure that all tests passed:</para> + <para>Test the results and ensure that all 183 tests passed:</para> <screen><userinput remap="test">make check</userinput></screen> diff --git a/chapter08/shadow.xml b/chapter08/shadow.xml index cbd6ac913..68cc130c9 100644 --- a/chapter08/shadow.xml +++ b/chapter08/shadow.xml @@ -66,16 +66,16 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /' {} \;</userinput></s the obsolete <filename class="directory">/var/spool/mail</filename> location for user mailboxes that Shadow uses by default to the <filename class="directory">/var/mail</filename> location used currently. And, - get rid of <filename class="directory">/bin</filename> and - <filename class="directory">/sbin</filename> from <envar>PATH</envar>, - since they are simply symlinks to their counterpart in + remove <filename class="directory">/bin</filename> and + <filename class="directory">/sbin</filename> from the <envar>PATH</envar>, + since they are simply symlinks to their counterparts in <filename class="directory">/usr</filename>.</para> <note> - <para>If <filename class="directory">/bin</filename> and/or - <filename class="directory">/sbin</filename> are preferred to be - left over in <envar>PATH</envar> for some reason, modify - <envar>PATH</envar> in <filename>.bashrc</filename> after LFS is + <para>If you wish to include <filename class="directory">/bin</filename> + and/or <filename class="directory">/sbin</filename> in the <envar>PATH</envar> + for some reason, modify the + <envar>PATH</envar> in <filename>.bashrc</filename> after LFS has been built.</para> </note> @@ -85,7 +85,7 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /' {} \;</userinput></s -i etc/login.defs</userinput></screen> <note> - <para>If you chose to build Shadow with Cracklib support, run the following:</para> + <para>If you chose to build Shadow with Cracklib support, issue this command:</para> <screen role="nodump"><userinput>sed -i 's:DICTPATH.*:DICTPATH\t/lib/cracklib/pw_dict:' etc/login.defs</userinput></screen> </note> @@ -108,21 +108,22 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /' {} \;</userinput></s --with-group-name-max-length=32</userinput></screen> <variablelist> - <title>The meaning of the configure option: + The meaning of the new configuration options: touch /usr/bin/passwd The file /usr/bin/passwd needs - to exist because its location is hardcoded in some programs, and - if it does not exist, the default location is not right. + to exist because its location is hardcoded in some programs; + if it does not already exist, the installation script will + create it in the wrong place. --with-group-name-max-length=32 - The maximum user name is 32 characters. Make the maximum - group name the same. + The longest permissible user name is 32 characters. Make the maximum + length of a group name the same. @@ -153,9 +154,9 @@ make -C man install-man groups; set and change their passwords; and perform other administrative tasks. For a full explanation of what password shadowing means, see the doc/HOWTO file within the unpacked - source tree. If using Shadow support, keep in mind that programs which need + source tree. If you use Shadow support, keep in mind that programs which need to verify passwords (display managers, FTP programs, pop3 daemons, etc.) - must be Shadow-compliant. That is, they need to be able to work with + must be Shadow-compliant. That is, they must be able to work with shadowed passwords. To enable shadowed passwords, run the following command: @@ -167,44 +168,44 @@ make -C man install-man grpconv Shadow's default configuration for the useradd - utility has a few caveats that need some explanation. First, the default + utility needs some explanation. First, the default action for the useradd utility is to create the user and - a group of the same name as the user. By default the user ID (UID) and - group ID (GID) numbers will begin with 1000. This means if you don't pass - parameters to useradd, each user will be a member of a + a group with the same name as the user. By default the user ID (UID) and + group ID (GID) numbers will begin at 1000. This means if you don't pass + extra parameters to useradd, each user will be a member of a unique group on the system. If this behavior is undesirable, you'll need - to pass one of the -g or -N - parameter to useradd or to change the setting of + to pass either the -g or -N + parameter to useradd, or else change the setting of USERGROUPS_ENAB in /etc/login.defs. See useradd(8) for more information. Second, to change the default parameters, the file - /etc/default/useradd needs to be created and tailored + /etc/default/useradd must be created and tailored to suit your particular needs. Create it with: mkdir -p /etc/default useradd -D --gid 999 - <filename>/etc/default/useradd</filename> Parameter Explanations + <filename>/etc/default/useradd</filename> parameter explanations GROUP=999 This parameter sets the beginning of the group numbers used in the /etc/group file. The particular value 999 - comes from the --gid parameter above. You can - modify it to anything you desire. + comes from the --gid parameter above. You + may set it to any desired value. Note that useradd will never reuse a UID or GID. If the number identified in this parameter is used, it will use the next available number. Note also that if you don't have a group with - an ID equal to this number on your system the first time you use + an ID equal to this number on your system, then the first time you use useradd without the -g - parameter, you will get a message displayed on the terminal that - says: useradd: unknown GID 999, - although the account is correctly created. That is why we have + parameter, an error message will be generated—useradd: + unknown GID 999, + even though the account has been created correctly. That is why we created the group users with this group ID in . @@ -214,12 +215,11 @@ useradd -D --gid 999 CREATE_MAIL_SPOOL=yes This parameter causes useradd to create a - mailbox file for the newly created user. useradd - will make the group ownership of this file to the + mailbox file for each new user. useradd + will assign the group ownership of this file to the mail group with 0660 - permissions. If you would prefer that these mailbox files are not - created by useradd, issue the following - command: + permissions. If you would rather not create these files, + issue the following command: sed -i '/MAIL/s/yes/no/' /etc/default/useradd @@ -230,7 +230,7 @@ useradd -D --gid 999 - Setting the root password + Setting the Root Password Choose a password for user root and set it by running: @@ -329,7 +329,7 @@ useradd -D --gid 999 faillog Is used to examine the log of login failures, to set a maximum - number of failures before an account is blocked, or to reset the + number of failures before an account is blocked, and to reset the failure count faillog @@ -509,9 +509,8 @@ useradd -D --gid 999 nologin - Displays a message that an account is not available; it is designed - to be used as the default shell for accounts that have been - disabled + Displays a message saying an account is not available; it is designed + to be used as the default shell for disabled accounts nologin @@ -597,7 +596,7 @@ useradd -D --gid 999 userdel - Deletes the given user account + Deletes the specified user account userdel @@ -607,8 +606,8 @@ useradd -D --gid 999 usermod - Is used to modify the given user's login name, User - Identification (UID), shell, initial group, home directory, etc. + Is used to modify the given user's login name, user + identification (UID), shell, initial group, home directory, etc. usermod @@ -640,7 +639,7 @@ useradd -D --gid 999 libsubid - library for process subordinate id ranges for users + library for processing subordinate id ranges for users libsubid