diff options
| author | Brent Cook <bcook@openbsd.org> | 2015-03-02 23:14:35 -0600 |
|---|---|---|
| committer | Brent Cook <bcook@openbsd.org> | 2015-03-02 23:14:35 -0600 |
| commit | 79492b46f6200764468bbb199e7e46cfe0c4a17e (patch) | |
| tree | dff54eccd7b04b49cf2e04f5d9de00792f7b700c /README.windows | |
| parent | e0855bdb1dd7507b76a2a43a5c926f7b36055799 (diff) | |
| download | portable-79492b46f6200764468bbb199e7e46cfe0c4a17e.tar.gz portable-79492b46f6200764468bbb199e7e46cfe0c4a17e.tar.bz2 portable-79492b46f6200764468bbb199e7e46cfe0c4a17e.zip | |
add windows README, package README files with distribution
Diffstat (limited to 'README.windows')
| -rw-r--r-- | README.windows | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/README.windows b/README.windows new file mode 100644 index 0000000..12e4963 --- /dev/null +++ b/README.windows | |||
| @@ -0,0 +1,40 @@ | |||
| 1 | # Building | ||
| 2 | |||
| 3 | For Windows systems, LibreSSL supports the mingw-w64 toolchain, which can use | ||
| 4 | GCC or Clang as the compiler. Contrary to its name, mingw-w64 supports both | ||
| 5 | 32-bit and 64-bit build environments. If your project already uses mingw-w64, | ||
| 6 | then LibreSSL should integrate very nicely. Old versions of the mingw-w64 | ||
| 7 | toolchain, such as the one packaged with Ubuntu 12.04, may have trouble | ||
| 8 | building LibreSSL. Please try it with a recent toolchain if you encounter | ||
| 9 | troubles. If you are building under Cygwin, only builds with the mingw-w64 | ||
| 10 | compiler are supported, though you can easily use Cygwin to drive the build | ||
| 11 | process. | ||
| 12 | |||
| 13 | To configure and build LibreSSL for a 32-bit system, use the following | ||
| 14 | build steps: | ||
| 15 | |||
| 16 | CC=i686-w64-mingw32-gcc ./configure --host=i686-w64-mingw32 | ||
| 17 | make | ||
| 18 | make check | ||
| 19 | |||
| 20 | For 64-bit builds, use these instead: | ||
| 21 | |||
| 22 | CC=x86_64-w64-mingw32-gcc ./configure --host=x86_64-w64-mingw32 | ||
| 23 | make | ||
| 24 | make check | ||
| 25 | |||
| 26 | # Using Libressl with Visual Studio | ||
| 27 | |||
| 28 | A script for generating ready-to-use .DLL and static .LIB files is included in | ||
| 29 | the source repository at | ||
| 30 | https://github.com/libressl-portable/portable/blob/master/dist-win.sh | ||
| 31 | |||
| 32 | This script uses mingw-w64 to build LibreSSL and then uses Visual Studio tools | ||
| 33 | to generate compatible library import files ready-to-use with Visual | ||
| 34 | Studio projects. Static and dynamic libraries are included. The script uses | ||
| 35 | cv2pdb to generate Visual Studio and windbg compatible debug files. cv2pdb is a | ||
| 36 | tool developed for the D language and can be found here: | ||
| 37 | https://github.com/rainers/cv2pdb | ||
| 38 | |||
| 39 | Pre-build Windows binaries are available with the LibreSSL release for your | ||
| 40 | convenience. | ||