summaryrefslogtreecommitdiff
path: root/security
diff options
context:
space:
mode:
authorgdt <gdt@pkgsrc.org>2020-03-27 13:42:53 +0000
committergdt <gdt@pkgsrc.org>2020-03-27 13:42:53 +0000
commit8795a2a7bf95547de7daa0aec1ee2bbeb1d7742e (patch)
treef417b876d3ea62cb761831400088cd0758b0d441 /security
parent2e0dff3514f73ad2be3f9eabeb2dfe8da242fbd2 (diff)
downloadpkgsrc-8795a2a7bf95547de7daa0aec1ee2bbeb1d7742e.tar.gz
mozilla-rootcerts-openssl: Revise and extend DESCR
Explain the purpose, and then explain the mechanism and why it is somewhat and very irregular in the pkgsrc and native cases. Point to mozilla-rootcerts as providing certificates without configuring them as trust anchors.
Diffstat (limited to 'security')
-rw-r--r--security/mozilla-rootcerts-openssl/DESCR23
1 files changed, 17 insertions, 6 deletions
diff --git a/security/mozilla-rootcerts-openssl/DESCR b/security/mozilla-rootcerts-openssl/DESCR
index 396f11f9ed0..1e9a30a2750 100644
--- a/security/mozilla-rootcerts-openssl/DESCR
+++ b/security/mozilla-rootcerts-openssl/DESCR
@@ -1,7 +1,18 @@
-This is a hack for managing the certificate files installed into
-the OpenSSL certs directory by the mozilla-rootcerts package.
+This package configures the Mozilla rootcerts bundle CAs as trust
+anchors in OpenSSL, so that programs using OpenSSL will be able to use
+them to validate SSL certificates.
-For native OpenSSL it operates directly in /etc/ssl/certs (because it
-has to) and not under the pkgsrc prefix, and even for pkgsrc OpenSSL
-it still scribbles in $PREFIX/etc/ssl/certs where packages normally
-shouldn't. Be advised.
+For pkgsrc-provided OpenSSL, this package operates modifies
+${PREFIX}/etc/ssl/certs as installed by another package. This is
+somewhat irregular as packages should not modify content under etc.
+
+For native OpenSSL, it modifies the base system OpenSSL certificate
+directory, e.g. /etc/openssl/certs or /etc/ssl/certs. This is
+necessary to configure trust anchors for native OpenSSL, so that
+progams in pkgsrc can use these CA certs in validation. Modification
+of /etc is very irregular as pkgsrc should not write anything outside
+of ${PREFIX}.
+
+See also the mozilla-rootcerts package (which this one depends on) for
+placing the Mozilla CA list in the filesystem but not configuring it
+into OpenSSL. \ No newline at end of file