aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
blob: 465f115a7eab281abf593396b81ae10789c24ba4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
= nng - nanomsg-next-gen

image:https://img.shields.io/badge/license-MIT-blue.svg[MIT License]
https:https://img.shields.io/circleci/project/github/nanomsg/nng.svg?label=[Linux Status,link="https://circleci.com/gh/nanomsg/nng"]
image:https://img.shields.io/travis/nanomsg/nng/master.svg?label=linux[Linux Status,link="https://travis-ci.org/nanomsg/nng"]
image:https://img.shields.io/appveyor/ci/nanomsg/nng/master.svg?label=windows[Windows Status,link="https://ci.appveyor.com/project/nanomsg/nng"]
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".  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* 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.

Some https://nanomsg.github.io/nng/man/[manual pages] are posted
on GitHub pages.

If you are looking for the current production version of nanomsg, please
see the https://github.com/nanomsg/nanomsg[nanomsg repo].

If you want to build and test yourself, you need CMake version 3.1, and
you can use standard CMake build recipes.  On a Linux/UNIX system, 
you can for example do:

[source,sh]
----
  $ mkdir build
  $ cmake ..
  $ make
  $ 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 documented, 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_.

== Commercial Support

Please contact mailto:info@staysail.tech[Staysail Systems, Inc.] to
inquire about commercial support.