runng-sys

Rust FFI bindings to NNG (generated with bindgen):

NNG, like its predecessors nanomsg (and to some extent ZeroMQ), is a lightweight, broker-less library, offering a simple API to solve common recurring messaging problems, such as publish/subscribe, RPC-style request/reply, or service discovery. The API frees the programmer from worrying about details like connection management, retries, and other common considerations, so that they can focus on the application instead of the plumbing.

Usage

Version of this crate tracks NNG: <NNG_version>-rc.<crate_version> (e.g. 1.1.1-rc.2).

To use the latest crate for the most recent stable version of NNG (1.1.1), in Cargo.toml: toml runng-sys = "1.1.1-rc"

Requirements: - cmake in PATH - On Linux/macOS: default generator is "Unix Makefiles" and should just work - On Windows: default generator is ninja and must also be in PATH - libclang

For a more ergonomic API to NNG see runng.

Features

• cmake-ninja: use cmake generator "Ninja"
• cmake-vs2017: use cmake generator "Visual Studio 15 2017"
• cmake-vs2017-win64: use cmake generator "Visual Studio 15 2017 Win64"
• nng-stats: enable NNG stats NNG_ENABLE_STATS (enabled by default)
• nng-tls: enable TLS NNG_ENABLE_TLS (requires mbedTLS, disabled by default)

For example, to disable stats and use Ninja cmake generator: toml [dependencies.runng-sys] version = "1.1.1-rc" default-features = false features = ["cmake-ninja"]

Examples

```rust use runngsys::*; use std::{ffi::CString, ptr::nullmut};

[test]

fn example() { unsafe { let url = CString::new("inproc://test").unwrap(); let url = url.asbyteswithnul().asptr() as *const std::os::raw::c_char;

    // Reply socket
    let mut rep_socket = nng_socket { id: 0 };
    nng_rep0_open(&mut rep_socket);
    nng_listen(rep_socket, url, null_mut(), 0);

    // Request socket
    let mut req_socket = nng_socket { id: 0 };
    nng_req0_open(&mut req_socket);
    nng_dial(req_socket, url, null_mut(), 0);

    // Send message
    let mut req_msg: *mut nng_msg = null_mut();
    nng_msg_alloc(&mut req_msg, 0);
    // Add a value to the body of the message
    let val = 0x12345678;
    nng_msg_append_u32(req_msg, val);
    nng_sendmsg(req_socket, req_msg, 0);

    // Receive it
    let mut recv_msg: *mut nng_msg = null_mut();
    nng_recvmsg(rep_socket, &mut recv_msg, 0);
    // Remove our value from the body of the received message
    let mut recv_val: u32 = 0;
    nng_msg_trim_u32(recv_msg, &mut recv_val);
    assert_eq!(val, recv_val);
    // Can't do this because nng uses network order (big-endian)
    //assert_eq!(val, *(nng_msg_body(recv_msg) as *const u32));

    nng_close(req_socket);
    nng_close(rep_socket);
}

} ```