Go to file
Brent Cook 1c2a3f25e2 Remove cmake tests from travis builds for now.
This seemed like it should be easy, but apparently there are a lot of
gotchas that need to be ironed out in a branch first.
2015-09-09 07:45:54 -05:00
apps Add install targets and shared libraries to CMake 2015-08-18 13:20:19 -06:00
crypto Do not build lib-objects targets if we are just building static libs. 2015-09-09 06:03:52 -05:00
include remove support for old MSVC versions, KNF 2015-09-09 06:03:52 -05:00
libtls-standalone updates for MSVC 2015's degenerate headers 2015-09-09 06:02:28 -05:00
m4 disable strict aliasing on HP-UX C/aC++ compiler 2015-08-04 19:08:42 +09:00
man Add install targets and shared libraries to CMake 2015-08-18 13:20:19 -06:00
patches add initial CMake and Visual Studio build support 2015-07-21 12:08:18 -05:00
scripts Remove cmake tests from travis builds for now. 2015-09-09 07:45:54 -05:00
ssl Do not build lib-objects targets if we are just building static libs. 2015-09-09 06:03:52 -05:00
tests disable current broken cmake tests 2015-07-22 11:42:34 -05:00
tls Do not build lib-objects targets if we are just building static libs. 2015-09-09 06:03:52 -05:00
.gitignore adjust order for ! .gitignore rule precedence 2015-09-07 00:40:20 -05:00
.travis.yml remove builtin travis cmake because it is too old 2015-09-09 07:01:26 -05:00
autogen.sh fix libtool 2.4.2 stack-protector flag handling 2015-06-13 22:26:58 -05:00
ChangeLog update Changelog for 2.2.3 2015-08-30 22:17:55 -05:00
CMakeLists.txt Do not build lib-objects targets if we are just building static libs. 2015-09-09 06:03:52 -05:00
config Add an OpenSSL compatible ./config wrapper 2014-10-31 07:35:06 -05:00
configure.ac implement compatibility shim for __warn_references 2015-07-17 16:54:23 -05:00
dist-win.sh enable libtls by default 2015-03-19 00:39:50 -05:00
dist.sh enable libtls by default 2015-03-19 00:39:50 -05:00
gen-coverage-report.sh add branch coverage, skip coverage check of tests themselves 2015-05-07 07:56:19 -05:00
libcrypto.pc.in update pc files to use the package version, not library ABI version 2015-08-19 19:18:20 -05:00
libressl.pub Add the public signing key so it can be fetched from github 2014-07-14 20:50:52 -06:00
libssl.pc.in update pc files to use the package version, not library ABI version 2015-08-19 19:18:20 -05:00
libtls.pc.in update pc files to use the package version, not library ABI version 2015-08-19 19:18:20 -05:00
Makefile.am add initial CMake and Visual Studio build support 2015-07-21 12:08:18 -05:00
Makefile.am.common add initial CMake and Visual Studio build support 2015-07-21 12:08:18 -05:00
OPENBSD_BRANCH tie master libressl branch to openbsd master 2014-07-31 22:08:30 -05:00
openssl.pc.in add platform libraries to libcompat's LIBADD list 2014-07-12 03:34:08 -05:00
README.md replace remaining bash-only features in the update script 2015-08-28 06:03:33 -05:00
README.windows update messages about Cygwin support 2015-09-07 00:33:55 -05:00
update.sh distribute include and man CMakefiles 2015-09-07 00:31:59 -05:00

LibreSSL image

Official portable version of LibreSSL

Build Status

LibreSSL is a fork of OpenSSL 1.0.1g developed by the OpenBSD project. Our goal is to modernize the codebase, improve security, and apply best practice development processes from OpenBSD.

Compatibility with OpenSSL:

LibreSSL is API compatible with OpenSSL 1.0.1, but does not yet include all new APIs from OpenSSL 1.0.2 and later. LibreSSL also includes APIs not yet present in OpenSSL. The current common API subset is OpenSSL 1.0.1.

LibreSSL it is not ABI compatible with any release of OpenSSL, or necessarily earlier releases of LibreSSL. You will need to relink your programs to LibreSSL in order to use it, just as in moving between major versions of OpenSSL. LibreSSL's installed library version numbers are incremented to account for ABI and API changes.

Compatibility with other operating systems:

While primarily developed on and taking advantage of APIs available on OpenBSD, the LibreSSL portable project attempts to provide working alternatives for other operating systems, and assists with improving OS-native implementations where possible.

At the time of this writing, LibreSSL is know to build and work on:

  • Linux (kernel 3.17 or later recommended)
  • FreeBSD (tested with 9.2 and later)
  • NetBSD (tested with 6.1.5)
  • HP-UX (11i)
  • Solaris (11 and later preferred)
  • Mac OS X (tested with 10.8 and later)
  • AIX (5.3 and later)

LibreSSL also supports the following Windows environments:

  • Microsoft Windows (XP or higher, x86 and x64)
  • Wine (32-bit and 64-bit)
  • Builds with Mingw-w64, Cygwin, and Visual Studio

Official release tarballs are available at your friendly neighborhood OpenBSD mirror in directory LibreSSL, although we suggest that you use a mirror.

The LibreSSL portable build framework is also mirrored in Github.

Please report bugs either to the public libressl@openbsd.org mailing list, or to the github issue tracker

Severe vulnerabilities or bugs requiring coordination with OpenSSL can be sent to the core team at libressl-security@openbsd.org.

Prerequisites when building from git

If you have checked this source using Git, follow these initial steps to prepare the source tree for building:

  1. Ensure you have the following packages installed: automake, autoconf, git, libtool, perl, pod2man
  2. Run './autogen.sh' to prepare the source tree for building or run './dist.sh' to prepare a tarball.

Building LibreSSL

Once you have a source tree from Git or FTP, run these commands to build and install the package on most systems:

./configure   # see ./configure --help for configuration options
make check    # runs builtin unit tests
make install  # set DESTDIR= to install to an alternate location

If you wish to use the CMake build system, use these commands:

mkdir build
cd build
cmake ..
make
make test

For faster builds, you can use Ninja as well:

mkdir build-ninja
cd build-ninja
cmake -G"Ninja" ..
ninja
ninja test

OS specific build information:

HP-UX (11i)

Set the UNIX_STD environment variable to '2003' before running 'configure' in order to build with the HP C/aC++ compiler. See the "standards(5)" man page for more details.

export UNIX_STD=2003
./configure
make

Windows - Mingw-w64

LibreSSL builds against relatively recent versions of Mingw-w64, not to be confused with the original mingw.org project. Mingw-w64 3.2 or later should work. See README.windows for more information

Windows - Visual Studio

LibreSSL builds using the CMake target "Visual Studio 12 2013", and may build against older/newer targets as well. To generate a Visual Studio project, install CMake, enter the LibreSSL source directory and run:

 mkdir build-vs2013
 cd build-vs2013
 cmake -G"Visual Studio 12 2013" ..

This will generate a LibreSSL.sln file that you can incorporate into other projects or build by itself.