INSTALL: clarify 386 and no-sse2 options.

This is 1.0.2-specific reformat of 5ae5dc96610f0a598dac9d2f267b5c0ddd77b2e4.

Reviewed-by: Rich Salz <rsalz@openssl.org>
This commit is contained in:
Andy Polyakov 2016-11-25 17:50:37 +01:00
parent f47201b327
commit c477f8e716
2 changed files with 28 additions and 20 deletions

View File

@ -58,12 +58,13 @@ my $usage="Usage: Configure [no-<cipher> ...] [enable-<cipher> ...] [experimenta
# zlib-dynamic Like "zlib", but the zlib library is expected to be a shared # zlib-dynamic Like "zlib", but the zlib library is expected to be a shared
# library and will be loaded in run-time by the OpenSSL library. # library and will be loaded in run-time by the OpenSSL library.
# sctp include SCTP support # sctp include SCTP support
# 386 generate 80386 code
# enable-weak-ssl-ciphers # enable-weak-ssl-ciphers
# Enable EXPORT and LOW SSLv3 ciphers that are disabled by # Enable EXPORT and LOW SSLv3 ciphers that are disabled by
# default. Note, weak SSLv2 ciphers are unconditionally # default. Note, weak SSLv2 ciphers are unconditionally
# disabled. # disabled.
# no-sse2 disables IA-32 SSE2 code, above option implies no-sse2 # 386 generate 80386 code in assembly modules
# no-sse2 disables IA-32 SSE2 code in assembly modules, the above
# mentioned '386' option implies this one
# no-<cipher> build without specified algorithm (rsa, idea, rc5, ...) # no-<cipher> build without specified algorithm (rsa, idea, rc5, ...)
# -<xxx> +<xxx> compiler options are passed through # -<xxx> +<xxx> compiler options are passed through
# #

43
INSTALL
View File

@ -74,24 +74,26 @@
no-asm Do not use assembler code. no-asm Do not use assembler code.
386 Use the 80386 instruction set only (the default x86 code is 386 In 32-bit x86 builds, when generating assembly modules,
more efficient, but requires at least a 486). Note: Use use the 80386 instruction set only (the default x86 code
compiler flags for any other CPU specific configuration, is more efficient, but requires at least a 486). Note:
e.g. "-m32" to build x86 code on an x64 system. This doesn't affect code generated by compiler, you're
likely to complement configuration command line with
suitable compiler-specific option.
no-sse2 Exclude SSE2 code pathes. Normally SSE2 extention is no-sse2 Exclude SSE2 code paths from 32-bit x86 assembly modules.
detected at run-time, but the decision whether or not the Normally SSE2 extension is detected at run-time, but the
machine code will be executed is taken solely on CPU decision whether or not the machine code will be executed
capability vector. This means that if you happen to run OS is taken solely on CPU capability vector. This means that
kernel which does not support SSE2 extension on Intel P4 if you happen to run OS kernel which does not support SSE2
processor, then your application might be exposed to extension on Intel P4 processor, then your application
"illegal instruction" exception. There might be a way might be exposed to "illegal instruction" exception.
to enable support in kernel, e.g. FreeBSD kernel can be There might be a way to enable support in kernel, e.g.
compiled with CPU_ENABLE_SSE, and there is a way to FreeBSD kernel can be compiled with CPU_ENABLE_SSE, and
disengage SSE2 code pathes upon application start-up, there is a way to disengage SSE2 code paths upon application
but if you aim for wider "audience" running such kernel, start-up, but if you aim for wider "audience" running
consider no-sse2. Both 386 and no-asm options above imply such kernel, consider no-sse2. Both the 386 and
no-sse2. no-asm options imply no-sse2.
no-<cipher> Build without the specified cipher (bf, cast, des, dh, dsa, no-<cipher> Build without the specified cipher (bf, cast, des, dh, dsa,
hmac, md2, md5, mdc2, rc2, rc4, rc5, rsa, sha). hmac, md2, md5, mdc2, rc2, rc4, rc5, rsa, sha).
@ -101,7 +103,12 @@
-Dxxx, -lxxx, -Lxxx, -fxxx, -mXXX, -Kxxx These system specific options will -Dxxx, -lxxx, -Lxxx, -fxxx, -mXXX, -Kxxx These system specific options will
be passed through to the compiler to allow you to be passed through to the compiler to allow you to
define preprocessor symbols, specify additional libraries, define preprocessor symbols, specify additional libraries,
library directories or other compiler options. library directories or other compiler options. It might be
worth noting that some compilers generate code specifically
for processor the compiler currently executes on. This is
not necessarily what you might have in mind, since it might
be unsuitable for execution on other, typically older,
processor. Consult your compiler documentation.
-DHAVE_CRYPTODEV Enable the BSD cryptodev engine even if we are not using -DHAVE_CRYPTODEV Enable the BSD cryptodev engine even if we are not using
BSD. Useful if you are running ocf-linux or something BSD. Useful if you are running ocf-linux or something