Crate rusty_doors

Rusty Doors

A streamlined and safe interface for creating and using Unix Doors.

A simple door server

use rusty_doors::{door_create, door_run};
use rusty_doors_macros::door;
use std::ffi::CString;

#[derive(Default)]
#[repr(C)]
struct Wrapped {
    val: u64,
    other: u16,
}

// To make a door handler just apply the #[door] attribute macro
#[door]
fn serv_proc(x: u64) -> Wrapped {
    let res = x + 47;
    println!("ARG: {}", x);
    return Wrapped {
        val: res,
        other: 99,
    };
}

fn main() {
    let path = CString::new("/tmp/addr-test-door").expect("cstring");
    let fd = door_create(serv_proc);
    door_run(fd, path.as_c_str());
}

A door client

use rusty_doors::door_call;
use std::fs::File;
use std::os::unix::io::AsRawFd;

#[derive(Default)]
#[repr(C)]
struct Wrapped {
    val: u64,
    other: u16,
}

fn main() {
    let file = File::open("/tmp/addr-test-door").expect("open fd");

    let x: u64 = 74;
    let res: Wrapped = door_call(file.as_raw_fd(), x);

    assert_eq!(res.val, 121);
    assert_eq!(res.other, 99);
}

Modules

sys

System level doors elements.

Functions

door_call

Call the door referenced by fd with argument data x. Returns door call result by value.

door_call_slice

Call the door referenced by fd with argument slice x. Returns doo call result by value.

door_callp

Call the door referenced by fd with argument data x. The address pointed to by res will be allocated by the door, and the result placed at that location. The return value is the address to the pointed to address.

door_create

Create a door. The provided sys::DoorFunc will be called any time this door is called. Returns a file descriptor reference the created door.

door_run

Run a door server for the door handler referenced by fd. fd should be the result of calling door_create.