X-Git-Url: https://git.openssl.org/gitweb/?p=openssl.git;a=blobdiff_plain;f=INSTALL;h=31d88574cf0c49318b27ac39723707d6d9cb4c1b;hp=9173a4efd98a1f3166a996c5f73a130a10f0bcf6;hb=31ba0e17585bd16e089afa3a44979ccd9561182a;hpb=2e996acf2fb68ddc0248beda6682cbf078eefc78 diff --git a/INSTALL b/INSTALL index 9173a4efd9..31d88574cf 100644 --- a/INSTALL +++ b/INSTALL @@ -3,7 +3,7 @@ --------------------------------- [Installation on DOS (with djgpp), Windows, OpenVMS, MacOS (before MacOS X) - and NetWare is described in INSTALL.DJGPP, INSTALL.W32, INSTALL.VMS, + and NetWare is described in INSTALL.DJGPP, INSTALL.WIN, INSTALL.VMS, INSTALL.MacOS and INSTALL.NW. This document describes installation on operating systems in the Unix @@ -12,7 +12,8 @@ To install OpenSSL, you will need: * make - * Perl 5 with core modules (see 'Note on Perl' further down) + * Perl 5 with core modules (please read README.PERL) + * The perl module Text::Template (please read README.PERL) * an ANSI C compiler * a development environment in form of development libraries and C header files @@ -50,6 +51,19 @@ --openssldir=DIR Directory for OpenSSL files. If no prefix is specified, the library files and binaries are also installed there. + no-autoalginit Don't automatically load all supported ciphers and digests. + Typically OpenSSL will make available all of its supported + ciphers and digests. For a statically linked application this + may be undesirable if small executable size is an objective. + This only affects libcrypto. Ciphers and digests will have to be + loaded manually using EVP_add_cipher() and EVP_add_digest() if + this option is used. + + no-autoerrinit Don't automatically load all libcrypto/libssl error strings. + Typically OpenSSL will automatically load human readable error + strings. For a statically linked application this may be + undesirable if small executable size is an objective. + no-threads Don't try to build with support for multi-threaded applications. @@ -141,7 +155,7 @@ generic configurations "cc" or "gcc" should usually work on 32 bit systems. - Configure creates the file Makefile.ssl from Makefile.org and + Configure creates the file Makefile.ssl from Makefile.in and defines various macros in crypto/opensslconf.h (generated from crypto/opensslconf.h.in). @@ -158,10 +172,10 @@ standard headers). If it is a problem with OpenSSL itself, please report the problem to (note that your message will be recorded in the request tracker publicly readable - via http://www.openssl.org/support/rt.html and will be forwarded to a - public mailing list). Include the output of "make report" in your message. - Please check out the request tracker. Maybe the bug was already - reported or has already been fixed. + at https://www.openssl.org/community/index.html#bugs and will be + forwarded to a public mailing list). Include the output of "make + report" in your message. Please check out the request tracker. Maybe + the bug was already reported or has already been fixed. [If you encounter assembler error messages, try the "no-asm" configuration option as an immediate fix.] @@ -180,9 +194,6 @@ $ HARNESS_VERBOSE=yes make test - Also, you will find logs for all commands the tests have executed - in logs, test/test_*.log, one for each individual test. - If you want to run just one or a few specific tests, you can use the make variable TESTS to specify them, like this: @@ -196,6 +207,9 @@ $ make list-tests + Have a look at the manual for the perl module Test::Harness to + see what other HARNESS_* variables there are. + If you find a problem with OpenSSL itself, try removing any compiler optimization flags from the CFLAG line in Makefile and run "make clean; make". @@ -238,10 +252,9 @@ locations, but have the package installed somewhere else so that it can easily be packaged, can use - $ make INSTALL_PREFIX=/tmp/package-root install + $ make DESTDIR=/tmp/package-root install - (or specify "--install_prefix=/tmp/package-root" as a configure - option). The specified prefix will be prepended to all + The specified destination directory will be prepended to all installation target filenames. @@ -310,26 +323,6 @@ with names of the form . - Note on Perl - ------------ - - For our scripts, we rely quite a bit on Perl, and increasingly on - some core Perl modules. These Perl modules are part of the Perl - source, so if you build Perl on your own, you should be set. - - However, if you install Perl as binary packages, the outcome might - differ, and you may have to check that you do get the core modules - installed properly. We do not claim to know them all, but experience - has told us the following: - - - on Linux distributions based on Debian, the package 'perl' will - install the core Perl modules as well, so you will be fine. - - on Linux distributions based on RPMs, you will need to install - 'perl-core' rather than just 'perl'. - - It is highly recommended that you have at least Perl version 5.12 - installed. - Note on multi-threading ----------------------- @@ -346,6 +339,10 @@ you can still use "no-threads" to suppress an annoying warning message from the Configure script.) + OpenSSL provides built-in support for two threading models: pthreads (found on + most UNIX/Linux systems), and Windows threads. No other threading models are + supported. If your platform does not provide pthreads or Windows threads then + you should Configure with the "no-threads" option. Note on shared libraries ------------------------ @@ -390,7 +387,7 @@ rm -f $F; ln -s $OPENSSL_SOURCE/$F $F echo $F '->' $OPENSSL_SOURCE/$F done - make -f Makefile.org clean + make -f Makefile.in clean OPENSSL_SOURCE is an environment variable that contains the absolute (this is important!) path to the OpenSSL source tree.