last commit was wrong. Now it works. :)

[openssl.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index c4105f96fc0eaf438ea7a65270df2009006a421a..ca4d403a3695a371616bc5d81395bed5f8941537 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -2,8 +2,8 @@
  INSTALLATION ON THE UNIX PLATFORM
  ---------------------------------
 
  INSTALLATION ON THE UNIX PLATFORM
  ---------------------------------
 

- [See INSTALL.W32 for instructions for compiling OpenSSL on Windows systems,
-  and INSTALL.VMS for installing on OpenVMS systems.]
+ [Installation on Windows, OpenVMS and MacOS (before MacOS X) is described
+  in INSTALL.W32, INSTALL.VMS and INSTALL.MacOS.]

 
  To install OpenSSL, you will need:
 
 
  To install OpenSSL, you will need:
 


@@ -33,7 +33,8 @@
  Configuration Options
  ---------------------
 
  Configuration Options
  ---------------------
 

- There are several options to ./config to customize the build:
+ There are several options to ./config (or ./Configure) to customize
+ the build:

 
   --prefix=DIR  Install in DIR/bin, DIR/lib, DIR/include/openssl.
                Configuration files used by OpenSSL will be in DIR/ssl
 
   --prefix=DIR  Install in DIR/bin, DIR/lib, DIR/include/openssl.
                Configuration files used by OpenSSL will be in DIR/ssl


@@ -42,9 +43,6 @@
   --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.
 

-  rsaref        Build with RSADSI's RSAREF toolkit (this assumes that
-                librsaref.a is in the library search path).
-

   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.
 


@@ -52,6 +50,12 @@
                 This will usually require additional system-dependent options!
                 See "Note on multi-threading" below.
 
                 This will usually require additional system-dependent options!
                 See "Note on multi-threading" below.
 

+  no-shared     Don't try to create shared libraries.
+
+  shared        In addition to the usual static libraries, create shared
+                libraries on platforms where it's supported.  See "Note on
+                shared libraries" below.
+

   no-asm        Do not use assembler code.
 
   386           Use the 80386 instruction set only (the default x86 code is
   no-asm        Do not use assembler code.
 
   386           Use the 80386 instruction set only (the default x86 code is


@@ -77,8 +81,9 @@
 
      This guesses at your operating system (and compiler, if necessary) and
      configures OpenSSL based on this guess. Run ./config -t to see
 
      This guesses at your operating system (and compiler, if necessary) and
      configures OpenSSL based on this guess. Run ./config -t to see

-     if it guessed correctly. If it did not get it correct or you want to
-     use a different compiler then go to step 1b. Otherwise go to step 2.
+     if it guessed correctly. If you want to use a different compiler, you
+     are cross-compiling for another platform, or the ./config guess was
+     wrong for other reasons, go to step 1b. Otherwise go to step 2.

 
      On some systems, you can include debugging information as follows:
 
 
      On some systems, you can include debugging information as follows:
 


@@ -101,7 +106,8 @@
 
      If your system is not available, you will have to edit the Configure
      program and add the correct configuration for your system. The
 
      If your system is not available, you will have to edit the Configure
      program and add the correct configuration for your system. The

-     generic configurations "cc" or "gcc" should usually work.
+     generic configurations "cc" or "gcc" should usually work on 32 bit
+     systems.

 
      Configure creates the file Makefile.ssl from Makefile.org and
      defines various macros in crypto/opensslconf.h (generated from
 
      Configure creates the file Makefile.ssl from Makefile.org and
      defines various macros in crypto/opensslconf.h (generated from


@@ -115,9 +121,12 @@
      OpenSSL binary ("openssl"). The libraries will be built in the top-level
      directory, and the binary will be in the "apps" directory.
 
      OpenSSL binary ("openssl"). The libraries will be built in the top-level
      directory, and the binary will be in the "apps" directory.
 

-     If "make" fails, please report the problem to <openssl-bugs@openssl.org>
-     (note that your message will be forwarded to a public mailing list).
-     Include the output of "make report" in your message.
+     If "make" fails, look at the output.  There may be reasons for
+     the failure that isn't a problem in OpenSSL itself (like missing
+     standard headers).  If it is a problem with OpenSSL itself, please
+     report the problem to <openssl-bugs@openssl.org> (note that your
+     message will be forwarded to a public mailing list).  Include the
+     output of "make report" in your message.

 
      [If you encounter assembler error messages, try the "no-asm"
      configuration option as an immediate fix.]
 
      [If you encounter assembler error messages, try the "no-asm"
      configuration option as an immediate fix.]


@@ -129,10 +138,13 @@
 
        $ make test
 
 
        $ make test
 

-    If a test fails, try removing any compiler optimization flags from
-    the CFLAGS line in Makefile.ssl and run "make clean; make". Please
-    send a bug report to <openssl-bugs@openssl.org>, including the
-    output of "make report".
+     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 CFLAGS line
+     in Makefile.ssl and run "make clean; make". Please send a bug
+     report to <openssl-bugs@openssl.org>, including the output of
+     "make report".

 
   4. If everything tests ok, install OpenSSL with
 
 
   4. If everything tests ok, install OpenSSL with
 


@@ -250,3 +262,14 @@
  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.)
 

+
+ Note on shared libraries
+ ------------------------
+
+ For some systems, the OpenSSL Configure script knows what is needed to
+ build shared libraries for libcrypto and libssl.  On these systems,
+ the shared libraries are currently not created by default, but giving
+ the option "shared" will get them created.  This method supports Makefile
+ targets for shared library creation, like linux-shared.  Those targets
+ can currently be used on their own just as well, but this is expected
+ to change in future versions of OpenSSL.