summaryrefslogtreecommitdiffstats
path: root/INSTALL.W64
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2019-07-25 12:21:33 +0200
committerRichard Levitte <levitte@openssl.org>2019-07-25 18:58:35 +0200
commitd333ebaf9c77332754a9d5e111e2f53e1de54fdd (patch)
treec3e6dedf493685f8944f024f9eafe1d5f1d887c1 /INSTALL.W64
parent0bc650d58a58a8b4af97639b952eac3558bb982e (diff)
Document issue with default installation paths on diverse Windows targets
For all config targets (except VMS, because it has a completely different set of scripts), '/usr/local/ssl' is the default prefix for installation of programs and libraries, as well as the path for OpenSSL run-time configuration. For programs built to run in a Windows environment, this default is unsafe, and the user should set a different prefix. This has been hinted at in some documentation but not all, and the danger of leaving the default as is hasn't been documented at all. This change documents the issue as a caveat lector, and all configuration examples now include an example --prefix. CVE-2019-1552 Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/9456)
Diffstat (limited to 'INSTALL.W64')
-rw-r--r--INSTALL.W6412
1 files changed, 10 insertions, 2 deletions
diff --git a/INSTALL.W64 b/INSTALL.W64
index 9fa7a19205..3f5bf80f86 100644
--- a/INSTALL.W64
+++ b/INSTALL.W64
@@ -30,6 +30,14 @@
Neither of these is actually big deal and hardly encountered
in real-life applications.
+ ### Default install and config paths
+
+ ./Configure defaults to '/usr/local/ssl' as installation top. This is
+ suitable for Unix, but not for Windows, where this usually is a world
+ writable directory and therefore accessible for change by untrusted users.
+ It is therefore recommended to set your own --prefix or --openssldir to
+ some location that is not world writeable (see the example above)
+
Compiling procedure
-------------------
@@ -43,7 +51,7 @@
To build for Win64/x64:
- > perl Configure VC-WIN64A
+ > perl Configure VC-WIN64A --prefix=c:\some\openssl\dir
> ms\do_win64a
> nmake -f ms\ntdll.mak
> cd out32dll
@@ -51,7 +59,7 @@
To build for Win64/IA64:
- > perl Configure VC-WIN64I
+ > perl Configure VC-WIN64I --prefix=c:\some\openssl\dir
> ms\do_win64i
> nmake -f ms\ntdll.mak
> cd out32dll