Changeset 4efb652

Timestamp:

02/16/2015 02:20:47 AM (9 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

683e0873

Parents:

c554ae14

Message:

Minor text updates to the stunnel package

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15513 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• postlfs/security/stunnel.xml (modified) (11 diffs)

postlfs/security/stunnel.xml

@@ -35 +35 @@
     channels. <application>stunnel</application> can be used to add SSL
     functionality to commonly used <application>Inetd</application> daemons
-    like POP-2, POP-3, and IMAP servers, to standalone daemons like NNTP,
-    SMTP and HTTP, and in tunneling PPP over network sockets without changes
-    to the server package source code.</para>
+    such as POP-2, POP-3, and IMAP servers, along with standalone daemons such
+    as NNTP, SMTP, and HTTP. <application>stunnel</application> can also be
+    used to tunnel PPP over network sockets without changes to the server
+    package source code.</para>
 
     &lfs76_checked;
@@ -95 +96 @@
     <note>
       <para>A signed SSL Certificate and a Private Key is necessary to run the
-      <command>stunnel</command> daemon.  Further below, after
-      <command>make ... install</command>, we include instructions to generate
-      them. However, if you own, or have already created a signed SSL
-      Certificate you wish to use, copy it to
+      <command>stunnel</command> daemon. After the package is installed, there
+      are instructions to generate them. However, if you own or have already
+      created a signed SSL Certificate you wish to use, copy it to
       <filename>/etc/stunnel/stunnel.pem</filename> before starting the build
       (ensure only <systemitem class="username">root</systemitem> has read and
@@ -118 +118 @@
     commands:</para>
 
-    <note><para>For some systems with <application>binutils</application>
-    versions prior to 2.25, <command>configure</command> may fail.  If
-    necessary, fix it either with:</para>
+    <note>
+      <para>For some systems with <application>binutils</application>
+      versions prior to 2.25, <command>configure</command> may fail.  If
+      necessary, fix it either with:</para>
 
 <screen><userinput>sed -i '/LDFLAGS.*static_flag/ s/^/#/' configure</userinput></screen>
 
-    <para>or, if <xref linkend="llvm"/> with Clang is installed, you can
-    replace <command>./configure ... </command> with <command>CC=clang
-    ./configure ... </command> in the first command bellow.</para></note>
+      <para>or, if <xref linkend="llvm"/> with Clang is installed, you can
+      replace <command>./configure ...</command> with <command>CC=clang
+      ./configure ...</command> in the first command below.</para>
+    </note>
 
 <screen><userinput>./configure --prefix=/usr        \
@@ -140 +142 @@
 <screen role="root"><userinput>make docdir=/usr/share/doc/stunnel-&stunnel-version; install</userinput></screen>
 
-    <para>To create the <filename>stunnel.pem</filename> in the
-    <filename class="directory">/etc/stunnel</filename> directory, 
-    you need to create one.   The following command prompts you
-    for the necessary information. Ensure you reply to the</para>
-    
+    <para>If you do not already have a signed SSL Certificate and Private Key,
+    create the <filename>stunnel.pem</filename> file in the
+    <filename class="directory">/etc/stunnel</filename> directory using the
+    command below. You will be prompted to enter the necessary
+    information. Ensure you reply to the</para>
+
 <screen><prompt>Common Name (FQDN of your server) [localhost]:</prompt></screen>
 
@@ -150 +153 @@
     to access the service(s).</para>
 
-    <para>To generate a certificate, as the 
-    <systemitem class="username">root</systemitem> user, run:</para>
+    <para>To generate a certificate, as the
+    <systemitem class="username">root</systemitem> user, issue:</para>
 
 <screen role="root"><userinput>make cert</userinput></screen>
@@ -161 +164 @@
 
     <para><parameter>--disable-systemd</parameter>: This switch disables
-    systemd socket activation support, not available in BLFS.</para>
+    systemd socket activation support which is not available in BLFS.</para>
 
     <para><command>make docdir=... install</command>: This command installs the
-    package, changes the documentation installation directory to standard
+    package and changes the documentation installation directory to standard
     naming conventions.</para>
 
@@ -188 +191 @@
       <para>As the <systemitem class="username">root</systemitem> user,
       create the directory used for the
-      <filename class="extension">.pid</filename> file that is created
+      <filename class="extension">.pid</filename> file created
       when the <application>stunnel</application> daemon starts:</para>
 
@@ -224 +227 @@
 chmod -v 644 /etc/stunnel/stunnel.conf</userinput></screen>
 
-      <para>Finally, you need to add the service(s) you wish to encrypt to the
+      <para>Finally, add the service(s) you wish to encrypt to the
       configuration file. The format is as follows:</para>
 
@@ -239 +242 @@
 
       <para>For a full explanation of the commands and syntax used in the
-      configuration file, run <command>man stunnel</command>.</para>
+      configuration file, issue <command>man stunnel</command>.</para>
 
     </sect3>
@@ -247 +250 @@
 
       <para>To automatically start the <command>stunnel</command> daemon
-      when the system is rebooted, install the
+      when the system is booted, install the
       <filename>/etc/rc.d/init.d/stunnel</filename> bootscript from the
       <xref linkend="bootscripts"/> package.</para>
@@ -272 +275 @@
         <seg>stunnel and stunnel3</seg>
         <seg>libstunnel.so</seg>
-        <seg>/etc/stunnel, 
+        <seg>/etc/stunnel,
              /usr/lib/stunnel,
              /usr/share/doc/stunnel-&stunnel-version;, and