Changeset 6df63e4 for chapter08/openssl.xml

Timestamp:

05/14/2021 03:41:52 PM (23 months ago)

Author:

Ken Moffat <ken@…>

Branches:

11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, arm, ml-11.0, multilib, s6-init, trunk, xry111/arm64, xry111/clfs-ng, xry111/glibc-2.34, xry111/glibc-2.37, xry111/kcfg-revise, xry111/lfs-next, xry111/pip3, xry111/queue-11.3, xry111/rust-wip-20221008, xry111/tester-nohack

Children:

80838616, e04bf44

Parents:

78361854

Message:

OpenSSL: add a note about upgrading.

File:

• chapter08/openssl.xml (modified) (1 diff)

chapter08/openssl.xml

@@ -77 +77 @@
 
 <screen><userinput remap="install">cp -vfr doc/* /usr/share/doc/openssl-&openssl-version;</userinput></screen>
+
+    <note>
+      <para>
+        You should update OpenSSL when a new version which fixes vulnerabilities
+        is announced. The releases run in series, with a letter for each release
+        after the initial release (e.g. 1.1.1, 1.1.1a, 1.1.1b, etc). Because LFS
+        installs only the shared libraries, there is no need to recompile packages
+        which link to <filename class="libraryfile">libcrypto.so</filename> or
+        <filename class="libraryfile">libssl.so</filename>
+        <emphasis>when upgrading in the same series.</emphasis>
+      </para>
+
+      <para>
+        However, any running programs linked to those libraries need to be stopped
+        and restarted. The following command, run as
+        <systemitem class="username">root</systemitem> after udating, will list what is
+        using the old versions of those libraries:
+      </para>
+
+<screen><userinput role="nodump">grep -l  -e 'libssl.*deleted' -e 'libcrypto.*deleted' /proc/*/maps |
+   tr -cd 0-9\\n | xargs -r ps u</userinput></screen>
+
+      <para>
+        If you used <application>OpenSSH</application> to login to the system, you
+        need to logout, login again, and rerun that command to confirm nothing is
+        still using the deleted libraries.
+      </para>
+    </note>
 
   </sect2>