doc/crypto/OPENSSL_ia32cap.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 OPENSSL_ia32cap
   6
   7 =head1 SYNOPSIS
   8
   9  unsigned long *OPENSSL_ia32cap_loc(void);
  10  #define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc()))
  11
  12 =head1 DESCRIPTION
  13
  14 Value returned by OPENSSL_ia32cap_loc() is address of a variable
  15 containing IA-32 processor capabilities bit vector as it appears in EDX
  16 register after executing CPUID instruction with EAX=1 input value (see
  17 Intel Application Note #241618). Naturally it's meaningful on IA-32
  18 platforms only. The variable is normally set up automatically upon
  19 toolkit initialization, but can be manipulated afterwards to modify
  20 crypto library behaviour. For the moment of this writing only two bits
  21 are significant, namely bit #26 denoting SSE2 support, and bit #4
  22 denoting presence of Time-Stamp Counter. Clearing bit #26 at run-time
  23 for example disables high-performance SSE2 code present in the crypto
  24 library. You might have to do this if target OpenSSL application is
  25 executed on SSE2 capable CPU, but under control of OS which does not
  26 support SSE2 extentions. Even though you can manipulate the value
  27 programmatically, you most likely will find it more appropriate to set
  28 up an environment variable with the same name prior starting target
  29 application, e.g. 'env OPENSSL_ia32cap=0x10 apps/openssl', to achieve
  30 same effect without modifying the application source code.
  31 Alternatively you can reconfigure the toolkit with no-sse2 option and
  32 recompile.
  33
  34 =cut