native-ipc 0.2.0

Secure-by-construction foundations for native cross-process IPC
Documentation 
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

//! Uses one interface while selecting the best backend for the current OS.

use native_ipc::memory::{NativeRegion, RegionOptions, WriterOwner, native_memory_capabilities};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let capabilities = native_memory_capabilities();
    let options = RegionOptions::growable(128, 4096, WriterOwner::Creator);
    let mut region = NativeRegion::allocate(options)?;

    region.initialize(|bytes| bytes[..8].copy_from_slice(b"NIPCDEMO"));
    region.grow(512)?;
    region.initialize(|bytes| assert_eq!(&bytes[..8], b"NIPCDEMO"));

    let status = region.status();
    println!(
        "backend={:?} authority={:?} logical={} mapped={} maximum={}",
        capabilities.platform(),
        capabilities.authority_mechanism(),
        status.logical_len,
        status.mapped_len,
        status.maximum_len,
    );

    region.clear();
    region.initialize(|bytes| bytes[..8].copy_from_slice(b"REUSABLE"));

    // `destroy` explicitly clears the complete mapping before releasing it.
    // Use `prepare_for_sharing` instead when handing the region to the
    // authenticated platform transfer typestate.
    region.destroy();
    Ok(())
}