diff options
| author | Garrett D'Amore <garrett@damore.org> | 2017-11-09 14:09:14 -0800 |
|---|---|---|
| committer | Garrett D'Amore <garrett@damore.org> | 2017-11-20 21:49:09 -0800 |
| commit | 02178a8b5843a2c5a59fb7b104e4f9f5df1ff5ee (patch) | |
| tree | 122ee2bebf060aa26d6fa0778b877a6b7ca9b864 /README.adoc | |
| parent | e8694d15d0a108895bf869f292d59e11d834361e (diff) | |
| download | nng-02178a8b5843a2c5a59fb7b104e4f9f5df1ff5ee.tar.gz nng-02178a8b5843a2c5a59fb7b104e4f9f5df1ff5ee.tar.bz2 nng-02178a8b5843a2c5a59fb7b104e4f9f5df1ff5ee.zip | |
fixes #3 TLS transport
This introduces a new transport (compatible with the TLS
transport from mangos), using TLS v1.2.
To use the new transport, you must have the mbed TLS library
available on your system (Xenial libmbedtls-dev). You can use
version 2.x or newer -- 1.3.x and PolarSSL versions are not
supported.
You enable the TLS transport with -DNNG_TRANSPORT_TLS=ON in the CMake
configuration.
You must configure the server certificate by default, and this can only
be done using nng options. See the nng_tls man page for details.
This work is experimental, and was made possible by Capitar IT Group BV,
and Staysail Systems, Inc.
Diffstat (limited to 'README.adoc')
| -rw-r--r-- | README.adoc | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/README.adoc b/README.adoc index fc4bbcfa..cd2fb949 100644 --- a/README.adoc +++ b/README.adoc @@ -7,15 +7,14 @@ image:https://img.shields.io/appveyor/ci/nanomsg/nng/master.svg?label=windows[Wi image:https://codecov.io/gh/nanomsg/nng/branch/master/graph/badge.svg?label=coverage[Coverage,link="https://codecov.io/gh/nanomsg/nng"] This repository represents a work in progress rewrite of the SP protocol -library called "libnanomsg". The work is being done by Garrett D'Amore, -and at this juncture he is not yet soliciting implementation assistance; -that said if you want to help with this project please file an issue -with details about what you'd like to do, and you will be contacted. +library called "libnanomsg". This is pre-release, but at this point you +can start using it for development, as we believe we are getting closer +to release readiness. Review and testing feedback are appreciated however; but please understand that the project is still quite preliminary. -This is a work in progress, and is *not* for suitable for product use or +This is a work in progress, and is *not* for suitable for production use or publication. When the library is ready for broader consumption, an announcement will be posted on the nanomsg mailing list and website. @@ -37,9 +36,14 @@ you can for example do: $ make test ---- +If you want to enable the TLS transport, which is not supported by legacy +nanomsg, use -DNNG_TRANSPORT_TLS=ON in your cmake command line. You will +need to have the ARM mbedTLS library installed. (This is available in +Xenial Ubuntu as libmbedtls-dev). + The API is not yet stable, but if you want to explore using the newer API, pleaes have a look at the `nng.h` header file. A legacy compatible `nng_compat.h` header is available and offers API compatibility with legacy _nanomsg_. - - Garrett D'Amore (Oct. 30, 2017) + - Garrett D'Amore (Nov. 20, 2017) |