summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2016-03-08 14:44:46 +0100
committerRichard Levitte <levitte@openssl.org>2016-03-09 11:22:07 +0100
commitb32b896166199b497bf98da6a5c5b50d8811851f (patch)
tree410ed2b7e7c73ccf0533f7a3982760dd8b8a3a7b /INSTALL
parentAdapt appveyor.yml for the new unified build (diff)
downloadopenssl-b32b896166199b497bf98da6a5c5b50d8811851f.tar.xz
openssl-b32b896166199b497bf98da6a5c5b50d8811851f.zip
Adapt INSTALL and related notes for Windows
Reviewed-by: Rich Salz <rsalz@openssl.org>
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL28
1 files changed, 26 insertions, 2 deletions
diff --git a/INSTALL b/INSTALL
index a96eb8ffe2..4799d62dd9 100644
--- a/INSTALL
+++ b/INSTALL
@@ -3,7 +3,7 @@
---------------------------------
[Installation on DOS (with djgpp), Windows, MacOS (before MacOS X)
- and NetWare is described in INSTALL.DJGPP, INSTALL.WIN, INSTALL.MacOS
+ and NetWare is described in INSTALL.DJGPP, INSTALL.MacOS
and INSTALL.NW.
This document describes installation on the main supported operating
@@ -22,7 +22,8 @@
For more details regarding specific platforms, there are these notes
available:
- * NOTES.VMS
+ * NOTES.VMS (OpenVMS)
+ * NOTES.WIN (any Windows except for Windows CE)
Quick Start
-----------
@@ -43,6 +44,12 @@
$ mms test
$ mms install
+ on Windows (only pick one of the targets for configuration):
+
+ $ perl Configure { VC-WIN32 | VC-WIN64A | VC-WIN64I | VC-CE }
+ $ nmake
+ $ nmake test
+
[If any of these steps fails, see section Installation in Detail below.]
This will build and install OpenSSL in the default location, which is:
@@ -50,6 +57,7 @@
Unix: normal installation directories under /usr/local
OpenVMS: SYS$COMMON:[OPENSSL-'version'...], where 'version' is the
OpenSSL version number ('major'_'minor').
+ Windows: currently don't have an install function <TBA>
If you want to install it anywhere else, run config like this:
@@ -152,6 +160,8 @@
1a. Configure OpenSSL for your operation system automatically:
+ NOTE: This is not available on Windows.
+
$ ./config [options] # Unix
or
@@ -235,6 +245,13 @@
$ @[PATH.TO.OPENSSL.SOURCE]Configure {target} {options}
+ Windows example:
+
+ $ C:
+ $ mkdir \temp-openssl
+ $ cd \temp-openssl
+ $ perl d:\PATH\TO\OPENSSL\SOURCE\Configure {target} {options}
+
Paths can be relative just as well as absolute. Configure will
do its best to translate them to relative paths whenever possible.
@@ -242,6 +259,7 @@
$ make # Unix
$ mms ! (or mmk) OpenVMS
+ $ nmake # Windows
This will build the OpenSSL libraries (libcrypto.a and libssl.a on
Unix, corresponding on other platforms) and the OpenSSL binary
@@ -268,6 +286,7 @@
$ make test # Unix
$ mms test ! OpenVMS
+ $ nmake test # Windows
If some tests fail, look at the output. There may be reasons for
the failure that isn't a problem in OpenSSL itself (like a
@@ -279,11 +298,15 @@
$ DEFINE HARNESS_VERBOSE YES
$ mms test ! OpenVMS
+ $ set HARNESS_VERBOSE=yes
+ $ nmake test # Windows
+
If you want to run just one or a few specific tests, you can use
the make variable TESTS to specify them, like this:
$ make TESTS='test_rsa test_dsa' test # Unix
$ mms/macro="TESTS=test_rsa test_dsa" test ! OpenVMS
+ $ nmake TESTS='test_rsa test_dsa' test # Windows
And of course, you can combine (Unix example shown):
@@ -293,6 +316,7 @@
$ make list-tests # Unix
$ mms list-tests ! OpenVMS
+ $ nmake list-tests # Windows
Have a look at the manual for the perl module Test::Harness to
see what other HARNESS_* variables there are.