X-Git-Url: https://git.openssl.org/?p=openssl.git;a=blobdiff_plain;f=INSTALL;h=31d88574cf0c49318b27ac39723707d6d9cb4c1b;hp=610f7dad268a0b9ec6f9977b8c64310579032a54;hb=317be63875e59efa34be0075eaff3c033ef6969f;hpb=478b50cf67d6a91fdcd584cff57c58b7e863055d diff --git a/INSTALL b/INSTALL index 610f7dad26..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 + * 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.] @@ -173,14 +187,38 @@ $ make test - If a test fails, look at the output. There may be reasons for - the failure that isn't a problem in OpenSSL itself (like a missing - or malfunctioning bc). If it is a problem with OpenSSL itself, - try removing any compiler optimization flags from the CFLAG line - in Makefile.ssl and run "make clean; make". Please send a bug - report to , including the output of - "make report" in order to be added to the request tracker at - http://www.openssl.org/support/rt.html. + 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 + malfunction with Perl). You may want increased verbosity, that + can be accomplished like this: + + $ HARNESS_VERBOSE=yes make 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: + + $ make TESTS='test_rsa test_dsa' test + + And of course, you can combine: + + $ HARNESS_VERBOSE=yes make TESTS='test_rsa test_dsa' test + + You can find the list of available tests like this: + + $ 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". + + Please send a bug report to , and when + you do, please run the following and include the output in your + report: + + $ make report 4. If everything tests ok, install OpenSSL with @@ -214,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. @@ -302,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 ------------------------ @@ -346,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.