libreSSL/README
2014-07-10 06:07:09 -05:00

48 lines
1.9 KiB
Plaintext

This project repackages the OpenBSD (http://www.openbsd.org/) fork of
OpenSSL (https://www.openssl.org/), LibreSSL (http://www.libressl.org/), so
it is buildable on other systems.
To build, you need autoconf, automake and libtool installed.
To run all unit tests, you need python installed as well.
Run 'autogen.sh' followed by './configure; make; make check'
To build a tarball, run 'make dist'
You may need to periodically clean/dist-clean your source tree or rerun
autogen.sh/update.sh in order to import the latest source from the git
submodules.
Warning:
This is an alpha work-in-progress, not ready for general use. It is based on
semi-regular snapshots of the upstream code with minimal patching (see the
compat_fixes branches on the upstream import trees for current patches).
Use it this check application compatibility, security research, code auditing,
or to just see what the LibreSSL team is up to. Just don't use it in
production!
Please also read Nick Mathewson's warning on libottery. While we are not
currently incorporating this library for random numbers, the warning is still
relevant.
https://github.com/nmathewson/libottery
Caveat Emptor:
While this project uses compatibility shims and imports functions from
OpenBSD's libc, it is a continual challenge to make it work exactly the same as
if it is running on OpenBSD. Until there is an official port of LibreSSL (and
even after), please conduct your own audits and patches are always welcome.
http://insanecoding.blogspot.com/2014/04/common-libressl-porting-mistakes.html
http://insanecoding.blogspot.com/2014/05/a-good-idea-with-bad-usage-devurandom.html
See crypto/compat for the bulk of the local compatibility code.
It has been tested to build on these platforms:
Ubuntu 14.04 amd64 / armhf
Centos 6.5 i686
FreeBSD 10 amd64
Mac OS X 10.9.3
Coverity Scan Status: https://scan.coverity.com/projects/2493