llam 0.1.3

Safe, Go-style Rust bindings for the LLAM runtime
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

use crate::error::{Error, Result};
use crate::sys;
use std::io;
use std::os::raw::{c_short, c_void};

pub type Fd = sys::llam_fd_t;

pub const READABLE: i16 = 0x0001;
pub const WRITABLE: i16 = 0x0004;

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct PollResult {
    pub ready_count: i32,
    pub revents: i16,
}

pub fn read(fd: Fd, buf: &mut [u8]) -> io::Result<usize> {
    let n = unsafe { sys::llam_read(fd, buf.as_mut_ptr() as *mut c_void, buf.len()) };
    if n < 0 {
        Err(Error::last().into())
    } else {
        Ok(n as usize)
    }
}

pub fn read_when_ready(fd: Fd, buf: &mut [u8], timeout_ms: i32) -> io::Result<usize> {
    let n = unsafe {
        sys::llam_read_when_ready(fd, buf.as_mut_ptr() as *mut c_void, buf.len(), timeout_ms)
    };
    if n < 0 {
        Err(Error::last().into())
    } else {
        Ok(n as usize)
    }
}

pub fn write(fd: Fd, buf: &[u8]) -> io::Result<usize> {
    let n = unsafe { sys::llam_write(fd, buf.as_ptr() as *const c_void, buf.len()) };
    if n < 0 {
        Err(Error::last().into())
    } else {
        Ok(n as usize)
    }
}

pub fn poll_fd(fd: Fd, events: i16, timeout_ms: i32) -> Result<i16> {
    poll(fd, events, timeout_ms).map(|result| result.revents)
}

pub fn poll(fd: Fd, events: i16, timeout_ms: i32) -> Result<PollResult> {
    let mut revents: c_short = 0;
    let rc = unsafe { sys::llam_poll_fd(fd, events as c_short, timeout_ms, &mut revents) };
    if rc >= 0 {
        Ok(PollResult {
            ready_count: rc,
            revents: revents as i16,
        })
    } else {
        Err(Error::last())
    }
}

pub fn accept(fd: Fd) -> io::Result<Fd> {
    let accepted = unsafe { sys::llam_accept(fd, std::ptr::null_mut(), std::ptr::null_mut()) };
    if sys::fd_is_invalid(accepted) {
        Err(Error::last().into())
    } else {
        Ok(accepted)
    }
}

/// Connect a raw socket using LLAM's managed I/O path.
///
/// # Safety
///
/// `addr` and `addrlen` must describe a valid socket address for `fd`.
pub unsafe fn connect_raw(
    fd: Fd,
    addr: *const libc::sockaddr,
    addrlen: sys::socklen_t,
) -> io::Result<()> {
    let rc = sys::llam_connect(fd, addr, addrlen);
    if rc == 0 {
        Ok(())
    } else {
        Err(Error::last().into())
    }
}

pub struct OwnedBuf {
    raw: *mut sys::llam_io_buffer_t,
}

unsafe impl Send for OwnedBuf {}

impl OwnedBuf {
    pub fn as_slice(&self) -> &[u8] {
        if self.raw.is_null() {
            return &[];
        }
        unsafe {
            std::slice::from_raw_parts(
                sys::llam_io_buffer_data(self.raw) as *const u8,
                sys::llam_io_buffer_size(self.raw),
            )
        }
    }

    pub fn capacity(&self) -> usize {
        if self.raw.is_null() {
            0
        } else {
            unsafe { sys::llam_io_buffer_capacity(self.raw) }
        }
    }
}

impl Drop for OwnedBuf {
    fn drop(&mut self) {
        if !self.raw.is_null() {
            unsafe { sys::llam_io_buffer_release(self.raw) };
            self.raw = std::ptr::null_mut();
        }
    }
}

pub fn read_owned(fd: Fd, max_count: usize) -> io::Result<Option<OwnedBuf>> {
    let mut raw = std::ptr::null_mut();
    let n = unsafe { sys::llam_read_owned(fd, max_count, &mut raw) };
    if n < 0 {
        Err(Error::last().into())
    } else if raw.is_null() {
        Ok(None)
    } else {
        Ok(Some(OwnedBuf { raw }))
    }
}

pub fn recv_owned(fd: Fd, max_count: usize, flags: i32) -> io::Result<Option<OwnedBuf>> {
    let mut raw = std::ptr::null_mut();
    let n = unsafe { sys::llam_recv_owned(fd, max_count, flags, &mut raw) };
    if n < 0 {
        Err(Error::last().into())
    } else if raw.is_null() {
        Ok(None)
    } else {
        Ok(Some(OwnedBuf { raw }))
    }
}