1 Because this project is maintained both in the OpenBSD tree using CVS and in
2 Git, it can be confusing following all of the changes.
4 Most of the libssl and libcrypto source code is is here in OpenBSD CVS:
6 http://cvsweb.openbsd.org/cgi-bin/cvsweb/src/lib/libssl/
8 Some of the libcrypto and OS-compatibility files for entropy and random number
11 http://cvsweb.openbsd.org/cgi-bin/cvsweb/src/lib/libcrypto/
13 A simplified TLS wrapper library is here:
15 http://cvsweb.openbsd.org/cgi-bin/cvsweb/src/lib/libtls/
17 The LibreSSL Portable project copies these portions of the OpenBSD tree, along
18 with relevant portions of the C library, to a Git repository. This makes it
19 easier to follow all of the relevant changes to the upstream project in a
22 https://github.com/libressl-portable/openbsd
24 The portable bits of the project are largely maintained out-of-tree, and their
25 history is also available from Git.
27 https://github.com/libressl-portable/portable
29 LibreSSL Portable Release Notes:
31 2.4.3 - Bug fixes and reliability improvements
33 * Reverted change that cleans up the EVP cipher context in
34 EVP_EncryptFinal() and EVP_DecryptFinal(). Some software relies on the
37 * Avoid unbounded memory growth in libssl, which can be triggered by a
38 TLS client repeatedly renegotiating and sending OCSP Status Request
41 * Avoid falling back to a weak digest for (EC)DH when using SNI with
44 2.4.2 - Bug fixes and improvements
46 * Fixed loading default certificate locations with openssl s_client.
48 * Ensured OSCP only uses and compares GENERALIZEDTIME values as per
49 RFC6960. Also added fixes for OCSP to work with intermediate
50 certificates provided in responses.
52 * Improved behavior of arc4random on Windows to not appear to leak
53 memory in debug tools, reduced privileges of allocated memory.
55 * Fixed incorrect results from BN_mod_word() when the modulus is too
56 large, thanks to Brian Smith from BoringSSL.
58 * Correctly handle an EOF prior to completing the TLS handshake in
61 * Improved libtls ceritificate loading and cipher string validation.
63 * Updated libtls cipher group suites into four categories:
64 "secure" (TLSv1.2+AEAD+PFS)
65 "compat" (HIGH:!aNULL)
66 "legacy" (HIGH:MEDIUM:!aNULL)
67 "insecure" (ALL:!aNULL:!eNULL)
68 This allows for flexibility and finer grained control, rather than
71 * Limited support for 'backward compatible' SSLv2 handshake packets to
72 when TLS 1.0 is enabled, providing more restricted compatibility
75 * openssl(1) and other documentation improvements.
77 * Removed flags for disabling constant-time operations.
78 This removes support for DSA_FLAG_NO_EXP_CONSTTIME,
79 DH_FLAG_NO_EXP_CONSTTIME, and RSA_FLAG_NO_CONSTTIME flags, making
80 all of these operations unconditionally constant-time.
85 * Correct a problem that prevents the DSA signing algorithm from
86 running in constant time even if the flag BN_FLG_CONSTTIME is set.
87 This issue was reported by Cesar Pereida (Aalto University), Billy
88 Brumley (Tampere University of Technology), and Yuval Yarom (The
89 University of Adelaide and NICTA). The fix was developed by Cesar
92 2.4.0 - Build improvements, new features
94 * Many improvements to the CMake build infrastructure, including
95 Solaris, mingw-w64, Cygwin, and HP-UX support. Thanks to Kinichiro
96 Inoguchi for this work.
98 * Added missing error handling around bn_wexpand() calls.
100 * Added explicit_bzero calls for freed ASN.1 objects.
102 * Fixed X509_*set_object functions to return 0 on allocation failure.
104 * Implemented the IETF ChaCha20-Poly1305 cipher suites.
106 * Changed default EVP_aead_chacha20_poly1305() implementation to the
107 IETF version, which is now the default.
109 * Fixed password prompts from openssl(1) to properly handle ^C.
111 * Reworked error handling in libtls so that configuration errors are
114 * Deprecated internal use of EVP_[Cipher|Encrypt|Decrypt]_Final.
116 * Manpage fixes and updates
118 2.3.5 - Reliability fix
120 * Fixed an error in libcrypto when parsing some ASN.1 elements > 16k.
122 2.3.4 - Security Update
124 * Fix multiple vulnerabilities in libcrypto relating to ASN.1 and encoding.
129 2.3.3 - OpenBSD 5.9 release branch tagged
131 * Reworked build scripts to better sync with OpenNTPD-portable
133 * Fixed broken manpage links
135 * Fixed an nginx compatibility issue by adding an 'install_sw' make alias
139 * Changed the default configuration directory to c:\LibreSSL\ssl on Windows
142 * cert.pem has been reorganized and synced with Mozilla's certificate store
144 2.3.2 - Compatibility and Reliability fixes
146 * Changed format of LIBRESSL_VERSION_NUMBER to match that of
147 OPENSSL_VERSION_NUMBER, see:
148 https://wiki.openssl.org/index.php/Manual:OPENSSL_VERSION_NUMBER(3)
150 * Added EVP_aead_chacha20_poly1305_ietf() which matches the AEAD
151 construction introduced in RFC 7539, which is different than that
152 already used in TLS with EVP_aead_chacha20_poly1305()
154 * Avoid a potential undefined C99+ behavior due to shift overflow in
155 AES_decrypt, reported by Pascal Cuoq <cuoq at trust-in-soft.com>
157 * More man pages converted from pod to mdoc format
159 * Added COMODO RSA Certification Authority and QuoVadis
160 root certificates to cert.pem
162 * Removed Remove "C=US, O=VeriSign, Inc., OU=Class 3 Public Primary Certification
163 Authority" (serial 3c:91:31:cb:1f:f6:d0:1b:0e:9a:b8:d0:44:bf:12:be) root
164 certificate from cert.pem
166 * Added support for building nc(1) on Solaris
168 * Fixed GCC 5.x+ preprocessor checks, reported by Ruslan Babayev
170 * Improved console handling with openssl(1) on Windows
172 * Ensure the network stack is enabled on Windows when running
175 * Fixed incorrect TLS certificate loading by nc(1)
177 * Added support for Solaris 11.3's getentropy(2) system call
179 * Enabled support for using NetBSD 7.0's arc4random(3) implementation
181 * Deprecated the SSL_OP_SINGLE_DH_USE flag by disabling its effect
183 * Fixes from OpenSSL 1.0.1q
184 - CVE-2015-3194 - NULL pointer dereference in client side certificate
186 - CVE-2015-3195 - Memory leak in PKCS7 - not reachable from TLS/SSL
188 * The following OpenSSL CVEs did not apply to LibreSSL
189 - CVE-2015-3193 - Carry propagating bug in the x86_64 Montgomery
191 - CVE-2015-3196 - Double free race condition of the identify hint
194 See https://marc.info/?l=openbsd-announce&m=144925068504102
196 2.3.1 - ASN.1 and time handling cleanups
198 * ASN.1 cleanups and RFC5280 compliance fixes.
200 * Time representations switched from 'unsigned long' to 'time_t'. LibreSSL
201 now checks if the host OS supports 64-bit time_t.
203 * Fixed a leak in SSL_new in the error path.
205 * Support always extracting the peer cipher and version with libtls.
207 * Added ability to check certificate validity times with libtls,
208 tls_peer_cert_notbefore and tls_peer_cert_notafter.
210 * Changed tls_connect_servername to use the first address that resolves with
213 * Remove broken conditional EVP_CHECK_DES_KEY code (non-functional since
214 initial commit in 2004).
216 * Fixed a memory leak and out-of-bounds access in OBJ_obj2txt, reported
219 * Fixed an up-to 7 byte overflow in RC4 when len is not a multiple of
220 sizeof(RC4_CHUNK), reported by Pascal Cuoq <cuoq at trust-in-soft.com>.
222 * Reject too small bits value in BN_generate_prime_ex(), so that it does
223 not risk becoming negative in probable_prime_dh_safe(), reported by
226 * Enable nc(1) builds on more platforms.
228 2.3.0 - SSLv3 removed, libtls API changes, portability improvements
230 * SSLv3 is now permanently removed from the tree.
232 * The libtls API is changed from the 2.2.x series.
234 The read/write functions work correctly with external event
235 libraries. See the tls_init man page for examples of using libtls
236 correctly in asynchronous mode.
238 Client-side verification is now supported, with the client supplying
239 the certificate to the server.
241 Also, when using tls_connect_fds, tls_connect_socket or
242 tls_accept_fds, libtls no longer implicitly closes the passed in
243 sockets. The caller is responsible for closing them in this case.
245 * When loading a DSA key from an raw (without DH parameters) ASN.1
246 serialization, perform some consistency checks on its `p' and `q'
247 values, and return an error if the checks failed.
249 Thanks for Georgi Guninski (guninski at guninski dot com) for
250 mentioning the possibility of a weak (non prime) q value and
251 providing a test case.
254 https://cpunks.org/pipermail/cypherpunks/2015-September/009007.html
255 for a longer discussion.
257 * Fixed a bug in ECDH_compute_key that can lead to silent truncation
258 of the result key without error. A coding error could cause software
259 to use much shorter keys than intended.
261 * Removed support for DTLS_BAD_VER. Pre-DTLSv1 implementations are no
264 * The engine command and parameters are removed from the openssl(1).
265 Previous releases removed dynamic and builtin engine support
268 * SHA-0 is removed, which was withdrawn shortly after publication 20
271 * Added Certplus CA root certificate to the default cert.pem file.
273 * New interface OPENSSL_cpu_caps is provided that does not allow
274 software to inadvertently modify cpu capability flags.
275 OPENSSL_ia32cap and OPENSSL_ia32cap_loc are removed.
277 * The out_len argument of AEAD changed from ssize_t to size_t.
279 * Deduplicated DTLS code, sharing bugfixes and improvements with
282 * Converted 'nc' to use libtls for client and server operations; it is
283 included in the libressl-portable distribution as an example of how
286 2.2.3 - Bug fixes, build enhancements
288 * LibreSSL 2.2.2 incorrectly handles ClientHello messages that do not
289 include TLS extensions, resulting in such handshakes being aborted.
290 This release corrects the handling of such messages. Thanks to
291 Ligushka from github for reporting the issue.
293 * Added install target for cmake builds. Thanks to TheNietsnie from
296 * Updated pkgconfig files to correctly report the release version
297 number, not the individual library ABI version numbers. Thanks to
298 Jan Engelhardt for reporting the issue.
300 2.2.2 - More TLS parser rework, bug fixes, expanded portable build support
302 * Switched 'openssl dhparam' default from 512 to 2048 bits
304 * Reworked openssl(1) option handling
306 * More CRYPTO ByteString (CBC) packet parsing conversions
308 * Fixed 'openssl pkeyutl -verify' to exit with a 0 on success
310 * Fixed dozens of Coverity issues including dead code, memory leaks,
311 logic errors and more.
313 * Ensure that openssl(1) restores terminal echo state after reading a
316 * Incorporated fix for OpenSSL Issue #3683
318 * LibreSSL version define LIBRESSL_VERSION_NUMBER will now be bumped
319 for each portable release.
321 * Removed workarounds for TLS client padding bugs.
323 * No longer disable ECDHE-ECDSA on OS X
325 * Removed SSLv3 support from openssl(1)
327 * Removed IE 6 SSLv3 workarounds.
329 * Modified tls_write in libtls to allow partial writes, clarified with
330 examples in the documentation.
332 * Removed RSAX engine
334 * Tested SSLv3 removal with the OpenBSD ports tree and found several
335 applications that were not ready to build without SSLv3 yet. For
336 now, building a program that intentionally uses SSLv3 will result in
339 * Added TLS_method, TLS_client_method and TLS_server_method as a
340 replacement for the SSLv23_*method calls.
342 * Added initial cmake build support, including support for building with
343 Visual Studio, currently tested with Visual Studio 2013 Community
346 * --with-enginesdir is removed as a configuration parameter
348 * Default cert.pem, openssl.cnf, and x509v3.cnf files are now
349 installed under $sysconfdir/ssl or the directory specified by
350 --with-openssldir. Previous versions of LibreSSL left these empty.
352 2.2.1 - Build fixes, feature added, features removed
354 * Assorted build fixes for musl, HP-UX, Mingw, Solaris.
356 * Initial support for Windows Embedded 2009, Server 2003, XP
358 * Protocol parsing conversions to BoringSSL's CRYPTO ByteString (CBS) API
360 * Added EC_curve_nid2nist and EC_curve_nist2nid from OpenSSL
362 * Removed Dynamic Engine support
364 * Removed unused and obsolete MDC-2DES cipher
366 * Removed workarounds for obsolete SSL implementations
368 2.2.0 - Build cleanups and new OS support, Security Updates
370 * AIX Support - thanks to Michael Felt
372 * Cygwin Support - thanks to Corinna Vinschen
374 * Refactored build macros, support packaging libtls independently.
375 There are more pieces required to support building and using OpenSSL
376 with libtls, but this is an initial start at providing an
377 independent package for people to start hacking on.
379 * Removal of OPENSSL_issetugid and all library getenv calls.
380 Applications can and should no longer rely on environment variables
381 for changing library behavior. OPENSSL_CONF/SSLEAY_CONF is still
382 supported with the openssl(1) command.
384 * libtls API and documentation additions
386 * Various bug fixes and simplifications to libssl and libcrypto
388 * Fixes for the following issues are integrated into LibreSSL 2.2.0:
389 - CVE-2015-1788 - Malformed ECParameters causes infinite loop
390 - CVE-2015-1789 - Exploitable out-of-bounds read in X509_cmp_time
391 - CVE-2015-1792 - CMS verify infinite loop with unknown hash function
393 * The following CVEs did not apply to LibreSSL or were fixed in
395 - CVE-2015-4000 - DHE man-in-the-middle protection (Logjam)
396 - CVE-2015-1790 - PKCS7 crash with missing EnvelopedContent
397 - CVE-2014-8176 - Invalid free in DTLS
399 * Fixes for the following CVEs are still in review for LibreSSL
400 - CVE-2015-1791 - Race condition handling NewSessionTicket
402 2.1.6 - Security update
404 * Fixes for the following issues are integrated into LibreSSL 2.1.6:
405 - CVE-2015-0209 - Use After Free following d2i_ECPrivatekey error
406 - CVE-2015-0286 - Segmentation fault in ASN1_TYPE_cmp
407 - CVE-2015-0287 - ASN.1 structure reuse memory corruption
408 - CVE-2015-0288 - X509_to_X509_REQ NULL pointer deref
409 - CVE-2015-0289 - PKCS7 NULL pointer dereferences
411 * The fix for CVE-2015-0207 - Segmentation fault in DTLSv1_listen
412 is integrated for safety, but LibreSSL is not vulnerable.
414 * Libtls is now built by default. The --enable-libtls
415 configuration option is no longer required.
416 The libtls API is now stable for the 2.1.x series.
418 2.1.5 - Bug fixes and a security update
419 * Fix incorrect comparison function in openssl(1) certhash command.
420 Thanks to Christian Neukirchen / Void Linux.
422 * Windows port improvements and bug fixes.
423 - Removed a dependency on libgcc in 32-bit dynamic libraries.
424 - Correct a hang in openssl(1) reading from stdin on an connection.
425 - Initialize winsock in openssl(1) earlier, allow 'openssl ocsp' and
426 any other network-related commands to function properly.
428 * Reject all server DH keys smaller than 1024 bits.
430 2.1.4 - Security and feature updates
431 * Improvements to libtls:
432 - a new API for loading CA chains directly from memory instead of a
433 file, allowing verification with privilege separation in a chroot
434 without direct access to CA certificate files.
436 - Ciphers default to TLSv1.2 with AEAD and PFS.
438 - Improved error handling and message generation
440 - New APIs and improved documentation
442 * Added X509_STORE_load_mem API for loading certificates from memory.
443 This facilitates accessing certificates from a chrooted environment.
445 * New AEAD "MAC alias" allows configuring TLSv1.2 AEAD ciphers by
446 using 'TLSv1.2+AEAD' as the cipher selection string.
448 * Dead and disabled code removal including MD5, Netscape workarounds,
449 non-POSIX IO, SCTP, RFC 3779 support, many #if 0 sections, and more.
451 * ASN1 macro maze expanded to aid reading and searching the code.
453 * NULL pointer asserts removed in favor of letting the OS/signal
456 * Refactored argument handling in openssl(1) for consistency and
459 * New openssl(1) command 'certhash' replaces the c_rehash script.
461 * Support for building with OPENSSL_NO_DEPRECATED
463 * Server-side support for TLS_FALLBACK_SCSV for compatibility with
464 various auditor and vulnerability scanners.
466 * Dozens of issues found with the Coverity scanner fixed.
470 - Fix a minor information leak that was introduced in t1_lib.c
471 r1.71, whereby an additional 28 bytes of .rodata (or .data) is
472 provided to the network. In most cases this is a non-issue since
473 the memory content is already public. Issue found and reported by
474 Felix Groebert of the Google Security Team.
476 - Fixes for the following low-severity issues were integrated into
477 LibreSSL from OpenSSL 1.0.1k:
479 CVE-2015-0205 - DH client certificates accepted without
481 CVE-2014-3570 - Bignum squaring may produce incorrect results
482 CVE-2014-8275 - Certificate fingerprints can be modified
483 CVE-2014-3572 - ECDHE silently downgrades to ECDH [Client]
484 Reported by Karthikeyan Bhargavan of the PROSECCO team at INRIA.
486 The following CVEs were fixed in earlier LibreSSL releases:
487 CVE-2015-0206 - Memory leak handling repeated DLTS records
488 CVE-2014-3510 - Flaw handling DTLS anonymous EC(DH) ciphersuites.
490 The following CVEs did not apply to LibreSSL:
491 CVE-2014-3571 - DTLS segmentation fault in dtls1_get_record
492 CVE-2014-3569 - no-ssl3 configuration sets method to NULL
493 CVE-2015-0204 - RSA silently downgrades to EXPORT_RSA
495 2.1.3 - Security update and OS support improvements
496 * Fixed various memory leaks in DTLS, including fixes for
499 * Added Application-Layer Protocol Negotiation (ALPN) support.
501 * Removed GOST R 34.10-94 signature authentication.
503 * Removed nonfunctional Netscape browser-hang workaround code.
505 * Simplfied and refactored SSL/DTLS handshake code.
507 * Added SHA256 Camellia cipher suites for TLS 1.2 from RFC 5932.
509 * Hide timing info about padding errors during handshakes.
511 * Improved libtls support for non-blocking sockets, added randomized
512 session ID contexts. Work is ongoing with this library - feedback
513 and potential use-cases are welcome.
515 * Support building Windows DLLs.
516 Thanks to Jan Engelhard.
518 * Packaged config wrapper for better compatibility with OpenSSL-based
520 Thanks to @technion from github
522 * Ensure the stack is marked non-executable for assembly sections.
523 Thanks to Anthony G. Bastile.
525 * Enable extra compiler hardening flags by default, where applicable.
526 The default set of hardening features can vary by OS to OS, so
527 feedback is welcome on this. To disable the default hardening flags,
528 specify '--disable-hardening' during configure.
531 * Initial HP-UX support, tested with HP-UX 11.31 ia64
532 Thanks to Kinichiro Inoguchi
534 * Initial NetBSD support, tested with NetBSD 6.1.5 x86_64
535 Imported from OpenNTPD, thanks to @gitisihara from github
537 2.1.2 - Many new features and improvements
538 * Added reworked GOST cipher suite support
539 thanks to Dmitry Eremin-Solenikov
541 * Enabled Camellia ciphers due to improved patent situation
543 * Use builtin arc4random implementation on OS X and FreeBSD
544 this addresses some deficiencies in the native implementations of
545 these operating systems, see commit logs for more information
547 * Added initial Windows mingw-w64 support (32 and 64-bit)
548 thanks to Song Dongsheng and others for code and feedback
550 * Enabled assembly optimizations on x86_64 CPUs
551 supports Linux, *BSD, Solaris and OS X operating systems
552 thanks to Wouter Clarie for the initial implementation
554 * Added no_ssl3/no_tls1_1/no_tls1_2 options to openssl(1)
556 * Improved build infrastructure, 'make distcheck' now passes
557 this simplifies and speeds developer efficiency
558 thanks to Dmitry Eremin-Solenikov and Wouter Clarie
560 * Allow conditional building of the libtls library
561 expect the API and ABI of the library to change
564 * Fixes for more memory leaks, cleanups, etc.
566 2.1.1 - Security update
567 * Address POODLE attack by disabling SSLv3 by default
569 * Fix Eliptical Curve cipher selection bug
570 (https://github.com/libressl-portable/portable/issues/35)
572 2.1.0 - First release from the OpenBSD 5.7 tree
573 * Added support for automatic ephemeral EC keys
575 * Fixes for many memory leaks and overflows in error handlers
577 * The TLS padding extension (that works around bugs in F5 terminators) is
580 * support for getrandom(2) on Linux 3.17
582 * the NO_ASM macro is no longer being set, providing the first bits toward
583 enabling other assembly offloads.
585 2.0.5 - Fixes for CVEs from OpenSSL 1.0.1i
588 * CVE-2014-3508 (partially vulnerable)he
592 * Synced LibreSSL Portable with the release version of OpenBSD 5.6
594 2.0.4 - Portability fixes, deleted unused SRP code
596 2.0.3 - Portability fixes, improvements to fork detection
598 2.0.2 - Address arc4random fork PID wraparound issues with pthread_atfork
600 2.0.1 - Portability fixes:
601 * Removed -Werror and and other non-portable compiler flags
603 * Allow setting OPENSSLDIR and ENGINSDIR
605 2.0.0 - First release from the OpenBSD 5.6 tree
606 * Removal of many obsolete features and coding conventions from the OpenSSL