X-Git-Url: https://git.openssl.org/gitweb/?p=openssl.git;a=blobdiff_plain;f=INSTALL.md;h=01e255df7e2d3db6c9d0afb849ac2684cec69abf;hp=dfa127637897e7d25f06eef31d260350cacc0991;hb=7a810fac866c6c1d93015999633ee2a29f17b3d2;hpb=036cbb6bbf30955abdcffaf6e52cd926d8d8ee75 diff --git a/INSTALL.md b/INSTALL.md index dfa1276378..01e255df7e 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -48,8 +48,8 @@ Prerequisites To install OpenSSL, you will need: * A "make" implementation - * Perl 5 with core modules (please read [NOTES.PERL](NOTES.PERL)) - * The Perl module Text::Template (please read [NOTES.PERL](NOTES.PERL)) + * Perl 5 with core modules (please read [NOTES-Perl.md](NOTES-Perl.md)) + * The Perl module `Text::Template` (please read [NOTES-PERL.md](NOTES-Perl.md)) * an ANSI C compiler * a development environment in the form of development libraries and C header files @@ -58,13 +58,13 @@ To install OpenSSL, you will need: For additional platform specific requirements, solutions to specific issues and other details, please read one of these: - * [NOTES.UNIX](NOTES.UNIX) - notes for Unix like systems - * [NOTES.VMS](NOTES.VMS) - notes related to OpenVMS - * [NOTES.WIN](NOTES.WIN) - notes related to the Windows platform - * [NOTES.DJGPP](NOTES.DJGPP) - building for DOS with DJGPP - * [NOTES.ANDROID](NOTES.ANDROID) - building for Android platforms (using NDK) - * [NOTES.VALGRIND](NOTES.VALGRIND) - testing with Valgrind - * [NOTES.PERL](NOTES.PERL) - some notes on Perl + * [NOTES-Unix.md](NOTES-Unix.md) - notes for Unix like systems + * [NOTES-VMS.md](NOTES-VMS.md) - notes related to OpenVMS + * [NOTES-Windows.txt](NOTES-Windows.txt) - notes related to the Windows platform + * [NOTES-DJGPP.md](NOTES-DJGPP.md) - building for DOS with DJGPP + * [NOTES-Android.md](NOTES-Android.md) - building for Android platforms (using NDK) + * [NOTES-Valgrind.md](NOTES-Valgrind.md) - testing with Valgrind + * [NOTES-Perl.m](NOTES-Perl.md) - some notes on Perl Notational conventions ====================== @@ -275,7 +275,7 @@ On OpenVMS: $ perl Configure --prefix=PROGRAM:[INSTALLS] --openssldir=SYS$MANAGER:[OPENSSL] Note: if you do add options to the configuration command, please make sure -you've read more than just this Quick Start, such as relevant `NOTES.*` files, +you've read more than just this Quick Start, such as relevant `NOTES-*` files, the options outline below, as configuration options may change the outcome in otherwise unexpected ways. @@ -285,7 +285,7 @@ Configuration Options There are several options to `./Configure` to customize the build (note that for Windows, the defaults for `--prefix` and `--openssldir` depend on what configuration is used and what Windows implementation OpenSSL is built on. -More notes on this in [NOTES.WIN](NOTES.WIN)): +More notes on this in [NOTES-Windows.txt](NOTES-Windows.txt): API Level --------- @@ -447,6 +447,7 @@ on most unix-ish operating systems. ### egd Check for an entropy generating daemon. +This source is ignored by the FIPS provider. ### rdcpu @@ -455,11 +456,13 @@ Use the `RDSEED` or `RDRAND` command if provided by the CPU. ### librandom Use librandom (not implemented yet). +This source is ignored by the FIPS provider. ### none Disable automatic seeding. This is the default on some operating systems where no suitable entropy source exists, or no support for it is implemented yet. +This option is ignored by the FIPS provider. For more information, see the section [Notes on random number generation][rng] at the end of this document. @@ -1505,7 +1508,7 @@ cases it does not succeed. You will see a message like the following: $ ./Configure Operating system: x86-whatever-minix - This system (minix) is not supported. See file INSTALL for details. + This system (minix) is not supported. See file INSTALL.md for details. Even if the automatic target selection by the `./Configure` script fails, chances are that you still might find a suitable target in the `Configurations` @@ -1689,7 +1692,8 @@ The seeding method can be configured using the `--with-rand-seed` option, which can be used to specify a comma separated list of seed methods. However, in most cases OpenSSL will choose a suitable default method, so it is not necessary to explicitly provide this option. Note also -that not all methods are available on all platforms. +that not all methods are available on all platforms. The FIPS provider will +silently ignore seed sources that were not validated. I) On operating systems which provide a suitable randomness source (in form of a system call or system device), OpenSSL will use the optimal