fork of boring2 with prefix patch
Go to file
Valerii Hiora 0cc749d3fc Runtime fallout 2014-11-21 11:57:48 +02:00
openssl-sys Runtime fallout 2014-11-21 11:57:48 +02:00
src Slice syntax fix 2014-11-20 19:53:42 +02:00
test Replace an expired cert with a new one to make tests happy 2014-11-20 19:53:31 +02:00
.gitignore New build system 2014-11-13 15:17:00 +02:00
.travis.yml Fix travis features 2014-11-16 14:03:58 -08:00
Cargo.toml Move AES XTS support to a feature 2014-11-16 14:01:24 -08:00
LICENSE Update copyright date 2014-01-15 21:43:09 -08:00
README.md Update doc location 2014-10-26 13:10:57 -07:00
THIRD_PARTY New build system 2014-11-13 15:17:00 +02:00

README.md

rust-openssl Build Status

See the rustdoc output.

Building

rust-openssl needs to link against the OpenSSL devleopment libraries on your system. It's very easy to get them on Linux.
For some reason, the OpenSSL distribution for Windows is structured differently, so it's a little more involved, but it is possible to build rust-openssl successfully on Windows.

###Linux

  1. Run sudo apt-get install libssl-dev.
  2. Run cargo build.

###Windows

  1. Grab the latest Win32 OpenSSL installer here. At the time of this writing, it's v1.0.1i. If you're using 64-bit Rust (coming to Windows soon), then you should get the Win64 installer instead.
  2. Run the installer, making note of where it's installing OpenSSL. The option to copy the libraries to the Windows system directory or [OpenSSL folder]/bin is your choice. The latter is probably preferable, and the default.
  3. Navigate to [OpenSSL folder]/lib/MinGW/, and copy libeay32.a and ssleay32.a (If 64-bit, then they will have 64 instead of 32.) to your Rust install's libs folder. The default should be:
  • 32-bit: C:\Program Files (x86)\Rust\bin\rustlib\i686-pc-mingw32\lib
  • 64-bit: TODO
  1. Rename libeay32.a and ssleay32.a to libcrypto.a and libssl.a, respectively.
  2. Run cargo build.

###Testing Several tests expect a local test server to be running to bounce requests off of. It's easy to do this. Open a separate terminal window and cd to the rust-openssl directory. Then run one of the following commands:

  • Windows: openssl s_server -accept 15418 -www -cert test/cert.pem -key test/key.pem > NUL
  • Linux: openssl s_server -accept 15418 -www -cert test/cert.pem -key test/key.pem >/dev/null

Then in the original terminal, run cargo test. If everything is set up correctly, all tests should pass. You might get some warnings in the openssl s_server window. Those aren't anything to worry about. You can stop the server using Control-C.