Add no signing flag.

[openssl.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index ddd0764556da0a9367f5cbc72559c42415a32a47..31d88574cf0c49318b27ac39723707d6d9cb4c1b 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -3,7 +3,7 @@
  ---------------------------------
 
  [Installation on DOS (with djgpp), Windows, OpenVMS, MacOS (before MacOS X)
  ---------------------------------
 
  [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
   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
  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
   * 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.
 
   --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.
 
   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.
 
      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).
 
      defines various macros in crypto/opensslconf.h (generated from
      crypto/opensslconf.h.in).
 


@@ -180,9 +194,6 @@
 
        $ HARNESS_VERBOSE=yes make test
 
 
        $ 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:
 
      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
 
 
        $ 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".
      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
 
      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.
 
 
      installation target filenames.
 
 


@@ -310,26 +323,6 @@
      with names of the form <foo.h>.
 
 
      with names of the form <foo.h>.
 
 

- 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
  -----------------------
 
  Note on multi-threading
  -----------------------
 


@@ -346,6 +339,10 @@
  you can still use "no-threads" to suppress an annoying warning message
  from the Configure script.)
 
  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
  ------------------------
 
  Note on shared libraries
  ------------------------


@@ -390,7 +387,7 @@
                rm -f $F; ln -s $OPENSSL_SOURCE/$F $F
                echo $F '->' $OPENSSL_SOURCE/$F
        done
                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.
 
  OPENSSL_SOURCE is an environment variable that contains the absolute (this
  is important!) path to the OpenSSL source tree.