Revision history for Perl extension Net::SSLeay.

1.94_04 2024-01-05
	- Use -DOPENSSL_API_COMPAT=908 when compiling SSLeay.xs to
	  suppress OpenSSL deprecation warnings.
	- Expose a number of functions that were added in recent
	  LibreSSL releases or were not otherwise exposed before:
	  - SSL(_CTX)_get/set_security_level in LibreSSL 3.6.0
	  - SSL(_CTX)_get/set_num_tickets in LibreSSL 3.5.0
	  - SSL(_CTX)_set_ciphersuites in LibreSSL 3.4.0
	  - EVP_PKEY_security_bits in LibreSSL 3.6.0
	  - SSL_CTX_set_keylog_callback in LibreSSL 3.5.0
	  - SSL_is_dtls in LibreSSL 3.3.2
	- Remove Tuure Vartiainen as an active contributor. Tuure's contributions were
	  instrumental in the transition from ad hoc testing to CI-based testing, which
	  has greatly improved Net-SSLeay's stability, reliability and compatibility.
	  Thanks for your contributions, Tuure!

1.93_03 2024-01-02
	- Pass RAND_seed()'s sole argument to the underlying RAND_seed() function in
	  libcrypto, rather than passing the value of a non-existent second argument.
	  Fixes GH-427. Thanks to cgf1 for the report.
	- Avoid explicit and implicit use of weak hash algorithms,
	  such as MD5 and SHA-1, in test suite. This allows tests
	  44_sess.t and 45_exporter.t to correctly work on systems
	  where crypto policies prohibit their direct use and TLS
	  versions that require them. An example of such a system is
	  Rocky Linux 9.2. Any Red Hat Enterprise Linux 9 and derived
	  system is likely to have similar behaviour.  Thanks to Paul
	  Howarth for the investigation and patches.
	- LibreSSL 3.8.0 release notes state: The POLICY_TREE and its
	  related structures and API were removed. The affected
	  Net::SSLeay functions are:
	  - X509_policy_level_get0_node
	  - X509_policy_level_node_count
	  - X509_policy_node_get0_parent
	  - X509_policy_node_get0_policy
	  - X509_policy_node_get0_qualifiers
	  - X509_policy_tree_free
	  - X509_policy_tree_get0_level
	  - X509_policy_tree_get0_policies
	  - X509_policy_tree_get0_user_policies
	  - X509_policy_tree_level_count
	  Patch by GitHub user orbea.
	- Add OpenSSL 3.1 and LibreSSL 3.7 minor releases to GitHub CI testing.
	  Update the previous minor releases to their latest versions. Add
	  NetBSD to BSDs job and update the other BSDs and Alpine Linux jobs to
	  cover additional and latest releases. Use the latest MacOS runners.
	- Expose SSL_CTX_set_client_hello_cb for setting a callback
	  the server calls when it processes a ClientHello. Expose the
	  following functions that can be called only from the
	  callback. None of these are available with LibreSSL.
	  - SSL_client_hello_isv2
	  - SSL_client_hello_get0_legacy_version
	  - SSL_client_hello_get0_random
	  - SSL_client_hello_get0_session_id
	  - SSL_client_hello_get0_ciphers
	  - SSL_client_hello_get0_compression_methods
	  - SSL_client_hello_get1_extensions_present
	  - SSL_client_hello_get_extension_order
	  - SSL_client_hello_get0_ext
	- Expose constants used by SSL_CTX_set_client_hello_cb related
	  functions.
	  - AD_ prefixed constants naming TLS alert codes for
	    returning from a ClientHello callback or where alert types
	    are used
	  - CLIENT_HELLO_ERROR, CLIENT_HELLO_RETRY and
	    CLIENT_HELLO_SUCCESS for returning from a ClientHello
	    callback
	  - TLSEXT_TYPE_ prefixed contants for naming TLS extension
	    types
	- Expose functions for setting up TLS PSK on the server
	  side. Only SSL_CIPHER_find is available with LibreSSL.
	  - SSL_use_psk_identity_hint
	  - SSL_CTX_use_psk_identity_hint
	  - SSL_set_psk_server_callback
	  - SSL_CTX_set_psk_server_callback
	  - SSL_set_psk_find_session_callback
	  - SSL_CTX_set_psk_find_session_callback
	  - SSL_SESSION_set1_master_key
	  - SSL_SESSION_set_cipher
	  - SSL_SESSION_set_protocol_version
	  - SSL_CIPHER_find
	- Expose NID_shake128, NID_shake256 and the rest of NID_sha* constants.
	- Expose functions for setting up TLS 1.3 PSK authentication
	  on the client side. Only SSL_SESSION_get0_cipher is
	  available with LibreSSL.
	  - SSL_set_psk_use_session_callback
	  - SSL_CTX_set_psk_use_session_callback
	  - SSL_CIPHER_get_handshake_digest
	  - SSL_SESSION_get0_cipher
	  - EVP_MD_get0_description
	  - EVP_MD_get0_name
	  - EVP_MD_get_type
	- Major documentation cleanup. Thanks to John Jetmore.
	- Add constants for specifying version field for certificates,
	  certificate requests and CRLs. Available in OpenSSL 3.0:
	  - X509_VERSION_1, X509_VERSION_2 and X509_VERSION_3
	  - X509_REQ_VERSION_1, X509_REQ_VERSION_2 and X509_REQ_VERSION_3
	  - X509_CRL_VERSION_1 and X509_CRL_VERSION_2
	- Remove conditional compilation checks from SSLeay.xs and
	  compatilibty notes from SSLeay.pod for OpenSSL versions
	  earlier than 0.9.8. This includes all 0.9.7 and earlier
	  releases down to 0.9.3a. Update tests respectively.
	- Add OpenSSL 3.2 and LibreSSL 3.8 minor releases to GitHub CI
	  testing. Update existing OpenSSL releases to 1.1.1w, 3.0.12
	  and 3.1.4.
	- Support compiling SSLeay.xs with a C++ compiler. Thanks to
	  James E Keenan and GitHub user twata1 for suggesting this,
	  testing and providing detailed test reports. Tested with GCC
	  13 g++, Clang 17 clang++ and Visual Studio Community 2022
	  C++ compilers. Discussion in GH-425 and GH-438.
	- Add constants for OPENSSL_init_crypto and related functions:
	  - CONF_MFLAGS_DEFAULT_SECTION
	  - CONF_MFLAGS_IGNORE_ERRORS
	  - CONF_MFLAGS_IGNORE_MISSING_FILE
	  - CONF_MFLAGS_IGNORE_RETURN_CODES
	  - CONF_MFLAGS_NO_DSO
	  - CONF_MFLAGS_SILENT
	  - OPENSSL_INIT_ADD_ALL_CIPHERS
	  - OPENSSL_INIT_ADD_ALL_DIGESTS
	  - OPENSSL_INIT_ASYNC
	  - OPENSSL_INIT_ATFORK
	  - OPENSSL_INIT_ENGINE_AFALG
	  - OPENSSL_INIT_ENGINE_CAPI
	  - OPENSSL_INIT_ENGINE_CRYPTODEV
	  - OPENSSL_INIT_ENGINE_DYNAMIC
	  - OPENSSL_INIT_ENGINE_OPENSSL
	  - OPENSSL_INIT_ENGINE_PADLOCK
	  - OPENSSL_INIT_ENGINE_RDRAND
	  - OPENSSL_INIT_LOAD_CONFIG
	  - OPENSSL_INIT_LOAD_CRYPTO_STRINGS
	  - OPENSSL_INIT_LOAD_SSL_STRINGS
	  - OPENSSL_INIT_NO_ADD_ALL_CIPHERS
	  - OPENSSL_INIT_NO_ADD_ALL_DIGESTS
	  - OPENSSL_INIT_NO_ATEXIT
	  - OPENSSL_INIT_NO_LOAD_CONFIG
	  - OPENSSL_INIT_NO_LOAD_CRYPTO_STRINGS
	  - OPENSSL_INIT_NO_LOAD_SSL_STRINGS
	- Expose functions for OpenSSL libcrypto and libssl
	  initialisation, configuration and deinitialisation.
	  These are available in OpenSSL 1.1.0 and later:
	  - OPENSSL_init_ssl and OPENSSL_init_crypto
	  - OPENSSL_cleanup, also in LibreSSL 3.6.0
	  - OPENSSL_INIT_new and OPENSSL_INIT_free
	  - OPENSSL_INIT_set_config_filename
	  - OPENSSL_INIT_set_config_appname
	  - OPENSSL_INIT_set_config_file_flags
	- Add new test file 23_openssl_init.t for OPENSSL_init_ssl and
	  related functions.
	- Support finding OpenSSL libraries using
	  ExtUtils::PkgConfig. Thanks to Paul Howarth for the patch.
	- Fix a number of cases where variables were declared after
	  code triggering Gcc and Clang warning
	  -Wdeclaration-after-statement. This is supported by C
	  language version C99 and used by Perl 5.35.5 and
	  later. SSLeay.xs is likely compiled with compilers that do
	  not support this, therefore such constructs are avoided in
	  SSLeay.xs. Thanks to GitHub user bulk88 for the patch.
	- Fix _CRT_SECURE_NO_DEPRECATE warning on Windows. Fix OpenSSL
	  library file path detection loop in Makefile.PL. Both thanks
	  to bulk88.
	- Update Shining Light OpenSSL detection to work with OpenSSL
	  1.1.1w, 3.0.12, 3.1.4 and 3.2.0 installers. Caveats: when
	  both 32bit and 64bit versions are installed, OpenSSL library
	  path detection may pick the wrong version. Static
	  compilation needs seems not to work with the these
	  versions. Thanks to bulk88 for the initial updates.
	- Tone down Makefile.PL and README warning against mixing
	  compilers and flags when compiling OpenSSL, Perl and
	  Net::SSLeay. This may still be a requirement on some
	  platforms, but, for example, with Linux and macOS mixing
	  clang and gcc appears to work.
	- Add general installation instructions in README. Thanks to
	  GitHub user viviparous. Update README and README.OSX.

1.93_02 2023-02-22
	- Update ppport.h to version 3.68. This eliminates thousands of
	  compound-token-split-by-macro compiler warnings when building Net-SSLeay with
	  Clang 12 or greater. Partially fixes GH-383.
	- Silence compound-token-split-by-macro warnings when building Net-SSLeay with
	  Clang 12 or greater. Fixes the remainder of GH-383.
	- When building Net-SSLeay, search for the openssl binary in the same directory
	  in which Perl is installed (i.e. $Config{prefix}/bin/). Thanks to Henrik
	  Grimler for the patch.
	- Expose EVP_PKEY_security_bits. Thanks to Felipe Gasper.
	- Major update to Gihub Actions configuration. Thanks to Felipe Gasper.
	  New testing targets are:
	    - OpenSSL and LibreSSL on Alpine Linux on i386, x390x, arm32v6,
	      ar32v7 and arm64v8 architectures.
	    - OpenSSL and LibreSSL on Ubuntu on i386, x390x, ar32v7 and arm64v8
	      architectures.
	    - OpenSSL on FreeBSD 13.0, not enabled yet because of GH #272 and #394
	    - LibreSSL on FreeBSD 13.0
	    - LibreSSL on OpenBSD 6.9
	    - LibreSSL on OpenBSD 7.1
	    - Cygwin on x86_64
	- Fix compilation failure using cl. Microsoft cl compiler do
	  not like when preprocessor directives are inside a
	  macro. Fixes GH-403. Thanks to Jean-Damien Durand.
	- Update CTX_use_PKCS12_file() and CTX_use_PKCS12_file() to
	  use BIO functions for avoiding "no OPENSSL_Applink" runtime
	  errors. Fixes GH-281 and RT#101638. Thanks to Jean-Damien
	  Durand.
	- Add to README.Win32 more information about OPENSSL_Applink
	  and how it may be needed with FILE pointers and POSIX/Unix
	  fds. Recommended method is to avoid them and use OpenSSL BIO
	  functions instead. Update SSLeay.pod with alternatives to
	  Net::SSLeay::SESSION_print_fp(). Closes GH-411.
	- Refactor variable declarations in RSA_generate_key to allow SSLeay.xs to
	  compile under -Werror=declaration-after-statement. Fixes GH-407. Thanks to
	  dharanlinux for the report.
	- Fix memory leaks after calls to X509_get_ext_d2i. Thanks to Anton Borowka.
	- Documentation fix: Correct CRL revocation reasons in
	  P_X509_CRL_add_revoked_serial_hex(). Closes GH-397. Reported
	  by Marc Reisner.
	- Support stable releases of LibreSSL 3.5 and 3.6.
	- Update callback set by SSL_set_session_secret_cb to adjust
	  master secret's length. This is needed with OpenSSL 1.1.1
	  and later that provide buffer that is now longer than 48
	  octets. Fix Net::SSLeay::get_keyblock_size() size
	  calculation with AEAD ciphers. These functions were
	  originally added to OpenSSL and Net::SSLeay for
	  EAP-FAST. These changes allow EAP-FAST to work with AEAD
	  ciphers and with OpenSSL versions 1.1.1 and later.
	- Remove code guarded by obsolete
	  SSL_F_SSL_SET_HELLO_EXTENSION #ifdef. This was used by the
	  initial EAP-FAST related OpenSSL patch which was never part
	  of the OpenSSL distribution.
	- PEM_get_string_PrivateKey() currently uses DES-CBC as its
	  default encryption algorithm. Test 33_x509_create_cert.t now
	  skips testing the default algorithm on systems that support
	  providers but don't have the legacy provider available. One
	  such system is FreeBSD 13.0 with OpenSSL which was added as
	  disabled in GitHub actions by PR GH-402 but can now be
	  enabled. Long term fix is to replace DES-CBC with a modern
	  cipher. Allows closing GH-394.

1.93_01 2022-03-20
	- LibreSSL 3.5.0 has removed access to internal data
	  structures: Use X509_get0_tbs_sigalg() and
	  OCSP_SINGLERESP_get0_id() like in OpenSSL 1.1. Also use
	  RSA_get0... with RSA_get_key_parameters(). Thanks to
	  Alexander Bluhm.
	- Expose SSL_CTX_get_min_proto_version(),
	  SSL_CTX_get_max_proto_version(), SSL_get_min_proto_version()
	  and SSL_get_max_proto_version() with LibresSSL 3.4.0 and
	  later. Thanks to Alexander Bluhm.
	- Update tests 07_sslecho.t and 44_sess.t to work around
	  failures seen on Windows with Perls earlier than 5.20. For
	  the details, see GH-356 and look for CloseHandle() in Perl
	  5.20.0 changelog. Thanks to GitHub user twata1 for the
	  report and additional help.
	- Alexander's recent work with RSA_get_key_parameters(),
	  allows to make it available with all OpenSSL versions. It
	  was already available with versions earlier than 1.1.0.
	- Expose BN_dup(), BN_clear(), BN_clear_free() and BN_free().
	- Use PTR2IV instead of direct cast to IV to fix compilation
	  warning with SSLeay.xs internal function bn2sv().
	- Expose X509_CRL_get0_lastUpdate(),
	  X509_CRL_get0_nextUpdate(), X509_CRL_set1_lastUpdate() and
	  X509_CRL_set1_nextUpdate() that became available with
	  OpenSSL 1.1.0 and LibreSSL 2.7.0. These, and the respective
	  deprecated _get/set_ aliases, are available with all OpenSSL
	  and LibreSSL versions. Fixes part of RT#124371.
	- Note in documentation that the X509_CRL_get* functions
	  return a pointer to time structure that should be considered
	  read-only.
	- Use ASN1_STRING_get0_data() instead of ASN1_STRING_data() to
	  avoid compile time deprecation warnings. Partly fixes
	  RT#124371.
	- Add the following constants from Current OpenSSL master branch:
	  - SSL_ASYNC_PAUSED
	  - SSL_ASYNC_NO_JOBS
	  - SSL_CLIENT_HELLO_CB
	  - SSL_ERROR_WANT_ASYNC
	  - SSL_ERROR_WANT_ASYNC_JOB
	  - SSL_ERROR_WANT_CLIENT_HELLO_CB
	  - SSL_ERROR_WANT_RETRY_VERIFY
	  - SSL_MODE_ASYNC
	  - SSL_MODE_NO_AUTO_CHAIN
	  - SSL_OP_ALLOW_CLIENT_RENEGOTIATION
	  - SSL_OP_CLEANSE_PLAINTEXT
	  - SSL_OP_DISABLE_TLSEXT_CA_NAMES
	  - SSL_OP_ENABLE_KTLS
	  - SSL_OP_IGNORE_UNEXPECTED_EOF
	  - SSL_OP_NO_EXTENDED_MASTER_SECRET
	  - SSL_RETRY_VERIFY
	  - SSL_SESS_CACHE_UPDATE_TIME
	  - X509_TRUST_DEFAULT
	  - X509_V_ERR_AUTHORITY_KEY_IDENTIFIER_CRITICAL
	  - X509_V_ERR_CA_BCONS_NOT_CRITICAL
	  - X509_V_ERR_CA_CERT_MISSING_KEY_USAGE
	  - X509_V_ERR_EC_KEY_EXPLICIT_PARAMS
	  - X509_V_ERR_EMPTY_SUBJECT_ALT_NAME
	  - X509_V_ERR_EMPTY_SUBJECT_SAN_NOT_CRITICAL
	  - X509_V_ERR_EXTENSIONS_REQUIRE_VERSION_3
	  - X509_V_ERR_ISSUER_NAME_EMPTY
	  - X509_V_ERR_KU_KEY_CERT_SIGN_INVALID_FOR_NON_CA
	  - X509_V_ERR_MISSING_AUTHORITY_KEY_IDENTIFIER
	  - X509_V_ERR_MISSING_SUBJECT_KEY_IDENTIFIER
	  - X509_V_ERR_NO_ISSUER_PUBLIC_KEY
	  - X509_V_ERR_PATHLEN_INVALID_FOR_NON_CA
	  - X509_V_ERR_PATHLEN_WITHOUT_KU_KEY_CERT_SIGN
	  - X509_V_ERR_SIGNATURE_ALGORITHM_INCONSISTENCY
	  - X509_V_ERR_SIGNATURE_ALGORITHM_MISMATCH
	  - X509_V_ERR_SUBJECT_KEY_IDENTIFIER_CRITICAL
	  - X509_V_ERR_SUBJECT_NAME_EMPTY
	  - X509_V_ERR_UNSUPPORTED_SIGNATURE_ALGORITHM
	- Expose X509_get0_notBefore(), X509_getm_notBefore()
	  X509_get0_nextAfter() and X509_getm_nextAfter() that became
	  available with OpenSSL 1.1.0 and LibreSSL 2.7.0. These, and
	  the deprecated _get functions, are available, as aliases
	  when needed, with all OpenSSL and LibreSSL versions. Fixes
	  GH-367.
	- Only export the TLSv1*_method() functions when support for the respective TLS
	  version is available in the underlying libssl library. This allows
	  Net::SSLeay to be built against libssl libraries that were compiled without
	  support for old TLS versions.

1.92 2022-01-12
	- New stable release incorporating all changes from developer releases 1.91_01
	  to 1.91_03.
	- Summary of major changes since version 1.90:
	  - Net::SSLeay now supports stable releases of OpenSSL 3.0.
	    - OpenSSL 3.0.0 introduces the concept of "providers", which contain
	      cryptographic algorithm implementations. Many outdated, deprecated and/or
	      insecure algorithms have been moved to the "legacy" provider, which may
	      need to be loaded explicitly in order to use them with Net::SSLeay. See
	      "Low level API: OSSL_LIB_CTX and OSSL_PROVIDER related functions" in the
	      Net::SSLeay module documentation for details.
	    - Net::SSLeay's built-in PEM_get_string_PrivateKey() function depends on
	      algorithms that have moved to the legacy provider described above; if
	      OpenSSL has been compiled without the legacy provider, the tests
	      t/local/33_x509_create_cert.t and t/local/63_ec_key_generate_key.t will
	      fail when the test suite is run.
	    - TLS 1.1 and below may only be used at security level 0 as of OpenSSL
	      3.0.0; if a minimum required security level is imposed (e.g. in an
	      OpenSSL configuration file managed by the operating system), the tests
	      t/local/44_sess.t and t/local/45_exporter.t will fail when the test suite
	      is run.
	  - Net::SSLeay now supports stable releases of LibreSSL from the 3.2 - 3.4
	    series (with the exception of 3.2.2 and 3.2.3 - see "COMPATIBILITY" in the
	    Net::SSLeay module documentation for details).
	    - The TLS 1.3 implementation in LibreSSL 3.1 - 3.3, parts of which are
	      enabled by default, is not fully compatible with the libssl API and may
	      not function as expected with Net::SSLeay; see "KNOWN BUGS AND CAVEATS"
	      in the Net::SSLeay module documentation for details.
	  - A number of new libcrypto/libssl constants and functions are now exposed,
	    including SSL_CTX_set_keylog_callback() and SSL_CTX_set_msg_callback(),
	    which are helpful when debugging TLS handshakes. See the release notes for
	    the 1.91 developer releases below for a full list of newly-exposed
	    constants and functions.

1.91_03 2022-01-10
	- Avoid misclassifying Clang as GCC in Test::Net::SSLeay's can_thread()
	  function. This fixes test failures in 61_threads-cb-crash.t and
	  62_threads-ctx_new-deadlock.t on OpenBSD and FreeBSD (and possibly other OSes
	  too). Fixes GH-350.
	- Add the following constants for OpenSSL_version():
	  - OPENSSL_CPU_INFO
	  - OPENSSL_FULL_VERSION_STRING
	  - OPENSSL_MODULES_DIR
	  - OPENSSL_VERSION_STRING
	  These constants are new in OpenSSL 3.0.0 release.
	- Update test 03_use.t to print information returned by the new constants.
	- Add more information to 03_use.t print output, including printing
	  OPENSSL_VERSION_NUMBER as a 32bit hex number.
	- Add the following constants for OPENSSL_info() added in OpenSSL 3.0.0.
	  - OPENSSL_INFO_CONFIG_DIR
	  - OPENSSL_INFO_CPU_SETTINGS
	  - OPENSSL_INFO_DIR_FILENAME_SEPARATOR
	  - OPENSSL_INFO_DSO_EXTENSION
	  - OPENSSL_INFO_ENGINES_DIR
	  - OPENSSL_INFO_LIST_SEPARATOR
	  - OPENSSL_INFO_MODULES_DIR
	  - OPENSSL_INFO_SEED_SOURCE
	- Expose OPENSSL_info(), OPENSSL_version_major(),
	  OPENSSL_version_minor(), OPENSSL_version_patch(),
	  OPENSSL_version_pre_release() and
	  OPENSSL_version_build_metadata() added in OpenSSL
	  3.0.0. Update 03_use.t diagnostics and 04_basic.t tests to
	  use these functions.
	- Clarify documentation of OpenSSL_version_num(), SSLeay(),
	  SSLeay_version() and OpenSSL_version().
	- Add notes to OpenSSL_version_num() and SSLeay() on how to
	  determine if the library is OpenSSL or LibreSSL and how to
	  interpret the version number these functions return.
	- Add constants OPENSSL_VERSION_MAJOR, OPENSSL_VERSION_MINOR
	  and OPENSSL_VERSION_PATCH. Update
	  OPENSSL_version_major/minor/patch documentation to describe
	  how these library functions relate to Net-SSLeay compile
	  time constants. Add tests to verify the constants and
	  functions return equal values.

1.91_02 2021-12-29
	- On OpenVMS, detect vendor SSL111 product based on OpenSSL 1.1.x.
	- Cast the return value of OCSP_SINGLERESP_get0_id to fix a
	  const/non-const mismatch warning that broke the build on OpenVMS.
	- Create SSL_CTXs with Test::Net::SSLeay's new_ctx() function for tests that
	  are broken with LibreSSL 3.2. Partially fixes GH-232.
	- In 36_verify.t, account for the presence of the X509_V_FLAG_LEGACY_VERIFY
	  flag (signalling the use of the legacy X.509 verifier) in LibreSSL 3.2
	  versions from 3.2.4 onwards. Fixes the remainder of GH-232.
	- Note in the Net::SSLeay documentation that the TLS 1.3 implementation in
	  LibreSSL 3.1 - 3.3, parts of which are enabled by default, is not
	  libssl-compatible. See the "KNOWN BUGS AND CAVEATS" section of
	  lib/Net/SSLeay.pod for details.
	- Add constants for, but not limited to,
	  SSL_CTX_set_msg_callback and SSL_set_msg_callback functions:
	  SSL3_RT_* for record content types, SSL3_MT_* for Handshake
	  and ChangeCipherSpec message types, SSL2_VERSION to
	  complement the list of existing SSL and TLS version
	  constants and SSL2_MT_* for SSLv2 Handshake messages.
	- Expose SSL_CTX_set_keylog_callback and
	  SSL_CTX_get_keylog_callback available with OpenSSL 1.1.1pre1
	  and later.
	- Enhance 10_rand.t RAND_file_name tests: tests are no longer
	  affected by the runtime environment variables, HOME and
	  RANDFILE. These variables are insted controlled by the tests
	  with local %ENV. Problems related to RAND_file_name were
	  discussed in Github issue GH-152, and there might still be
	  cases when, for example, setuid is used because of OpenSSL's
	  use of glibc secure_getenv() and related functions. Address
	  RAND_file_name differences between OpenSSL versions. Note in
	  SSLeay.pod that RAND_file_name() can return undef with
	  LibreSSL and recent OpenSSL versions.
	- Removed the following exportable symbols from SSLeay.pm:
	  - SESSION, clear_error and err have never been defined.
	  - add_session, flush_sessions and remove_session were
	    removed in Net::SSLeay 1.04
	  - Undocumented X509_STORE_CTX_set_flags() was removed in
	    Net::SSLeay 1.37 when X509_VERIFY_PARAM_* functions were
	    added. These are preferred over directly setting the flags.
	- Clarified Changes entry for release 1.75 to state that
	  CTX_v2_new is not removed from Net::SSLeay. SSLv2 is
	  completely removed in OpenSSL 1.1.0.
	- Beginning with OpenSSL 3.0.0-alpha17, SSL_CTX_get_options()
	  and related functions return uint64_t instead of long. For
	  this reason constant() in constant.c and Net::SSLeay must
	  also be able to return 64bit constants. Add uint64_t
	  definitions to typemap file and update constant() and
	  options functions to use uint64_t with OpenSSL 3.0.0 and
	  later when Perl is compiled with 64bit integers. With 32bit
	  integers, the functions remain as they are: constant()
	  functions return double and options functions return
	  long. This partially fixes GH-315, 32bit integer Perls need
	  to be handled separately.
	- Work around macOS Monterey build failure during 'perl
	  Makefile.PL' that causes perl to exit with 'WARNING:
	  .../perl is loading libcrypto in an unsafe way' or similar
	  message. This fixes GH-329. Thanks to Daniel J. Luke for the
	  report and John Napiorkowski for additional help.

1.91_01 2021-10-24
	- Correct X509_STORE_CTX_init() return value to integer. Previous
	  versions of Net::SSLeay return nothing.
	- Update tests to call close() to avoid problems seen with
	  test 44_sess.t, and possibly other tests, running on older
	  Windows Perl versions. Also add some missing calls in tests
	  to shutdown and free ssl structures.
	- Fix multiple formatting errors in the documentation for Net::SSLeay.
	  Thanks to John Jetmore.
	- Check for presence of libssl headers in Makefile.PL, and exit with an
	  error instead of generating an invalid Makefile if they cannot be found.
	  Fixes RT#105189. Thanks to James E Keenan for the report.
	- Added support for SSL_CTX_set_msg_callback/SSL_set_msg_callback
	  Thanks to Tim Aerts.
	- Adjust time in ASN1_TIME_timet based on current offset to GMT to
	  address GH-148. Thanks to Steffen Ullrich.
	- Multiple updates to tests to match OpenSSL 3.0 behaviour.
	  Thanks to Michal Josef Špaček.
	- OpenSSL 3.0 related changes in tests include:
	  - TLSv1 and TLSv1.1 require security level 0 starting with 3.0 alpha 5.
	  - SSL_CTX_set_ciphersuites() and SSL_set_ciphersuites() ignore
	    unknown ciphersuites starting with 3.0 alpha 11.
	  - Error code and error string packing and formatting changes.
	  - PEM_get_string_PrivateKey default algorithm requires legacy provider.
	- See OpenSSL manual page migration_guide(7) for more information about
	  changes in OpenSSL 3.0.
	- Automatically detect OpenSSL installed via Homebrew on ARM-based macOS
	  systems. Thanks to Graham Knop for the patch.
	- Account for the divergence in TLSv1.3 ciphersuite names between OpenSSL and
	  LibreSSL, which was causing failures of some TLSv1.3 tests with LibreSSL.
	- In 36_verify.t, account for the presence of the X509_V_FLAG_LEGACY_VERIFY
	  flag (signalling the use of the legacy X.509 verifier) in LibreSSL 3.3.2 and
	  above.
	- In 43_misc_functions.t, account for the fact that LibreSSL 3.2.0 and above
	  implement TLSv1.3 without exposing a TLS1_3_VERSION constant.
	- Expose OpenSSL 3.0 functions
	  OSSL_LIB_CTX_get0_global_default, OSSL_PROVIDER_load,
	  OSSL_PROVIDER_try_load, OSSL_PROVIDER_unload,
	  OSSL_PROVIDER_available, OSSL_PROVIDER_do_all
	  OSSL_PROVIDER_get0_name and OSSL_PROVIDER_self_test.
	  Add test files 22_provider.t, 22_provider_try_load.t and
	  22_provider_try_load_zero_retain.t.
	- With OpenSSL 3.0 and later, the legacy provider is loaded in
	  33_x509_create_cert.t to allow PEM_get_string_PrivateKey to
	  continue working until its default encryption method is
	  updated. Fixes GH-272 and closes GH-273.
	- Remove the test suite's optional dependency on the non-core modules
	  Test::Exception, Test::NoWarnings and Test::Warn. Tests that verify
	  Net::SSLeay's behaviour when errors occur are now executed regardless of the
	  availability of these modules.
	- Fully automate the process of changing the list of constants exported by
	  Net::SSLeay. Fixes GH-313.
	- Perform function autoloading tests in the test suite. Fixes GH-311.
	- In 36_verify.t, account for the fact that the X509_V_FLAG_LEGACY_VERIFY flag
	  (signalling the use of the legacy X.509 verifier) is no longer exposed as of
	  LibreSSL 3.4.1. Fixes GH-324.

1.90 2021-01-21
	- New stable release incorporating all changes from developer releases
	  1.89_01 to 1.89_05.
	- Summary of major changes since version 1.88:
	  - Formalised libssl version support policy: all stable versions of OpenSSL
	    in the 0.9.8 - 1.1.1 branches (with the exception of 0.9.8 - 0.9.8b) and
	    all stable releases of LibreSSL in the 2.0 - 3.1 series are supported.
	    The LibreSSL 3.2 series is not yet fully supported because its TLSv1.3
	    implementation is not currently libssl-compatible.
	  - Added support for LibreSSL on Windows when built with Visual C++.
	  - Exposed P_X509_CRL_add_extensions, several SSL_CIPHER functions, and
	    several stack functions.
	  - Fixed crashes in the callback functions CTX_set_next_proto_select_cb and
	    CTX_set_alpn_select_cb.
	  - The test suite is now compatible with OpenSSL 1.1.1e onwards, as well as
	    OpenSSL security level 2 (the default on many Linux distributions).

1.89_05 2021-01-21
	- Expose SSL_get_ciphers. Thanks to github user dylc5190.
	- Expose SSL_CIPHER_get_version and fix SSL_CIPHER_description
	  and SSL_CIPHER_get_bits. Also fixed and enhanced
	  documentation for these and related SSL_CIPHER functions.
	- Clarify libssl version support policy: all stable versions of OpenSSL in
	  the 0.9.8 - 1.1.1 branches (with the exception of 0.9.8 - 0.9.8b) and all
	  stable releases of LibreSSL in the 2.0 - 3.1 series are supported.
	- Direct bug reports to the GitHub repository, since rt.cpan.org will shut
	  down on 2021-03-01.

1.89_04 2021-01-13
	- Fix crashes in the callback functions CTX_set_next_proto_select_cb() and
	  CTX_set_alpn_select_cb() caused by the use of a pointer returned by
	  SSL_select_next_proto() which may already have been freed under certain
	  circumstances. Fixes GH-222. Thanks to dylc5190 for the report.
	- Remove the dependency on the AES128-SHA cipher suite in the test script
	  64_ticket_sharing.t. Fixes GH-231.
	- Remove checks and warnings in Makefile.PL relating to the use of RSAref,
	  which was removed from OpenSSL in version 0.9.7.

1.89_03 2020-12-12
	- Expose the following functions:
	  - X509_STORE_CTX_get0_cert, X509_STORE_CTX_get1_chain
	  - sk_X509_pop, sk_X509_shift, sk_X509_unshift,
	  - sk_X509_insert, sk_X509_delete, sk_x509_value, sk_X509_num
	  Thanks to Dan Freed.
	- Correct the minimum OpenSSL version required for the following functions
	  to be made available (previously they were all declared to be present in
	  1.1.0-pre1, which caused Net::SSLeay to crash at run-time when built
	  against OpenSSL versions between 1.1.0-pre1 and 1.1.0-pre3):
	  - CTX_set_max_proto_version (added in 1.1.0-pre2)
	  - CTX_set_min_proto_version (added in 1.1.0-pre2)
	  - SESSION_up_ref (added in 1.1.0-pre4)
	  - set_max_proto_version (added in 1.1.0-pre2)
	  - set_min_proto_version (added in 1.1.0-pre2)
	- Correct the minimum OpenSSL version required for get_SSL_CTX and SSL_ctrl
	  to be made available (previously they were declared to be present from
	  0.9.8f onwards, when in reality they are available in all 0.9.8 versions).
	- Replace the PKI used by the test suite with one generated by the
	  generate-test-pki helper script. All entities in the new PKI have 2048-bit
	  RSA private keys and CSRs, certificates and CRLs with SHA-256 digests,
	  allowing the test suite to execute under OpenSSL security level 2 (now the
	  default security level for OpenSSL in many Linux distributions).
	- Initialise libssl consistently in the test suite.
	- Don't rely on the availability of specific SSL/TLS protocol versions or
	  cipher suites in the test suite; instead, dynamically select from any of
	  the available protocol versions and cipher suites permitted by libssl.
	  Fixes RT#132425. Thanks to Graham Ollis for the initial report of the test
	  suite failing on Ubuntu 20.04 with the Ubuntu-packaged OpenSSL, whose
	  configuration forbids the use of TLSv1.1 and below at run-time by default.

1.89_02 2020-08-07
	- Add support for the P_X509_CRL_add_extensions function. Thanks to
	  Manuel Mausz for the patch.
	- X509_get_subjectAltNames now knows how to return
	  GEN_RID. The returned value is an ASN OID in text format
	  with current maximum length of 2500 characters. Updated
	  t/local/33_x509_create_cert.t to use GEN_RID and all other
	  supported types with certificate request and signed
	  certificate. These relate to GitHub issue GH-149 opened by
	  s482dcaw.
	- Support for 64-bit Windows versions of OpenSSL from 1.0.0-beta1
	  through to 1.0.0b has been withdrawn due to malfunctions occurring in
	  Perl programs that use fork(). This mainly affects users of Strawberry
	  Perl x64 5.12.3.20180709, which ships with OpenSSL 1.0.0-beta4.
	  Affected users should build Net-SSLeay against OpenSSL 1.0.0c or
	  above; users of Strawberry Perl x64 5.12.3.20180709 may instead find
	  it easier to upgrade to Strawberry Perl x64 5.14.4.1 or above. See
	  https://github.com/radiator-software/p5-net-ssleay/issues/189 for more
	  information.

1.89_01 2020-03-22
	- Fix the repository URL in Makefile.PL (git:// rather than git@),
	  which was preventing it from being added to META.json. Thanks to
	  Dan Book.
	- When building Net-SSLeay, exit if an OpenSSL executable cannot be
	  found in PATH. Fixes RT#131060. Thanks to Nigel Horne for the report.
	- Remove non-OCSP external tests, many of which unnecessarily duplicate
	  local tests or fail for reasons outside of our control. Fixes
	  RT#129542. Thanks to Andreas Vögele for the bug report that
	  ultimately led to this change.
	- Add support for LibreSSL on Windows when built with Visual C++.
	  Thanks to Graham Ollis for the patch.
	- In SSL_CTX_free() and SSL_free(), clean callback-related data from
	  the global hash after freeing ctx, not before. This allows callbacks
	  to be executed during freeing. Thanks to Steffen Ullrich for the
	  patch.
	- t/local/07_sslecho.t started failing with OpenSSL 1.1.1e. Updated
	  the test file with missing calls to Net::SSLeay::shutdown(). Also
	  added one call in SSLeay.pm sslcat() function. Enabling SSLeay trace
	  level 3 showed 'unexpected eof while reading' errors which were added
	  to OpenSSL with commit db943f43. This fixes GitHub issue GH-160
	  reported by Brett T. Warden.
	- t/local/01_pod.t now requires Test::Pod 1.41 to work with Pod syntax
	  used with Net::SSLeay 1.88 and later. This fixes GitHub issue GH-147
	  reported by Ulrik Haugen.

1.88 2019-05-10
	- New stable release incorporating all changes from developer
	  releases 1.86_01 to 1.86_11.
	- From this release, Net-SSLeay is switching to an "odd/even"
	  developer/stable release version numbering system, like that of
	  many core modules (e.g. ExtUtils::MakeMaker): developer releases
	  will have an odd minor version number (and the usual "_xx" suffix),
	  and stable releases will have an even minor version number. This
	  means there is no Net-SSLeay 1.87.
	- Summary of major changes since version 1.85:
	  - Mike McCauley has stepped down as maintainer. The new maintainers
	    are Chris Novakovic, Heikki Vatiainen and Tuure Vartiainen.
	  - The source code has moved from the now-defunct Debian Subversion
	    server (alioth.debian.org) to GitHub
	    (https://github.com/radiator-software/p5-net-ssleay).
	  - Net-SSLeay is provided under the terms of the Artistic License
	    2.0 - this has been the case since version 1.66, but references
	    to other licenses remained in the source code, causing ambiguity.
	  - Perl 5.8.1 or newer is now required to use Net-SSLeay. This has
	    already been the case for some time in practice, as the test
	    suite hasn't fully passed on Perl 5.6 for several years.
	  - Much-improved compatibility with OpenSSL 1.1.1, and improved
	    support for TLS 1.3.
	  - Fixed a long-standing bug in cb_data_advanced_put() that caused
	    memory leaks when callbacks were frequently added and removed.
	  - Support in the test suite for "hardened" OpenSSL configurations
	    that set a default security level of 2 or higher (e.g., in the
	    OpenSSL packages that ship with recent versions of Debian, Fedora
	    and Ubuntu).

1.86_11 2019-05-08
	- Clarified Net-SSLeay's licensing terms: the module distribution has
	  been released under the terms of the Artistic License 2.0 since
	  version 1.66; references to other licenses have been removed. Fixes
	  RT#106314. Thanks to Kent Fredric for pointing out the ambiguity.
	- Replace the HTTPS hosts in the external tests (some of which were
	  no longer online) with more resilient ones. Closes issue #26.

1.86_10 2019-05-04
	- Use locally-generated certificate chain in local tests rather
	  than the Twitter one, which changes regularly and breaks the
	  test suite unnecessarily. Fixes RT#129201. Thanks to Petr Písař
	  for the report and patch, and Steffen Ullrich for an alternative
	  patch suggestion.
	- In t/local/09_ctx_new.t, rather than checking that the functions
	  (CTX_)get_min_proto_version and (CTX_)get_max_proto_version return
	  0x0000 (indicating the lowest and highest versions supported by
	  libssl respectively, which is not the case if a run-time
	  configuration is enforcing a different minimum or maximum), just
	  check whether the returned value is one of those mentioned on the
	  SSL_CTX_set_min_proto_version(3) man page. Partially fixes
	  RT#128025. Thanks to Slaven Rezić and Dmytro Zagashev for the
	  downstream reports.
	- Move from 1024-bit keys/certificates to 2048-bit keys/certificates
	  across the entire test suite. This removes the need to manually
	  set the security level to 1 in tests that used the old keys, and
	  fixes large numbers of test failures on modern Linux distributions
	  that set the minimum OpenSSL security level to 2. Fixes RT#126270
	  and the remainder of RT#128025. Thanks to Petr Písař and Slaven
	  Rezić for the downstream reports.
	- In t/local/06_tcpecho.t and t/local/07_sslecho.t, connect to
	  127.0.0.1 instead of localhost. This fixes these tests when
	  executed inside a network sandbox that disrupts the behaviour of
	  gethostbyname(). Fixes RT#128207. Thanks to Kent Fredric for the
	  downstream report.

1.86_09 2019-03-12
	- Add missing files to MANIFEST that prevented tests from passing
	  when installing from the 1.86_08 release tarball.

1.86_08 2019-03-12
	- Add and fix functions needed to properly implement client
	  side session reuse for TLS 1.3 with using
	  CTX_sess_set_new_cb. Newly exposed functions:
	  SSL_SESSION_dup and SSL_SESSION_up_ref.
	  Fixed functions: i2d_SSL_SESSION and d2i_SSL_SESSION.
	  Thanks to Steffen Ullrich.
	- Add functions functions to allow reading multiple pems from
	  file and creating untrusted chain: These functions allow you
	  to:
	  - Read in a PEM file with multiple certificates as a
	    STACK_OF(X509_INFO)
	  - Determine the size of the STACK_OF(X509_INFO) and value at
	    an index, which allows you to loop over the stack.
	  - Retrieve the X509 structure from each X509_INFO structure
	    in the stack.
	  Then you can create a new STACK_OF(X509) and push the X509
	  structures onto the new stack. You can then pass this
	  STACK_OF(X509) to X509_STORE_CTX_init which will allow you
	  to add additional untrusted certificates to the chain for
	  verification. Exposed functions are:
	  PEM_X509_INFO_read_bio
	  sk_X509_INFO_num
	  sk_X509_INFO_value
	  sk_X509_INFO_free
	  sk_X509_new_null
	  sk_X509_free
	  sk_X509_push
	  New function implemented by Net::SSLeay:
	  P_X509_INFO_get_x509
	  Thanks to Marc Reisner.
	- Add functions and constants that are necessary to verify a
	  certificate using a hash directory outside of an SSL/TLS
	  connection. Newly exposed functions:
	  X509_STORE_CTX_init
	  X509_STORE_CTX_free
	  X509_STORE_new
	  X509_STORE_free
	  X509_STORE_add_lookup
	  X509_LOOKUP_hash_dir
	  X509_LOOKUP_add_dir
	  Newly exposed constants:
	  X509_FILETYPE_ASN1
	  X509_FILETYPE_DEFAULT
	  X509_FILETYPE_PEM
	  Thanks to Marc Reisner.
	- Declare n_a in ssleay_set_psk_client_callback_invoke and
	  ssleay_ctx_set_psk_client_callback_invoke to avoid a compilation
	  error with Perl versions below 5.8.8. Fixes RT#128030. Thanks to
	  Graham Ollis for the report.
	- Add X509_get0_serialNumber. Thanks to Marc Reisner.
	- Enable Travis CI for LibreSSL 2.2.1, 2.7.5, 2.8.3 and 2.9.0
	  on Perl 5.20 and more recent.
	- Expose the following functions for curve and group selection:
	  - CTX_set_ecdh_auto, set_ecdh_auto
	  - CTX_set1_curves_list, set1_curves_list
	  - CTX_set1_groups_list, set1_groups_list
	  Thanks to Steffen Ullrich.

1.86_07 2018-12-13
        - Net::SSLeay::RSA_generate_key() now prefers using
          RSA_generate_key_ex. This avois deprecated RSA_generate_key
          and allows removing the only Android specific code in
          SSLeay.xs. Fixes RT#127593. Thanks to Rouven Weiler.
	- SSL_CTX_get0_param, SSL_CTX_get0_param,
	  X509_VERIFY_PARAM_set1_host, X509_VERIFY_PARAM_add1_host,
	  X509_VERIFY_PARAM_set_hostflags,
	  X509_VERIFY_PARAM_get0_peername,
	  X509_VERIFY_PARAM_set1_email, X509_VERIFY_PARAM_set1_ip and
	  X509_VERIFY_PARAM_set1_ip_asc added in 1.83 for OpenSSL
	  1.0.2 and later are now available with LibreSSL 2.7.0 and
	  later.
	- get_keyblock_size() now gets the MAC secret size from the
	  cipher on LibreSSL 2.7.0 and later, rather than reaching
	  into libssl internals. This effectively takes the OpenSSL
	  1.1 code path for LibreSSL 2.7.0 instead of the OpenSSL 1.0
	  code path.  Thanks to Alexander Bluhm.
	- get_client_random and get_server_random now use API
	  functions supported by LibreSSL 2.7.0 and later. Thanks to
	  Alexander Bluhm.
	- Add X509_check_host(), X509_check_email(), X509_check_ip(),
	  and X509_check_ip_asc() for LibreSSL 2.5.0 and later. Thanks
	  to Alexander Bluhm.
        - OpenSSL_version() and OpenSSL_version_num() are available
          with LibreSSL 2.7.0 and later. Thanks to Alexander Bluhm.
        - Use OPENSSL_cleanse() instead of memset(). Fixes
          RT#116599. Thanks to A. Sinan Unur.

1.86_06 2018-09-29
	- Net::SSLeay::read() and SSL_peek() now check SSL_get_error()
	  for SSL_ERROR_ZERO_RETURN for return values <= 0 to make
	  Net::SSLeay::read() behave more like underlying OpenSSL
	  function SSL_read().
	  Convenience function ssl_read_all() now does an automatic
	  retry when ERROR_WANT_READ or ERROR_WANT_WRITE is returned
	  with Net::SSLeay::read().
	  Convenience function ssl_read_until() now uses
	  Net::SSLeay::ssl_read_all() instead of
	  Net::SSLeay::read(). Tests 07_sslecho.t and 36_verify.t were
	  also updated to use ssl_read_all() and ssl_write_all(). The
	  tests now also disable TLSv1.3 session tickets and ignore
	  SIGPIPE to avoid this signal when the client has finished
	  before server has sent session tickets and called
	  Net::SSLeay::accept().
	  Thanks to Petr Pisar and Sebastian Andrzej Siewior for the
	  patches (in #RT125218).
	- Fix a memory leak in cb_data_advanced_put. Fixes
	  RT#127131. Noticed, investigated and patched by Paul
	  Evans. Thanks!
	- Enable OpenSSL 1.1.1-pre9 with Travis CI.
	- Add SSL_CTX_set_num_tickets, SSL_CTX_get_num_tickets,
	  SSL_set_num_ticket and SSL_get_num_tickets for controlling
	  the number of TLSv1.3 session tickets that are issued.  Add
	  tests in 44_sess.t. Parts taken from a larger patch by Petr
	  Pisar of RedHat.
	- Add SSL_CTX_set_ciphersuites and SSL_set_ciphersuites for
	  configuring the available TLSv1.3 ciphersuites. Add tests in
	  43_misc_functions.t and clarify SSL_client_version tests.
	- Add SSL_CTX_set_security_level, SSL_CTX_get_security_level,
	  SSL_set_security_level and SSL_get_security_level.
	  Add new test file 65_security_level.t.
	  All courtesy of Damyan Ivanov of Debian project.
	- Fix export_keying_material return value check and context
	  handling. SSL_export_keying_material use_context is now
	  correctly set to non-zero value when context is an empty
	  string. This affects values exported with TLSv1.2 and earlier.
	  Update documentation in NetSSLeay.pod and add tests
	  in t/local/45_export.t.
	- Add RAND_priv_bytes. Add new test file t/local/10_rand.t for
	  RAND_bytes, RAND_pseudo_bytes, RAND_priv_bytes, RAND_status,
	  RAND_poll, RAND_file_name and RAND_load_file.
	- Update documentation for RAND_*bytes return values and
	  RAND_file_name behaviour with LibreSSL.
	- Add SSL_SESSION_is_resumable. Add and update tests in 44_sess.t.
	- Set OpenSSL security level to 1 in tests that use the test suite's
	  (1024-bit) RSA keys, which allows the test suite to pass when
	  Net-SSLeay is built against an OpenSSL with a higher default
	  security level. Fixes RT#126987. Thanks to Petr Pisar (in
	  RT#126270) and Damyan Ivanov (in RT#126987) for the reports and
	  patches, and to Damyan Ivanov for the preferred patch.
	- Add SSL_CTX_sess_set_new_cb and SSL_CTX_sess_set_remove_cb.
	  Add new test file 44_sess.t for these and future session
	  related tests for which no specific test file is needed.
	- Add SSL_get_version, SSL_client_version and SSL_is_dtls.
	- Add SSL_peek_ex, SSL_read_ex, SSL_write_ex and SSL_has_pending.
	  Add tests in t/local/11_read.t
	- Add SSL_CTX_set_post_handshake_auth contributed by Paul
	  Howarth. Add SSL_set_post_handshake_auth,
	  SSL_verify_client_post_handshake and constant
	  SSL_VERIFY_POST_HANDSHAKE.
	- Applied a patch to set_cert_and_key() from Damyan Ivanov,
	  Debian Perl Group. This function now returns errors from
	  library's error stack only when an underlying routine
	  fails. Unrelated errors are now skipped. Fixes RT#126988.
	- Add support for TLSv1.3 via $Net::SSLeay::ssl_version.
	- Enhance t/local/43_misc_functions.t get_keyblock_size test
	  to work better with AEAD ciphers.
	- Add constants SSL_OP_ENABLE_MIDDLEBOX_COMPAT and
	  SSL_OP_NO_ANTI_REPLAY for TLSv1.3
	- Fix compile time DEFINE=-DSHOW_XS_DEBUG to work with
	  non-threaded Perls. Fixes RT#127027. Thanks to SREZIC for
	  the report. Also fix other minor compile warnings.

1.86_05 2018-08-22
	- Net-SSLeay now requires at least Perl 5.8.1. This is a
	  formalisation of what has been the de facto case for some time,
	  as the distribution hasn't compiled and passed its tests on Perl
	  5.005 for several years.
	- Increment Net::SSLeay::Handle's version number to keep it in sync
	  with Net::SSLeay's, thus satisfying Kwalitee's consistent_version
	  metric.
	- Re-enable the d2i_X509_bio() test in t/local/33_x509_create_cert.t
	  for LibreSSL. Thanks to Alexander Bluhm.
	- Automatically detect new library names on Windows for OpenSSL
	  1.1.0 onwards (libcrypto, libssl). Fixes part of RT#121084. Thanks
	  to Jean-Damien Durand.
	- Fix a typo preventing OpenSSL libraries built with the VC compiler
	  (i.e. ones with a ".lib" suffix) from being automatically detected
	  on Windows. Fixes part of RT#121084. Thanks to Jean-Damien Durand.
	- Add missing call to va_end() following va_start() in TRACE().
	  Fixes RT#126028. Thanks to Jitka Plesnikova.
	- Added SSL_in_init() and the related functions for all
	  libraries and their versions. All return 0 or 1 as
	  documented by OpenSSL 1.1.1. Use of these functions is
	  recommended over using constants returned by get_state() and
	  state(). New constants TLS_ST_*, used by OpenSSL 1.1.0 and
	  later, will not be made available by Net::SSLeay.

1.86_04 2018-07-30
	- Re-add SSLv3_method() for OpenSSL 1.0.2 and above. Fixes
	  RT#101484.
	- Don't expose ENGINE-related functions when building against
	  OpenSSL builds without ENGINE support. Fixes RT#121538. Thanks to
	  Paul Green.
	- Automatically detect OpenSSL 1.0.x on VMS, and update VMS
	  installation instructions to reflect removal of Module::Install
	  from the build system. Fixes RT#124388. Thanks to Craig A. Berry.
	- Prevent memory leak in OCSP_cert2ids() and OCSP_response_verify().
	  Fixes RT#125273. Thanks to Steffen Ullrich.

1.86_03 2018-07-19
	- Convert packaging to ExtUtils::MakeMaker. Thanks to mohawk2.
	- Module::Install is no longer a prerequisite when building
	  from the reposistory.
	- Re-apply patch from ETJ permitting configure and build in
	  places with a space in the name.

1.86_02 2018-07-06
	- Removed inc/ from repository. Module::Install is now a
	  prerequisite when building from the repository. This allowed
	  also removing "." from Makefile.PL lib path which was added
	  in version 1.81. These updates require no changes when
	  building from release packages. They also help AppVeyor
	  builds to work better with old Perls.

	- Added CONTRIBUTING.md, reformatted the previous Changes
          entry to use CPAN::Changes::Spec guidelines and removed
          unused version control tags from comments.

1.86_01 2018-07-04
	- Net::SSLeay functionality was not changed in this release.

	- Maintainer changes:
	  - Mike McCauley, maintainer of Net-SSLeay since November 2005,
	    has stepped down. Thanks to Mike for his 13 years of
	    stewardship.
	  - Net-SSLeay is now maintained by Chris Novakovic, Heikki
	    Vatiainen and Tuure Vartiainen.

	- Version control system changes:
	  - The previous Debian-hosted SVN repository has been imported
	    into Git. The source code is now maintained on GitHub, at
	    https://github.com/radiator-software/p5-net-ssleay.

	  - Fixes to commit metadata, branches and tags that git-svn
	    couldn't handle or had no way of handling, were done
	    manually or semi-automatically afterwards. For instance, the
	    "git-svn-id:" lines that git-svn appends to commit messages
	    were kept because Mike used SVN revision numbers in RT
	    replies to indicate when bugs had been fixed/patches applied
	    (which may be useful for future reference).

	  - All commits were replayed onto a single master branch rather
	    than having separate dead-end branches for the old SVN
	    version tags (as this seems more "git-like").

	  - New lightweight tags were created for each public release
	    going back as far as the start of the SVN repository using
	    data from MetaCPAN (cross-referencing with the changelog
	    when it wasn't clear when a release was cut from the SVN
	    repo).

	  - Florian's and Mike's email addresses were mapped to git
	    author/committer IDs

	- Continuous integration:
	  - Travis CI configuration was added for automated testing on
	    Linux using 64 bit Ubuntu Trusty. Build matrix dimensions
	    are: Perl 5.8 - 5.26 x OpenSSL 0.9.8zh - 1.1.0h. Only the
	    currently latest version for each major Perl and OpenSSL
	    release is chosen.

	  - AppVeyor configuration was added for automated testing on
	    Windows. Build matrix dimensions are: Perl 5.8 - 5.26 x
	    32bit and 64bit Perl environment x Windows Server 2012R2 and
	    Windows Server 2016. The Perl environment is Strawberry Perl
	    and its OpenSSL is used with builds. Only the latest major
	    versions are used, similarly to Travis CI. Net-SSLeay PPM
	    and PPD files are made available as artifacts.

	  - Added README.md with link to master branch build and test
	    status. Did minor updates to README and other misc files.

	- Release packaging:
	  - Files t/local/43_misc_functions.t and
	    t/local/65_ticket_sharing_2.t were missing from MANIFEST.

	  - Updated inc/ directory with Module::Install 1.19. Updated
	    Makefile.PL author and resource information. Synced
	    SSLeay.pm under ext/ with the latest changes under
	    inc/. Reordered use imports so that META.yml gets correctly
	    regenerated. More Module::Install related changes will
	    follow.

1.85 2018-03-14
	Preparations for transferring maintenace to a new maintainer
	Fixed test failure in t/local/33_x509_create_cert.t for some version of OpenSSL.
	Fixed free() error that causes "Free to wrong pool ..." merssage on Windows.
	Reported and patched by Steffen Ullrich.
	
1.84 2018-01-17
	Fixed an error in t/local/04_basic.t causing a test failure if
	Test::Exception not installed. Reported by Joel Berger.
	
1.83 2018-01-16
	Fixed a problem with exporting OPENSSL_NO_NEXTPROTONEG even though they are not availble on LibreSSL.
	Patch patch-SSLeay_xs-NO_NPN from Alexander Bluhm.
	Patch from Heikki Vatiainen adds support for SSL_set_default_passwd_cb* for 
	OpenSSL 1.1.0f and later. LibreSSL does not support these functions, at 
	least yet.
	Patch from Heikki Vatiainen adds new functions related to SSL_CTX_new.
	Patch from Heikki Vatiainen adds two new functions introduced in OpenSSL 1.1.0, a number 
	of constants and a couple of const qualifiers to SSLeay.xs. Tests and 
	documentation .pod were also updated.
	Patch from Heikki Vatiainen adds one new OpenSSL 1.1.0 function and has a minor fix for 
	LibreSSL version detection:	    
	*   Added support for SSL_use_certificate_chain_file
     	function introduced in OpenSSL 1.1.0.
	*   Fixed LibreSSL version detection to correctly parse
     	LibreSSL minor version.
	Patch from Steffen Ulrich to fix memory leaks in OCSP handling. Thanks.
	Patch from Heikki Vatiainen adds new functions for certificate verification introduced in 
	OpenSSL 1.02, a number of constants, new test data files, new tests and 
	updates to .pod documentation.
	The new functions provide access to the built-in wildcard check 
	functionality available in OpenSSL 1.0.2 and later.
	The patch also adds new tests for the new functions and updates some of 
	the current tests for CTX_set_default_passwd_cb* functions.
	Added X509_STORE_CTX_new and X509_verify_cert.
	SSL_OCSP_response_verify now clears the error queue if OCSP_basic_verify fails but the
	intermediate certificate succeeds. Patch from Stefan Ullrich.


1.82 2017-10-31
	Added support for building under Linuxbrew (a linuxbrew version of MacOS Homebrew)
	Patch from Matthew Altus, that implements SSL_CTX_set_psk_client_callback() and SSL_set_psk_client_callback().
	Patch to build with LibreSSL has no support for NPN
	Also skip the NPN test if the SSL library is LibreSSL.
	Fixed a problem with a variable declaration in ssleay_session_secret_cb_invoke reported by Graham Ollis.
	Significant patch set from Open System Consultants:
	- Bugfix: tlsext_status_cb_invoke(...): free ocsp_response only when allocated.
 	- The same callback is used on a server side for OCSP stapling and in that 
  	 case ocsp_response is NULL and not used.
	 - New feature: Added a binding SSL_set_session_ticket_ext_cb(ssl,callback,data)
	 - A callback used by EAP-FAST/EAP-TEAT to parse and process TLS session ticket.
	 - Tests are in t/local/65_ticket_sharing_2.t
	 - New feature: Added a binding SSL_set_session_ticket_ext(ssl,ticket)
	 - Used by EAP-FAST/EAP-TEAP to define TLS session ticket value.
	 - Tests are in t/local/65_ticket_sharing_2.t
	 - Bugfix: tlsext_ticket_key_cb_invoke(...): allow SHA256 HMAC key to be 32 bytes 
	 instead of 16 bytes (which OpenSSL will pad with zeros up to 32 bytes).
	 - New feature: Added following bindings:
	 - X509_get_ex_data(cert,idx)
	 - X509_get_ex_new_index(argl,argp,new_func,dup_funL,free_func)
	 - X509_get_app_data(cert)
	 - X509_set_ex_data(cert,idx,data)
	 - X509_set_app_data(cert,arg)
	 - X509_STORE_CTX_get_ex_new_index(argl,argp,new_func,dup_func,free_func)
	 - X509_STORE_CTX_get_app_data(x509_store_ctx)
	 - X509_STORE_CTX_set_app_data(x509_store_ctx,arg)
	 - New feature: Added an implementation for SSL_get_finished(ssl,buf,count=2*EVP_MAX_MD_SIZE)
	 - Tests are in t/local/43_misc_functions.t
	 - New feature: Added an implementation for SSL_get_peer_finished(ssl,buf,count=2*EVP_MAX_MD_SIZE)
	 - Tests are in t/local/43_misc_functions.t
	 - Bugfix: SSL_get_keyblock_size(s): Calculate key block size correctly also with AEAD ciphers
	 which don’t use digest functions.
	 - New feature: Added a binding SSL_set_tlsext_status_ocsp_resp(ssl,staple)
	 - Used by a server side to include OCSP staple in ServerHello.
	 - Bugfix: SSL_OCSP_response_verify(ssl,rsp,svreq,flags): check that chain and last are not NULL 
	 before trying to use them.
	 - Bugfix: inc/Module/Install/PRIVATE/Net/SSLeay.pm: Don’t quote include and lib paths.

1.81	 2017-03-28
	Patch from Alexander Bluhm to enable RSA_get_key_parameters with
	LibreSSL. Again.
	Fixed memory leak in X509_get_subjectAltNames. Reported and patched by Jim Westfall.
	Added . to lib path in Makefile.PL and t/local/32_x509_get_cert_info.t
	to accommodate people who are using a perl with -Ddefault_inc_excludes_dot
	or perl 25 or later.
	Fixed build failure if engine support not present. Patch from Paul Green.
	Improvements to  get_my_thread_id to work around possibility of ERRSV not being defined eg on OpenWRT.
	Patch from ETJ permitting configure and build in places with a space in the name.
	
1.80	 2017-01-05
	 Patch from Steffen Ulrich that fixed unexpected changes in the
	 control flow of the Perl program which seemed to be triggered by the
	 ticket key callback. Thanks Steffen.

1.79	 2017-01-03
	Patch to fix a few inline variable declarations that cause errors for
	older compilers. From Andy Grundman. Thanks.
	Patch: Generated C code is not compatible with MSVC, AIX cc,
	probably others. Added some PREINIT blocks and replaced 2 cases of INIT with
	PREINIT. From Andy Grundman. Thanks.
	Patch to fix: Fails to compile if the OpenSSL library it's built
	against has compression support compiled out. From Stephan
	Wall. Thanks.
	Added RSA_get_key_parameters() to return a list of pointers to RSA key
	internals.
	Patch to fix some documentation typos courtesy gregor herrmann.
	RSA_get_key_parameters() is now only available prior OpenSSL 1.1.
	Testing with openssl-1.1.0b.

1.78	 2016-08-13
	 Fixed broken OCSP code and tests. Broken since 1.75. Patched by
	 Steffen Ullrich. Thanks.

1.77	 2016-08-01
	 Fixed incorrect size to memset in tlsext_ticket_key_cb_invoke.

1.76	 2016-07-31
	 Replaced bzero with memset. Bzero not present on windows.

1.75  2016-07-31
     Compatibility with OpenSSL 1.1, tested with openssl-1.1.0-pre5:
     - Conditionally remove threading locking code, not needed in 1.1
     - Rewrite code that accesses inside X509_ATTRIBUTE struct.
     - SSL_CTX_need_tmp_RSA, SSL_CTX_set_tmp_rsa,
       SSL_CTX_set_tmp_rsa_callback, SSL_set_tmp_rsa_callback support
       not available in 1.1.
     - SSL_session_reused is now native
     - SSL_get_keyblock_size modifed to use new API
     - OCSP functions modified to use new API under 1.1
     - SSL_set_state removed with 1.1
     - SSL_get_state and SSL_state are now equivalent and available in all
       versions
     - SSL_CTX_v2_new is not available with 1.1 and later. SSLv2 is removed in 1.1.
     - SESSION_set_master_key removed with 1.1. Code that previously used
       SESSION_set_master_key must now set $secret in the session_secret
       callback set with SSL_set_session_secret_cb
     - With 1.1, $secret in the session_secret
       callback set with SSL_set_session_secret_cb can be changed to alter
       the master key (required by EAP-FAST).
     Added a function EC_KEY_generate_key similar to RSA_generate_key and a
     function EVP_PKEY_assign_EC_KEY similar to EVP_PKEY_assign_RSA. Using
     these functions it is easy to create and use EC keys in the same way as
     RSA keys. Patch provided by Steffen Ullrich. Thanks Steffen.
     Testing with LibreSSL 2.4.1, with compatibility patch from Steffen
     Ullrich. Thanks Steffen.
     Patch from Steffen Ulrich provides  support for cross context (and cross process)
     session sharing using the stateless TLS session tickets. It uses the
     SSL_CTX_set_tlsext_ticket_key_cb function to manage the encryption and
     decryption of the tickets but provides a more simplified
     interface. Includes new function CTX_set_tlsext_ticket_getkey_cb.
     To not conflict with the OpenSSL name in case the more complex interface
     will be implemented ever the current simplified interface is called
     slightly different: CTX_set_tlsext_ticket_*get*key_cb. 
     Added documentation about downloading latest version from SVN.
     Added missing Module/install files to SVN.

1.74 2016-04-12
     README.OSX was missing from the distribution

1.73 2016-04-11
     Added X509_get_X509_PUBKEY. Patch supplied by GUILHEM. Thanks.
     Added README.OSX with instructions on how to build for recent OS X.
     Added info about using OPENSSL_PREFIX to README.Win32.
     Added comments in POD about installation documentation.
     Added '/usr/local/opt/openssl/bin/openssl' to Openssl search path for
     latest version of  OSX homebrew openssl. Patch from Shoichi Kaji.

1.72 2015-09-22
     Fixed a problem where SvPVx_nolen was undefined in some versions of
     perl. Reported by Karen Etheridge. Replaced with SvPV_nolen.
     Fixed a cast warning on Darwin reported by Karen Etheridge. 

1.71 2015-09-18
     Patch from Ben Kaduk: Conditionalise support for MD4, MD5.
     Added support for linking libraries in /usr/local/lib64 for some flavours
     of Linux like RH Tikanga. 
     Fixes to X509_check_host, X509_check_ip, SSL_CTX_set_alpn_protos, and
     SSL_set_alpn_protos so they will compile on MSVC and AIX cc. Thanks to
     AGRUNDMA.
     Fixed typos in documentation for X509_NAME_new and X509_NAME_hash
     incorrect version 1.45 instead of 1.55 given.
     Version number in META.yml is now quoted per request from Satoshi Yagi.
     

1.70 2015-06-26
     Patch from Alexander Bluhm: The new OpenSSL 1.0.2 X509_check_* functions are not available in
     current LibreSSL.  So disable them in SSLeay.xs.
     Fixed a problem with building against OSX homebrew's openssl. Patch from
     Shoichi Kaji.
     Removed a test in t/local/33_x509_create_cert.t which fails due to
     changes in 1.0.1n and later

1.69 2015-06-04
     Testing with OpenSSL 1.0.2, 1.0.2a. OK.
     Completed LibreSSL compatibility with the kind assistance of Alexander
     Bluhm.
     Improved compatibility with OpenSSL 1.0.2a as suggested by Petr Pisar.
     Added the X509_check_* functions introduced in OpenSSL 1.0.2, contributed
     by Carsten Gaebler.
     Added support for X509_V_FLAG_TRUSTED_FIRST constant, patch from Gisle Aas.
     Patch allows get_keyblock_size to work correctly with 
     OpenSSL 1.0.1 and later versions. Contributed by Heikki Vatiainen.

1.68 2015-01-24
     Fixed a problem on OSX when macports openssl 1.x is installed: headers from
     macport were found but older OSX openssl libraries were linked, resulting
     in "Symbol not found: _EVP_MD_do_all_sorted".
     Added notes about runtime error "no OPENSSL_Applink", when calling
     Net::SSLeay::P_PKCS12_load_file.


1.67 2015-01-17
     Improvements to inc/Module/Install/PRIVATE/Net/SSLeay.pm to handle the
     case whe there are muliple OPENSSLs installed. Patch from HBRAND
     Fixed a documentation error in get_peer_cert_chain, reported by tejas.
     Fixed a problem with building on Windows that prevented correct OpenSSL
     directory detection with version 1.0.1j as delivered with Shining Light OpenSSL.
     Fixed a problem with building on Windows that prevented finding MT or MD
     versions of SSL libraries.
     Updated doc in README.Win32 to build with Microsoft Visual Studio 2010 Express.
     Added Windows crypt32 library to Windows linking as some compilers/platforms seem to
     require it and it is innocuous otherwise. For Steve Hay.
     Fixed a failure in t/external/20_cert_chain.t where some platforms do not
     have HTTPS in /etc/services. Reported and patched by Gisle Aas.
     Recent 1.0.2 betas have dropped the SSLv3_method function. 
     This patch leaves out the function on newer versions, much the same as
     the SSLv2 deprecation is handled. Patch from Tom Molesworth.
     Fix the ALPN test, which was incorrectly failing on OpenSSL due to the
     LibreSSL check (earlier versions bailed out before that line).Patch from
     Tom Molesworth. 

1.66 2014-08-21
     Fixed compile problem with perl prior to 5.8.8, similar to
     RT#76267. Reported by Graham Knop.
     Fixed a problem with Socket::IPPROTO_TCP on early perls.
     After discussions with the community and the original author Sampo
     Kellomaki, the license conditions have been changed to "Perl Artisitic
     License 2.0".


1.65  2014-07-14
     Added note to doc to make it clear that X509_get_subjectAltNames returns a
     packed binary IP address for type 7 - GEN_IPADD.
     Improvements to SSL_OCSP_response_verify to compile under non c99
     compilers. Requested by MERIJNB.
     Port to Android, contributed by Brian Fraser. Includes Android specific
     version of RSA_generate_key.
     Added LibreSSL support, patch provided by Alexander Bluhm. Thanks!
     Patch that fixes the support for SSL_set_info_callback and adds
     SSL_CTX_set_info_callback and SSL_set_state. Support for these functions is
     necessary to either detect renegotiation or to enforce
     renegotiation. Contributed by Steffen Ullrich. Thanks!
     Fixed a problem with SSL_set_state not available on some early OpenSSLs,
     patched by Steffen Ullrich. Thanks!
     Removed arbitrary size limits from calls to tcp_read_all in tcpcat() and
     http_cat().
     Removed unnecessary Debian_SPANTS.txt from MANIFEST. Again.

1.64 2014-06-11
     Fixes for test ocsp.t. Test now does not fail if HTTP::Tiny is not
     installed.
     Fixed repository in META.yml.
     Fixed a problem with SSL_get_peer_cert_chain: if the SSL handshake
     results in an anonymous authentication, like ADH-DES-CBC3-SHA,
     get_peer_cert_chain will not return an empty list, but instead return the
     SSL object. Reported and fixed by Steffen
     Ullrich. Thanks.
     Fixed a problem where patch
     https://git.openssl.org/gitweb/?p=openssl.git;a=commit;h=3009244da47b989c4cc59ba02cf81a4e9d8f8431
     caused a failed test in t/local/33_x509_create_cert.t.

1.63 2014-05-19
     Fixed error in version number in META.yml

1.62 2014-05-19
     Improvements to OCSP support: It turns out that some CA (like Verisign)
     sign the OCSP response with the CA we have in the trust store and don't
     attach this certifcate in the response.  But OpenSSL by itself only
     considers the certificates included in the response and
     SSL_OCSP_response_verify added the certificates in the chain too.
     Now, we also add the trusted CA from the store which
     signed the lowest chain certificate, at least if we could not verify the
     OCSP response without doing it. Patch from Steffen
     Ullrich. Thanks.
     Fixed some compiler warnings.

1.61 2014-05-12
     Changes calloc to Newx and free to Safefree, otherwise there might be
     problems because calloc is done from a different memory pool than free (depends
     on the build options for perl, but seen on Windows). Patch from Steffen
     Ullrich. Thanks.


1.60 2014-05-10
     Fixed a typo in an error message. Patch from gregor herrmann. Thanks.
     Fixed a problem with building with openssl that does not support
     OCSP. Also fixed some newly introduced warnings
     if compiled with -Wall. Patch from Steffen Ullrich. Thanks.
     fix build-failure on most Debian architectures:
     SSLeay.xs: In function 'XS_Net__SSLeay_OCSP_response_results':
     SSLeay.xs:5602:3: error: format not a string literal and no format
     arguments. Patch from  gregor herrmann.
     

1.59 2014-05-10
     Fixed local/30_error.t, so that tests do not fail if diagnostics are
     enabled.
     Fixed error messages about undefined strings used with length or
     split. Reported and patched by Peter Heuchert.
     Improvements to configuration of OPTIMIZE flags, to prevent overriding
     of perls expected optimization flags. Caution: HPUX aCC optimize options are special.
     SSL_peek() now returns openssl error code as second item when called in
     array context, same as SSL_read. Patch from Andreas Mohr.
     Fixed some warnings.
     Added support for tlsv1.1 tlsv1.2 via $Net::SSLeay::ssl_version. Patch
     from Andreas Mohr.
     Improve examples in 'Using other perl modules based on
     Net::SSLeay'. Patched by Andreas Mohr.
     Added support for OCSP. Patched by Steffen Ullrich. Thanks!
     Added missing t/external/ocsp.t

1.58 2014-01-15
     Always use size_t for strlen() return value, requested by Alexander Bluhm.
     t/external/20_cert_chain.t was missing from dist.
     Version number in META.yml was incorrect
     Improvements to test t/external/20_cert_chain.t to provoke following bug:
     Fixed crash due to SSL_get_peer_cert_chain incorrectly free'ing the chain
     after use.
     Fixed a problem when compiling against openssl where OPENSSL_NO_EC is set.

1.57 2014-01-09
     Fixed remaining problems with test suite: pod coverage and kwalitee tests
     are only enabled with RELEASE_TESTING=1

1.56 2014-01-08
     Fixed a typo in documentation of BEAST Attack, patched by gregor
     herrmann.
     Added LICENSE file copied form OpenSSL distribution to prevent complaints
     from various versions of kwalitee.
     Adjusted license: in META.yml to be 'openssl'
     Adds support for the basic operations necessary to support ECDH for PFS,
     e.g. EC_KEY_new_by_curve_name, EC_KEY_free and SSL_CTX_set_tmp_ecdh.
     Improvements to t/handle/external/50_external.t to handle the case when a
     test connection was not possible. Patched by Alexandr Ciornii.
     Added support for ALPN TLS extension. Patch from Lubomir Rintel. Tested
     with openssl-1.0.2-stable-SNAP-20131205.
     Fix an use-after-free error. Patch from Lubomir Rintel.
     Fixed a problem with  Invalid comparison on OBJ_cmp result in
     t/local/36_verify.t. Contributed by paul.
     Added support for get_peer_cert_chain(). Patch by Markus Benning.
     Fixed a bug that could cause stack faults: mixed up PUTBACK with SPAGAIN in ssleay_RSA_generate_key_cb_invoke()
     a final PUTBACK is needed here. A second issue is also fixed:
     cb->data defaults to &PL_sv_undef but throught the code you do not check
     against &PL_sv_undef, just NULL. 
     To avoid passing the 3rd optional arg at all, do not create it. This fixes all the 
     cb->data checks and wrong refcounts on &PL_sv_undef. Patched by Reini Urban.
     Deleted support for SSL_get_tlsa_record_byname: it is not included in
     OpenSSL git master. 

1.55 2013-06-08
     Added support for TLSV1_1 and TLSV1_2 methods with SSL_CTX_tlsv1_1_new(),
     SSL_CTX_tlsv1_2_new(), TLSv1_1_method() and TLSv1_2_method(), where
     available in the underlying openssl.
     Added CRL support functions X509_CRL_get_ext(), X509_CRL_get_ext_by_NID(),
     X509_CRL_get_ext_count(). Patch from Franck Youssef.
     Fixed a problem which could cause content with a value of '0' to not be
     correctly encoded by do_httpx3 and friends. Reported by Victor Efimov via
     RT.
     Added support for SSL_get_tlsa_record_byname() required for DANE support in
     openssl-1.0.2 and later. SSL_get_tlsa_record_byname() was added to
     OpenSSL with the financial assistance of .SE.
     Testing with openssl-1.0.2-stable-SNAP-20130521.
     Added X509_NAME_new and X509_NAME_hash, patched by Franck Youssef.
     Fixed a number of typos in pod file thanks to dsteinbrunner.

1.54 2013-03-23
     t/data/testcert_cdp.crt.pem_dump and t/data/testcert_cdp.crt.pem were
     missing from MANIFEST.
     Added MANIFEST to svn
     Improvement to test 07_sslecho.t so that if set_cert_and_key fails we
     can tell why.

1.53 2013-03-22
     Added support for SSL_export_keying_material where present (ie in OpenSSL
     1.0.1 and later).
     Changed t/handle/external/50_external.t to use www.airspayce.com instead of
     perldition.org, who no longer have an https server.
     Patch to fix a crash: P_X509_get_crl_distribution_points on an
     X509 certificate with values in the CDP extension which do not have an
     ia5 string will cause a segmentation fault when accessed. Patch from
     Robert Duncan.
     Change in t/local/32_x509_get_cert_info.t to not use
     Net::SSLeay::ASN1_INTEGER_get, since it works differntly on 32 and 64 bit platforms.
     Updated author and distribution location details to airspayce.com


1.52 2013-01-09
     Rebuild package with gnu format tar, to prevent problems with unpacking
     on other systems such as old Solaris,

1.51 2012-12-14
     Fixed a problem where SSL_set_SSL_CTX is not available with
     OpenSSL < 0.9.8f. Reported by Paul.

1.50 2012-12-13 
     Fixed a problem where t/handle/external/50_external.t would crash if any
     of the test sites were not contactable.
     Now builds on VMS. Patch kindly supplied by Craig A. Berry.
     Fixed a few compiler warnings in SSLeay.xs.  Most of them
     are just signed/unsigned pointer mismatches but there is one that actually
     fixes returning what would be an arbitrary value off the stack from
     get_my_thread_id if it happened to be called in a non-threaded build.
     Patch kindly supplied by Craig A. Berry.
     Added README.VMS, contributed by Craig A. Berry.
     Added SSL_set_tlsext_host_name, SSL_get_servername,
     SSL_get_servername_type, SSL_CTX_set_tlsext_servername_callback for
     server side Server Name Indication (SNI) support. Patched by kmx.
     Further mods for VMS building supplied by Craig A. Berry.
     Fixed a problem with C++ comments preventing builds on AIX and
     HPUX. Patched by Gisle Aas.
     perdition.org not available for tests, changed to www.airspayce.com
     Added SSL_FIPS_mode_set
     Improvements to test suite so it succeeds with and without FIPS mode
     enabled. Patch supplied by Petr Pisar.
     Added documentation, warning not to pass UTF-8 data in the content
     argument to post_https. Reported by Jason Terry.

1.49 2012-09-25
     Fixed problem where on some platforms test t/local/07_tcpecho.t would
     bail out if it could not bind port 1212. Now now tries a number of ports to bind to until
     successful.
     Improvements to  unsigned casting contributed by Reini Urban.
     Improvements to Net::SSLeay::read to make it easier to use with non-blocking IO:
      contributed by James Marshall:  It modifies
      Net::SSLeay::read() to return the result from SSL_read() as the second
      return value, if Net::SSLeay::read() is called in list context.  Its
      behavior should be unchanged if called in scalar or void context.  This
      result code seems to be required for full support of non-blocking I/O,
      since users need to handle SSL_ERR_WANT_READ, SSL_ERROR_WANT_WRITE, etc.
      Fixed a problem where t/local/kwalitee.t fails with
       Module::CPANTS::Analyse 0.86. Patch from Paul.
      Fixed a number of typos patched by Giles.
      Fixed a compiler warning from Compiling with gcc-4.4 and -Wall, patched by Giles.	
      Fixed problems with get_https4: documentation was wrong, $header_ref was
       not correctly set and $server_cert was not returned.
      Fixed a problem that could cause a Perl exception about no blength
      method on undef. Reported by "Stephen J. Smith via RT". https://rt.cpan.org/Ticket/Display.html?id=79309 
      Added documentation about how to mitigatxe various SSL/TLS
     vulnerabilities.
     Fixed problem reported by Mike Doherty: SSL_MODE_* are defined in ssl.h, 
     and should be available as constants, but I do not see them listed in constants.h

1.48 2012-04-25
     Removed unneeded Debian_CPANTS.txt from MANIFEST.
     Fixed incorrect documentation about the best way to call CTX_set_options.
     Fixed problem that caused Undefined subroutine utf8::encode @
     t/local/33_x509_create_cert.t (on perl 5.6.2). Thanks to kmx.
     In examples and pod documentations, changed #!/usr/local/bin/perl to #!/usr/bin/perl.
     t/local/06_tcpecho.t now tries a number of ports to bind to until
     successful.

1.47 2012-04-04
     Fixed overlong lines in pod, patch from Salvatore Bonaccorso, Debian Perl
     Group
     Fixed spelling errors in pod, patch from Salvatore Bonaccorso, Debian Perl
     Group
     Fixed extra "garbage" files in 1.46 tarball. Patch from kmx.
     Fixed incorrect fail reports on some 64 bit platforms. Patch from paul.
     Fix to avoid FAIL reports from cpantesters with missing openssl
     Use my_snprintf from ppport.h to prevent link failures with perl 5.8 and
     earlier when compiled with MSVC.

1.46 2012-04-03
     Fixed a problem reported by Atoomic: 
      When bootstrapping Net::SSleay ( with DynaLoader ) if you override the SIG{DIE} signal, using 
      Net::SSLeay will result in an error.
      Recreated META.yml, added META.yml to dist
      Fixed typo: the word "corresponding" was mis-spelled as "coresponding"
       throughout the POD. Patched by kmx.
      Updated META.yml to include repository and bugtracker
     Constants cleanup - removing non existing constants (perhaps from pre-0.9.6 era) - kmx
     Automatic constants.c generation via helper_script/regen_openssl_constants.pl - kmx
     Future changes in constants now under better control via
     t/local/21_constants.t - kmx
     Added missing new files
     Reordering @EXPORT_OK (constants first, functions next) - kmx
     Adding missing 51 constants to @EXPORT_OK + test to keep it in sync - kmx
     Instructions "howto add new constant" added to helper_script/regen_openssl_constants.pl - kmx
     NEWLY INTRODUCED CONSTANTS:
     - Net::SSLeay::ASN1_STRFLGS_ESC_CTRL
     - Net::SSLeay::ASN1_STRFLGS_ESC_MSB
     - Net::SSLeay::ASN1_STRFLGS_ESC_QUOTE
     - Net::SSLeay::ASN1_STRFLGS_RFC2253
     - Net::SSLeay::ERROR_WANT_ACCEPT
     - Net::SSLeay::EVP_PKS_DSA
     - Net::SSLeay::EVP_PKS_EC
     - Net::SSLeay::EVP_PKS_RSA
     - Net::SSLeay::EVP_PKT_ENC
     - Net::SSLeay::EVP_PKT_EXCH
     - Net::SSLeay::EVP_PKT_EXP
     - Net::SSLeay::EVP_PKT_SIGN
     - Net::SSLeay::EVP_PK_DH
     - Net::SSLeay::EVP_PK_DSA
     - Net::SSLeay::EVP_PK_EC
     - Net::SSLeay::EVP_PK_RSA
     - Net::SSLeay::MBSTRING_ASC
     - Net::SSLeay::MBSTRING_BMP
     - Net::SSLeay::MBSTRING_FLAG
     - Net::SSLeay::MBSTRING_UNIV
     - Net::SSLeay::MBSTRING_UTF8
     - Net::SSLeay::OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION
     - Net::SSLeay::OP_CISCO_ANYCONNECT
     - Net::SSLeay::OP_CRYPTOPRO_TLSEXT_BUG
     - Net::SSLeay::OP_LEGACY_SERVER_CONNECT
     - Net::SSLeay::OP_NO_TLSv1_1
     - Net::SSLeay::OP_NO_TLSv1_2
     - Net::SSLeay::OP_SINGLE_ECDH_USE
     - Net::SSLeay::OP_TLS_BLOCK_PADDING_BUG
     - Net::SSLeay::X509_V_FLAG_CHECK_SS_SIGNATURE
     - Net::SSLeay::X509_V_FLAG_EXTENDED_CRL_SUPPORT
     - Net::SSLeay::X509_V_FLAG_POLICY_MASK
     - Net::SSLeay::X509_V_FLAG_USE_DELTAS
     - Net::SSLeay::X509_V_OK
     - Net::SSLeay::XN_FLAG_COMPAT
     - Net::SSLeay::XN_FLAG_DN_REV
     - Net::SSLeay::XN_FLAG_DUMP_UNKNOWN_FIELDS
     - Net::SSLeay::XN_FLAG_FN_ALIGN
     - Net::SSLeay::XN_FLAG_FN_LN
     - Net::SSLeay::XN_FLAG_FN_MASK
     - Net::SSLeay::XN_FLAG_FN_NONE
     - Net::SSLeay::XN_FLAG_FN_OID
     - Net::SSLeay::XN_FLAG_FN_SN
     - Net::SSLeay::XN_FLAG_MULTILINE
     - Net::SSLeay::XN_FLAG_ONELINE
     - Net::SSLeay::XN_FLAG_RFC2253
     - Net::SSLeay::XN_FLAG_SEP_COMMA_PLUS
     - Net::SSLeay::XN_FLAG_SEP_CPLUS_SPC
     - Net::SSLeay::XN_FLAG_SEP_MASK
     - Net::SSLeay::XN_FLAG_SEP_MULTILINE
     - Net::SSLeay::XN_FLAG_SEP_SPLUS_SPC
     - Net::SSLeay::XN_FLAG_SPC_EQ
     A number of tests were present in svn, but missing from MANIFEST, and
        were therefore not included in the dist. Added.
     NEWLY INTRODUCED FUNCTIONS:
     - Net::SSLeay::ASN1_INTEGER_free
     - Net::SSLeay::ASN1_INTEGER_get
     - Net::SSLeay::ASN1_INTEGER_new
     - Net::SSLeay::ASN1_INTEGER_set
     - Net::SSLeay::EVP_PKEY_assign_RSA
     - Net::SSLeay::EVP_PKEY_bits
     - Net::SSLeay::EVP_PKEY_free
     - Net::SSLeay::EVP_PKEY_new
     - Net::SSLeay::EVP_PKEY_size
     - Net::SSLeay::EVP_get_cipherbyname
     - Net::SSLeay::OPENSSL_add_all_algorithms_conf
     - Net::SSLeay::OPENSSL_add_all_algorithms_noconf
     - Net::SSLeay::OpenSSL_add_all_algorithms
     - Net::SSLeay::PEM_get_string_PrivateKey
     - Net::SSLeay::PEM_get_string_X509_CRL
     - Net::SSLeay::PEM_get_string_X509_REQ
     - Net::SSLeay::PEM_read_bio_PrivateKey
     - Net::SSLeay::PEM_read_bio_X509
     - Net::SSLeay::PEM_read_bio_X509_REQ
     - Net::SSLeay::P_ASN1_INTEGER_get_dec
     - Net::SSLeay::P_ASN1_INTEGER_get_hex
     - Net::SSLeay::P_ASN1_INTEGER_set_dec
     - Net::SSLeay::P_ASN1_INTEGER_set_hex
     - Net::SSLeay::P_ASN1_STRING_get
     - Net::SSLeay::P_X509_CRL_add_revoked_serial_hex
     - Net::SSLeay::P_X509_CRL_get_serial
     - Net::SSLeay::P_X509_CRL_set_serial
     - Net::SSLeay::P_X509_REQ_add_extensions
     - Net::SSLeay::P_X509_REQ_get_attr
     - Net::SSLeay::P_X509_add_extensions
     - Net::SSLeay::P_X509_copy_extensions
     - Net::SSLeay::P_X509_get_crl_distribution_points
     - Net::SSLeay::P_X509_get_ext_key_usage
     - Net::SSLeay::P_X509_get_key_usage
     - Net::SSLeay::P_X509_get_netscape_cert_type
     - Net::SSLeay::P_X509_get_pubkey_alg
     - Net::SSLeay::P_X509_get_signature_alg
     - Net::SSLeay::P_PKCS12_load_file
     - Net::SSLeay::X509V3_EXT_print
     - Net::SSLeay::X509_CRL_digest
     - Net::SSLeay::X509_CRL_free
     - Net::SSLeay::X509_CRL_get_issuer
     - Net::SSLeay::X509_CRL_get_lastUpdate
     - Net::SSLeay::X509_CRL_get_nextUpdate
     - Net::SSLeay::X509_CRL_get_version
     - Net::SSLeay::X509_CRL_new
     - Net::SSLeay::X509_CRL_set_issuer_name
     - Net::SSLeay::X509_CRL_set_lastUpdate
     - Net::SSLeay::X509_CRL_set_nextUpdate
     - Net::SSLeay::X509_CRL_set_version
     - Net::SSLeay::X509_CRL_sign
     - Net::SSLeay::X509_CRL_sort
     - Net::SSLeay::X509_CRL_verify
     - Net::SSLeay::X509_EXTENSION_get_critical
     - Net::SSLeay::X509_EXTENSION_get_data
     - Net::SSLeay::X509_EXTENSION_get_object
     - Net::SSLeay::X509_NAME_ENTRY_get_data
     - Net::SSLeay::X509_NAME_ENTRY_get_object
     - Net::SSLeay::X509_NAME_add_entry_by_NID
     - Net::SSLeay::X509_NAME_add_entry_by_OBJ
     - Net::SSLeay::X509_NAME_add_entry_by_txt
     - Net::SSLeay::X509_NAME_cmp
     - Net::SSLeay::X509_NAME_digest
     - Net::SSLeay::X509_NAME_entry_count
     - Net::SSLeay::X509_NAME_get_entry
     - Net::SSLeay::X509_NAME_print_ex
     - Net::SSLeay::X509_REQ_add1_attr_by_NID
     - Net::SSLeay::X509_REQ_digest
     - Net::SSLeay::X509_REQ_free
     - Net::SSLeay::X509_REQ_get_attr_by_NID
     - Net::SSLeay::X509_REQ_get_attr_by_OBJ
     - Net::SSLeay::X509_REQ_get_attr_count
     - Net::SSLeay::X509_REQ_get_pubkey
     - Net::SSLeay::X509_REQ_get_subject_name
     - Net::SSLeay::X509_REQ_get_version
     - Net::SSLeay::X509_REQ_new
     - Net::SSLeay::X509_REQ_set_pubkey
     - Net::SSLeay::X509_REQ_set_subject_name
     - Net::SSLeay::X509_REQ_set_version
     - Net::SSLeay::X509_REQ_sign
     - Net::SSLeay::X509_REQ_verify
     - Net::SSLeay::X509_certificate_type
     - Net::SSLeay::X509_digest
     - Net::SSLeay::X509_get_ext_count
     - Net::SSLeay::X509_get_pubkey
     - Net::SSLeay::X509_get_serialNumber
     - Net::SSLeay::X509_get_version
     - Net::SSLeay::X509_issuer_and_serial_hash
     - Net::SSLeay::X509_issuer_name_hash
     - Net::SSLeay::X509_new
     - Net::SSLeay::X509_pubkey_digest
     - Net::SSLeay::X509_set_issuer_name
     - Net::SSLeay::X509_set_pubkey
     - Net::SSLeay::X509_set_serialNumber
     - Net::SSLeay::X509_set_subject_name
     - Net::SSLeay::X509_set_version
     - Net::SSLeay::X509_sign
     - Net::SSLeay::X509_subject_name_hash
     - Net::SSLeay::X509_verify
     - Net::SSLeay::d2i_X509_CRL_bio
     - Net::SSLeay::d2i_X509_REQ_bio
     - Net::SSLeay::d2i_X509_bio
     - Net::SSLeay::set_tlsext_host_name
     - Net::SSLeay::CTX_set_next_protos_advertised_cb
     - Net::SSLeay::CTX_set_next_proto_select_cb
     - Net::SSLeay::P_next_proto_negotiated
     - Net::SSLeay::P_next_proto_last_status
     Fixed a problem with multiple Safefree of GLOBAL_openssl_mutex when run
     under apache2+mod_perl on recent Debain distros. Removed END and
     openssl_threads_cleanup() since they can be called during thread
     destruction, and not necessarily at process exit time.
     Added missing helper_script/regen_openssl_constants.pl to MANIFEST. Add
     MANIFEST to svn.
     Fixed reported errors about try to plan twice in 21_constants.t on some platforms.
     Removed MANIFEST from svn, improve possibility to use Module::Install in Net-SSleay 
     distribution in usual way. new target for make manifest
     Fix 2 issues with CTX_use_PKCS12_file
      1/ leaking memory - missing EVP_PKEY_free + X509_free
      2/ pkcs12 filesize limitation
     Fixed problems with regenerating scripts in Makefile.PL
     Added missing dependencies for SSLeay.o to Makefile.PL
     Added missing test files to svn
     Fixed calling convention for Net::SSLeay::get_shared_ciphers + test + doc update
     Added coding guidelines to SSLeay.xs
     Fix for serial number issue.
     Major patch to refactor callback code to make it more extensible and
     remove duplicate code. Thanks to kmx.
     Fixed a problem in  t/local/07_sslecho.t when running on 
     openssl-0.9.6
     Fixed pod parsing errors reported by Olivier Mengué
     Better prevention of leaking SVs in the new callback stuff
     Debug messages in SSLeay.xs can be enabled by: perl Makefile.PL DEFINE=-DSHOW_XS_DEBUG
     Fixing X509_NAME_oneline (calling OPENSSL_free at the right place)
     Fixed a problem with crashing when run under apache2+modssl+modperl on
     Debian Wheezy. Now detects if it is running under ModPerl and uses ModSSLs
     thread locking instead.
     Added more debg printing. Enable with
     	   perl Makefile.PL DEFINE=-DSHOW_XS_DEBUG
     Added NPN support, thanks to kmx
     Added t/local/40_npn_support.t tests for new NPN support
     Fixed some compiler warnings. Courtesy kmx.
     Fixed a problem with Win32 detection. Courtesy kmx.

1.45 2012-02-25
     Added mising doc for SESSION_cmp. Patch by paul.

1.44 2012-02-25
     Added missing t/data/binary-test.file to MANIFEST

1.43 2012-02-24
    Fixed some typos. Patched by Neil Bowers.
    SSLeay.pm convenience functions now call Net::SSLeay::initialize that
    initializes the SSL library at most once. 
    Patch from kmx to protect SSLeay_add_ssl_algorithms from multiple loads
    and reentrancy in multi-threaded perls.
    Patch from kmx to add reentrancy protection for callbacks in
    multithreading.
    Updated ppport.h, fixed some complaints from ppport.h
    Fixed a problem with CTX_use_PKCS12_file on Windows, since the file was
    not opened in binary mode. Reported by kmx.
    Added resources line for SVN repository to Makefile. Suggested by kmx.
    Fixed complaints unders some windows compilers about cast from pointer to integer of
    different size. Suggested by kmx.
    Added thread safety and dynamic locking. This should complete thread
    safety work, making Net::SSLeay completely thread-safe. Patches by kind
    assistance of kmx.
    Improvements to openssl backwards compatibility. Now build with versions
    back to 0.9.6. With extreme thanks to kmx.
    Improvements to documentation, thanks to kmx.
    SUMMARY OF NEWLY INTRODUCED FUNCTIONS:
    - Net::SSLeay::initialize
    - Net::SSLeay::SSLeay
    - Net::SSLeay::SSLeay_version
    - Net::SSLeay::CIPHER_get_name
    - Net::SSLeay::ASN1_TIME_new
    - Net::SSLeay::ASN1_TIME_free
    - Net::SSLeay::ASN1_TIME_set
    - Net::SSLeay::P_ASN1_TIME_get_isotime
    - Net::SSLeay::P_ASN1_TIME_set_isotime
    - Net::SSLeay::P_ASN1_TIME_put2string
    - Net::SSLeay::OpenSSL_add_all_digests
    - Net::SSLeay::P_EVP_MD_list_all
    - Net::SSLeay::EVP_get_digestbyname
    - Net::SSLeay::EVP_MD_type
    - Net::SSLeay::EVP_MD_size
    - Net::SSLeay::EVP_MD_CTX_md
    - Net::SSLeay::EVP_MD_CTX_create
    - Net::SSLeay::EVP_MD_CTX_destroy
    - Net::SSLeay::EVP_DigestInit
    - Net::SSLeay::EVP_DigestInit_ex
    - Net::SSLeay::EVP_DigestUpdate
    - Net::SSLeay::EVP_DigestFinal
    - Net::SSLeay::EVP_DigestFinal_ex
    - Net::SSLeay::EVP_Digest
    - Net::SSLeay::SHA1
    - Net::SSLeay::SHA256
    - Net::SSLeay::SHA512
    - Net::SSLeay::EVP_sha1
    - Net::SSLeay::EVP_sha512
    Fixed a problem with set_proxy where the password was not properly
    set. The code to do this went missing at some stage. Reported by Ulrich
    Weber via RT.
    Further improvements to testing time functions. 
    Added t/local/37_asn1_time.t
    Added various digest functions, documentation and tests
    Removed debug from P_ASN1_TIME_get_isotime. Courtesy kmx.
    Remove unnecessary warnings about Random number generator not
    seeded. Courtesy kmx.
    Fixed an error in 04_basic.t triggered if Test::Exception not present.
    Added documentation for many CTX_ functions. Courtesy kmx.
    Fixed mionor typos in SSLeay.xs. Courtesy kmx.
    Moved documentation to new lib/Net/SSLeay.pod. Courtesy kmx.
    Additions to documentation in pod. Courtesy kmx.
    Fixed some incorrect return types from SSL_set_options
    SSL_CTX_set_options. Courtesy kmx.
    Further documentation in pod. Courtesy kmx.
    Small fixes to XS code + one new trivial function SSL_CIPHER_get_name
    And one more thing - 02_pod_coverage.t is turned ON passing all tests - 
    never ever allow a new function without at least a short doc. Courtesy
    kmx.
    Removed 2 unnecessary 'local $[;' from SSLeay.pm
 
1.42	 2011-10-03
    Fixed incorrect documentation of how to enable CRL checking. Patched
    by Steffen_Ullrich.
    Fixed incorrect letter in Sebastien in Credits. Patch by Neil Bowers.
    Reversed order of the Changes file to be reverse chronological. Patch by
    Neil Bowers.
    Fixed a a compile error when building on Windows with MSVC6. reported and
    patched by "Andrew J. Savige via RT".

1.41    2011-09-25
    Fixed incorrect const signatures for 1.0 that were causing warnings. 
    Patches provided by "Douglas
    Christopher Wilson via RT". Now have clean compile with 0.9.8a through 1.0.0.
1.40    2011-09-23
    Fixed incorrect argument type in call to SSL_set1_param
    Fixed a number of issues with pointer sizes, patched by "Douglas
    Christopher Wilson via RT". Removed redundant pointer cast tests from t/
    Added Perl version requirements to SSLeay.pm
1.39    2011-09-21
    Downgraded Module::Install to 0.93 since 1.01 was causing problems in
    the Makefile. Reported by Albert Chin.
1.38    2011-09-16
    - Fixed a problem with  various symbols that only became
    available in OpenSSL 0.9.8 such as X509_VERIFY_PARAM and
    X509_POLICY_NODE, causing build failures with older versions of
    OpenSSL. Patched by paul.
1.37    2011-09-16
    - Added X509_get_fingerprint, contributed by Thierry Walrant (with
    minor changes die to the fact that stricmp is not avialable. Cert
    types must be lowercase. Also added test to 07_sslecho.t
    - Added suport for SSL_CTX_set1_param, SSL_set1_param,
    selected X509_VERIFY_PARAM_* OBJ_* functions. Added new test
    t/local/36_verify.t
    - Fixed the prototype for randomize(), it missed one arg, and errors
    are reported with perl 5.10.1 on Windows
    - Fixed an uninitialized value warning in $Net::SSLeay::proxyauth,
    reported by Andrey Rikov.
    - Update so net-ssleay will compile if SSLV2 is not present. Patch
    from Chris Butler.
    - Fixed a problem where sslcat (and possibly other functions) expect RSA keys and will not
    load DSA keys for client certificates. Reported and patched by "Jesse
    DeFer via RT"
        - Removed SSL_CTX_v2_new and SSLv2_method() for OpenSSL 1.0 and later.
    - Added CTX_use_PKCS12_file contributed by "Andrew A. Budkin".
1.36 30.01.2010
    - Fix problems with building on GNU/kFreeBSD, to do with use of pack
    instread of sockaddr_in. Patched by Debian Perl Group. (Closes RT#40144)
    - Fixed a compile problem in t/local/ptr_cast_test.c for some gcc
    versions. Reported by "Ryan McGuigan via RT". (Closes RT#52525)
    - Improved OpenSSL detection on Win32/strawberry perl. Patch provided
    by kmx. (Closes RT#49287)
    - Fix test failures on some 64-bit platforms. (Closes RT#53585)
    - Make X509_NAME_get_text_by_NID return its result without a trailing NUL.
    Patched by Steffen Ullrich. (Closes RT#35754)
    - SSL_set_session_secret_cb required for EAP-FAST is now enabled for both
    SSL_F_SSL_SET_HELLO_EXTENSION and
    SSL_F_SSL_SET_SESSION_TICKET_EXT. The name of this #define
    changed after 0.9.8i. SSL_set_hello_extension is not available after
    0.9.8i.
    - Added SSL_CTX_get_client_CA_list sk_X509_NAME_free sk_X509_NAME_num
    sk_X509_NAME_value SSL_get_client_CA_list, from patch provided by
    Joerg Schneider
    - Added EVP_add_digest and EVP_sha256 (if available)
    - Improve documentation on callback functions.
    - Stop looping forever when writing to broken connections. Patched by
    Martin Mares. (Closes RT#44170)
    - Patches from "Martijn van Beers via RT" to add SSL_SENT_SHUTDOWN
    and SSL_RECEIVED_SHUTDOWN, remove broken URLs,
    and to fix some documentation issues.
    - Various changes to build with OpenSSL 1.0 beta1:
    SSL_SESSION_cmp has been removed
    return type of SSL_CTX_sessions changed in an ugly way
    - Fixed a build problem reported by SISYPHUS:
    On Windows Vista64, ActivePerl 5.10.0 (build 1004, x64), running 'nmake
    test', the process hangs forever when it comes to building the test
    executable (as the executable fails to build).
    - Applied patch from ecmenifee in to improve handling of errors in
    ssl_write_all. (Closes RT#48132)
    - Patch to permit compile and testing on OS/2 submitted by Ilya
    Zakharevich.
    - Fixed compile problems with openssl-1.0.0-beta3 due to MD2 now being
    optional. Reported by paul [...] city-fan.org.
    - Fixed compile problems with openssl-0.9.7 and earlier with undefined
    symbol EVP_sha256. Reported by paul [...] city-fan.org.
    - Fixed a typo reported by Dan Dascalescu.
    - added RIPEMD160 digest function.  Patch provided by dkg.

1.35 25.07.2008
    - Fix test plan for autoload.t if Test::Exception isn't available.
    - Skip rsa_generate_key.t if Test::Exception isn't available.

1.34 24.07.2008
    - Fixed problem with X509_get_subjectAltNames, where some types of Alt
    Name (eg DIRNAMEs) were not properly handled, resulting in seg faults.
    Reported by Achim Grolms.
    - Added support for ENGINE_load_builtin_engines and
    ENGINE_register_all_complete in order to enable built-in OpenSSL
    crypto engines for hardware acceleration etc.
    - Added support for ENGINE_by_id and ENGINE_set_default, required
    to enable Sun crypto acceleration

1.33_01 14.02.2008
    - Fixed a compile problem with inc_paths /usr/kerberos/include
    in inc/Module/Install/PRIVATE/Net/SSLeay.pm. Reported by "J. Nick
    Koston via RT"
    - Added optional support for SSL_set_hello_extension,
        SSL_set_session_secret_cb to support various extension patches from
        a patch to openssl-0.9.9-dev contributed by Jouni Malinen.
        See wpa_supplicant/patches/openssl-0.9.9-session-ticket.patch in the
        latest (git) version 0.6 and later of wpa_suplicant at
        http://hostap.epitest.fi/. These additions are ifdefed to
        SSL_F_SSL_SET_HELLO_EXTENSION which is added by the patch
        Tested with openssl-SNAP-20070816.
        - Added SSL_SESSION_set_master_key and SSL_get_keyblock_size.
        - Added all SSL_OP_* options flags present in 0.9.9
        - Fixed a bug in SSL_set_tmp_dh
        - Doc improvements in README.Win32
    - Fixed a problem with proxy connections: open_proxy_tcp_connection
    was stopping after the first \n from the proxy,
    but instead should have looked for
    $CRLF . $CRLF to find the beginning of the SSL content
    - Fixed missing / on /usr/kerberos/include, reported by several people
    - removed bacus.pt from host list in t/handle/external/10_destroy.t,
    since it seems no longer to respond. Reported by tco2.
    - changed t/handle/external/10_destroy.t so this list of URIs to be
    tested can be configured with environment variable SSLEAY_URIS, a
    colon separated list of host names. Suggested by tco2.
    - changed t/handle/external/50_external.t and t/external/08_external.t
    so this list of sites to be
    tested can be configured with environment variable SSLEAY_SITES, a
    colon separated list of host names. Suggested by tco2.
    - Fixed doucumentation in README of how to use OPENSSL_PREFIX
    environment variable to control the location of openssl. Reported by
    "Quanah Gibson-Mount via RT".
    - Don't use Module::Installs auto_install.
    - Bind NID_ and GEN_ constants.
    - Default to not running external tests.

1.32 03.08.2007
    - Don't let the tests die when something unexpected happens. Just BAIL_OUT.
    - Some Win32 improvements.

1.31_02 14.07.2007
    - Fix linking problems on Windows. Tested with VC++ 6.0, Shining Light
    0.9.7L on Windows Server 2003 with ActivePerl 5.8.8.820. Also tested
    with OpenSSL 0.9.8e compiled from source.
    - Unable to get working systems when compiling with MS Visual Studio
    Express 2005. Contributions requested. This may be relevant:
      http://www.itwriting.com/blog/?postid=261&replyto=2542
    - Fixed a number of minor compile warnings on Windows
    - Updated README.Win32 to define building procedures on Windows
    - Fixed incorrect test failure reports in 08_external.
    - Add parens to function calls in Makefile.PL to prevent
    warnings with some perls.
    - Tested on Sparc Solaris 8, Sparc Solaris 10, OpenSuSE 10.2 x64,
    OpenSuSE 10.0 x86, FreeBSD 6.0 x86, Ubuntu 6.10, Fedora Core 6 x86
    - Changed type of SSL_set_info_callback args to stop compiler warnings
    on Windows
    - Removed auto_include from Makefile.PL
    - Removed build_requires('Test::NoWarnings') from Makefile.PL
    - Testing with Strawberry Perl on Windows XP SP2, added doc to
    README.Win32
    - Testing with Perl CamelPack 5.8.7 on Windows XP SP2,added doc to
    README.Win32
    - Added optional support for SSL_set_hello_extension,
    SSL_set_session_secret_cb to support various extension patches from 
    a patch to openssl-0.9.9-dev contributed by Jouni Malinen. 
    See wpa_supplicant/patches/openssl-0.9.9-session-ticket.patch in the
    latest (git) version 0.6 and later of wpa_suplicant at 
    http://hostap.epitest.fi/. These additions are ifdefed to 
    SSL_F_SSL_SET_HELLO_EXTENSION which is added by the patch
    Tested with openssl-SNAP-20070816.
    - Added SSL_SESSION_set_master_key and SSL_get_keyblock_size.
    - Added all SSL_OP_* options flags present in 0.9.9
    - Fixed a bug in SSL_set_tmp_dh
    - Doc improvements in README.Win32
1.31_01 02.07.2007
    - Only bind X509_STORE_set_trust #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
    - Removed %Filenum_Objects from Net::SSLeay::Handle so unused handles will be freed.
    - Use ppport.h.
    - improved openssl path guessing, forcing openssl path now
            requires the -path flag (caution: incompatible flag change)
            Path guessing works on windows too.
            mikem, with patches from Stas Bekman
    - Added /usr/sfw/bin/openssl to path guessing for Open Solaris,
    suggested by Igor Boehme.
    - Fixed a problem with X509_get_subjectAltNames not working when the
    subjectAltNAmes are the first extension. Reported by Achim Grolms

1.30  21.12.2005
    - Fixed the MD5 function for hashsums containing \0
    - Fixed some compile warnings with recent gcc.
    - Fixed do_httpx3:
      + Don't add additional Host: headers if it's already given
      + Omit the :$port suffix for standard ports
      + Thanks to ivan-cpan-rt@420.am
    - Limit the chunk size when reading with tcp_read_all to 0x1000.
      This fixes various rt tickets.
    - Added patch to allow session caching
    - Mike McCauley and Florian Ragwitz maintain this module now
1.25  18.8.2003
    - added tcpecho.pl and tcpcat.pl to MANIFEST
    - fixed some further bugs with TCP read all, etc.
    - fixed some const char pointer warnings
1.24  25.6.2003
        - write_partial() return value patch from
          Kim Minh Kaplan <kmkaplan@selfoffice._com>
      3.8.2003
        - applied version check fix to Net::SSLeay::Handle.pm
          from Jason Rhinelander <jason@gossamer-threads._com>
      17.8.2003
    - new features: http and raw tcp support
    - fixed apparent STDIO vs. sysread bug in proxy connect
1.23  13.6.2003
    - some minor tweaks by many, mainly for RH build
    - memory leak and cleanup patches from Marian Jancar <mjancar@suse._cz>
1.22  8.1.2003
    - proxy auth fix from Bill.Muller@@ubsw_..com
      18.2.2003
    - RAND patch from Toni Andjelkovic <toni@soth._at>
1.21  6.9.2002
    - Patch by Mike McCauley mikem@open.com_.au
      19.9.2002
    - applied patch from Tim Engler <tim@burntcouch_.com>
      30.10.2002,
        - perl-5.8/gcc-3.2 patch on Makefile.PL from
      Joern_Hoos@@notes.uni-paderborn._de, lucho@@galix._com,
      bellis@@saberlogic._com, and simonclewer@@superquote._com
1.20  16.8.2002
    - Additional patch by Peter Behroozi <peter@@fhpwireless_.com> --Sampo
    - Patch by Mike McCauley mikem@open.com_.au
1.19  10.8.2002-16.8.2002
    - Added SSL_peek patch to ssl_read_until from 
          Peter Behroozi <peter@@fhpwireless_.com> --Sampo
    - Improved Windows instructions per Marcel Bucher <marcle@bucher._cc>
1.18  15.6.2002
    - applied minor patch by Mark Veltzer <mark@@veltzer._org> to Makefile.PL
1.17  8.6.2002
    - further fixes for Net::SSLeay::Handle from jbowlin@@_linklint.org
    - improved README.Win32 and added RECIPE.Win32 from
      Hermann Kelley <hkelley@@secmon._com>
1.16  17.4.2002-22.5.2002
        - applied patch to fix CTX_set_default_passwd_cb() contributed
          by Timo Kujala <timo.kujala@@intellitel_.com>, --Sampo
    - similar patch by Chris Ridd <chris.ridd@messagingdirect.com>
    - applied patch to add various API functions by mikem@open.com_.au
    - 5.005_03 compat fix for Handle.pm from Jim Mintha <jim@@ic._uva.nl>
1.15  3.4.2002
        - added `use bytes' from Marcus Taylor <marcus@@semantico_.com>
          This avoids unicode/utf8 (as may appear in some XML docs)
          from fooling the length comuptations.
    - Dropped support for perl5.005_03 because I do not have opportunity 
          to test it. --Sampo
1.14  25.3.2002
    - added code to Makefile.PL to verify that the same C compiler
      is used for both perl and openssl
    - added code to Makefile.PL to support aCC on HPUX. Detective
      work contributed by Marko Asplund.
    - added peer certificate support to hilevel API, inspired
      by mock@@_obscurity.org 
1.13  13.2.2002
    - eliminated initializing random numbers using /etc/passwd per
      comments by Matt Messier <matt@@securesw_.com>
    - tested against openssl-0.9.6c
1.12  6.1.2002
    - cosmetic fix to socket options from
          Kwindla Hultman Kramer <kwindla@@allafrica_.com>
1.11  14.12.2001,
    - Added proxy support to Net::SSLeay::Handle, too
1.10  7.12.2001,
    - Added proxy support by Bruno De Wolf <bruno.dewolf@@pandora._be>
1.09  20.8.2001,
    - fixed Makefile.PL (computation of bin_path) and test.pl ($perl
      use before defined) per Gordon Lack <gml4410@@_ggr.co.uk>
      11.9.2001,
    - Patch by Jeremy Mates <jmates@@_mbt.washington.edu> to make Handle.pm
      more acceptable for older perls
      25.9.2001,
    - systematically implemented many of the newer functions of
      openssl API (per popular request and for completeness)
1.08  25.4.2001,
    - applied 64 bit fixes by Marko Asplund <aspa@@kronodoc._fi>
      17.7.2001,
    - applied error codes and SSL_*_method patch by Noel Burton-Krahn
          <noel@burton-krahn.com> via aspa
    - warning cleanups by Jared Allison <jallison@@UU_.NET>
    - do last loop fixes from Jim Bowlin <bowlin@@_mindspring.com>
    - Fixed extra-newline-if-header-already-contained-newline problem
      reported by Sean McMurray <smcmurray@verio.net> (first reported by
      Yuao TANIGAWA <yuao@@_www.infosite.ne.jp> but not fixed by me back
      then for some reason, my bad)
    - Added ability to set client certificate for https_cat and sslcat
      as suggested by Avi Ben-Harush <avib@@_atomica.com>
    - created do_https2 with more rational calling sequence
      18.7.2001,
    - numerous windows oriented fixes from Eric A Selber
      <eselber@@_briefcase.com>
    - bumped OpenSSL version requirement to 0.9.6b and tested
    - merged in Net::SSLeay::Handle by Jim Bowlin <jbowlin@@_linklint.org>
1.07  18.4.2001,
    - TLSv1 support by Stephen C. Koehler <koehler@@securecomputing_.com>
1.06  7.4.2001, --Sampo
    - fixed ssl_read_all bug where `0' input was mistaken for EOF.
    - openssl-0.9.6a fixes (e.g. random number generator init)
    - various minor fixes subnitted by fellow netters (sorry, I lost track
      of your names so I do not name the contributors here)
1.05  31.1.1999, --Sampo
    - fixed test cert creation (lack of symlinks, reported
          by schinder@@_pobox.com)
    - callbacks fixed and tested to work
    - added Authentication examples
    - added couple more X509_STORE_CTX family functions
1.04  31.1.1999, Sampo Kellomaki <sampo@@_iki._fi>
    - Backward incompatible changes in OpenSSL API mean that 1.04 will
      drop support for SSLeay and all OpenSSL versions prior
      to 0.9.2b release. Thanks guys!
    - Detected errors in OpenSSL-0.9.2b/ssl/ssl.h - see patch in README
    - Reordered arguments of several functions to track OpenSSL-0.9.2b
      changes. This also changes the order of args in corresponding
      perl functions. You have been warned!
        - SSL_use_certificate_ASN1(s,d,len)  // swapped d and len
    - WARNING: Possibly fatal verify_callback parameter list issue
      is still standing
    - cleaned up many macros that used to access ctx->session directly,
      OpenSSL-0.9.2b defines thes macros properly so I use them now.
    - Added SSL_ctrl() and SSL_CTX_ctrl()
    - Added SSL_get_options(), SSL_CTX_get_options(),
      SSL_CTX_set_cipher_list()
    - Removed SSL_add_session(), SSL_remove_session(),
          and SSL_flush_sessions() per #if 0 in ssl.h, line 667
    - Updated paths in various utility programs
    - Upgraded version number detection logic in Makefile.PL
    - Added -rsaref flag to Makefile.PL. This allows linking against rsaref
    30.7.1999, final squeeze to get this out --Sampo
    - upgrade to OpenSSL-0.9.3a
    - upper case all header names so keys of the hash returned
      from get_https are predictible
    - fixed get_https and post_https so they don't do shutdown
      anymore. This used to cause headaches when connection
      renegotiation happened.
    - applied ssl_read_CRLF patch by Clinton Wong <clintdw@@netcom._com>
    - ActivePerl diffs from anton@@_genua.de applied,
      but not tested.
1.03  4.1.1999, Sampo Kellomaki <sampo@@iki._fi>
    - Merged URI encoding patch to make_form
      from Joe Rhett <jrhett@@navigist._com>
    - changed sslcat, ssl_read_all, ssl_write_all to return error messages
      as second member of list. Functions continue to behave the old way
      if scalar return value is used (they check this with wantarray).
      Change was suggested by Joe Rhett.
    - changed $trace levels so that 0 does not produce any output
    - changed get_https and put_https to fake error 900 in $response
      return field
    - changed print_errs and some other internals to return textual
      errors instead of error count
    - changed SSLeay.xs comments from #if 0 to #define REM. This will
      hopefully make it easier to compile with some vendor compilers
    - Added version detection code for OpenSSL-0.9.1c and checked
      build
1.02  8.7.1998, Sampo Kellomaki <sampo@@iki._fi>
    - Added SSL_(CTX)?_set_options and associated constants
    - Slight clean-ups
1.01  23.6.1998, Sampo Kellomaki <sampo@@iki_.fi>
    - made Makefile.PL check SSLeay version and to be more CPAN kosher
    - changed build instructions to build outside perl source tree
    - added random number initialization using /dev/urandom (if available)
    - made ssl_write_all accept references, this is more memory efficient
1.00  19.6.1998, Sampo Kellomaki <sampo@@_iki.fi>
    - overhauled to SSLeay-0.9.0
    - renamed cat to sslcat
    - added lots of convenience functions, like get_https
    - added couple of X509 routines
    - improved tests and documentation
    - fixed callbacks (but found that old callbacks dont work)
0.04  19.7.1996 Fixed some 0.6.1 incompatibilities, namely removed
      #include <ssl_locl.h>, fixed typo in SSL_get_cerificate, fixed
      the return type of the same. --Sampo
0.03  Renamed everything Net::SSLeay
0.02  Trial with SSL.pm name
0.01  Thu Jun 27 03:56:00 1996
    - original version; created by h2xs 1.16
#EOF