Skip to content

Commit

Permalink
docs: Add documentation on new cmake/configure options
Browse files Browse the repository at this point in the history
  • Loading branch information
Keno authored and bagder committed Sep 27, 2016
1 parent dc8f7ca commit 1b80823
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 4 deletions.
18 changes: 16 additions & 2 deletions docs/INSTALL_AUTOTOOLS
Original file line number Diff line number Diff line change
Expand Up @@ -285,7 +285,7 @@ Some ./configure options deserve additional comments:

libssh2 can use the Libgcrypt library
(https://www.gnupg.org/) for cryptographic operations.
Either Libgcrypt or OpenSSL is required.
One of the cryptographic libraries is required.

Configure will attempt to locate Libgcrypt
automatically.
Expand All @@ -299,14 +299,28 @@ Some ./configure options deserve additional comments:

libssh2 can use the OpenSSL library
(https://www.openssl.org) for cryptographic operations.
Either Libgcrypt or OpenSSL is required.
One of the cryptographic libraries is required.

Configure will attempt to locate OpenSSL in the
default location.

If your installation of OpenSSL is in another
location, specify it using --with-libssl-prefix.

* --with-mbedtls
* --without-mbedtls
* --with-libmbedtls-prefix=[DIR]

libssh2 can use the mbedTLS library
(https://tls.mbed.org) for cryptographic operations.
One of the cryptographic libraries is required.

Configure will attempt to locate mbedTLS in the
default location.

If your installation of mbedTLS is in another
location, specify it using --with-libmbedtls-prefix.

* --with-libz
* --without-libz
* --with-libz-prefix=[DIR]
Expand Down
9 changes: 7 additions & 2 deletions docs/INSTALL_CMAKE
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ following cryptography libraries:
* OpenSSL
* Libgcrypt
* WinCNG
* mbedTLS

Getting started
---------------
Expand Down Expand Up @@ -48,8 +49,8 @@ The following options are available:

Chooses a specific cryptography library to use for cryptographic
operations. Can be `OpenSSL` (https://www.openssl.org),
`Libgcrypt` (https://www.gnupg.org/), `WinCNG` (Windows Vista+) or
blank to use any library available.
`Libgcrypt` (https://www.gnupg.org/), `WinCNG` (Windows Vista+),
`mbedTLS` (https://tls.mbed.org/) or blank to use any library available.

CMake will attempt to locate the libraries automatically. See [2]
for more information.
Expand Down Expand Up @@ -97,6 +98,10 @@ The following options are available:

Will enable the libssh2_trace() function for showing debug traces.

* `CLEAR_MEMORY=ON`

Securely zero memory before freeing it (if the backend supports this).

Build tools
-----------

Expand Down

0 comments on commit 1b80823

Please sign in to comment.