unsaferawbuf

Crates.iounsaferawbuf
lib.rsunsaferawbuf
version0.1.3
sourcesrc
created_at2022-10-12 06:09:48.593412
updated_at2024-07-26 08:56:29.510821
descriptionConvenient interface to a portion of manually allocated memory.
homepage
repositoryhttps://github.com/Starz0r/unsaferawbuf-rs
max_upload_size
id685960
size6,228
(Starz0r)

documentation

https://docs.rs/unsaferawbuf

README

UnsafeRawBuf

GitHub crates.io badge Docs.rs rustc requirements

unsaferawbuf provides a interface to a raw chunk of allocated memory. Intended for usage with libraries or applications that can typically only communicate over via a shared memory region. Thus, making it very unsafe, and the crate it's self, provides very little safety guarantees. This simply acts as a container around a raw memory address, and does pointer arithmetic around it when reading and writing data to it. Allowing for some additional convenience when transacting from an arbitrary memory address is unavoidable.

Usage

Right now, you can only initialize a UnsafeRawBuf from a raw memory address. In the future, you'll be able to create a freshly allocated memory buffer along with it's associated interface. As of now, that is currently impossible, so for now we have to manually allocate memory, then assign it to the container.

use std::ffi::c_void;
use unsaferawbuf::UnsafeRawBuf;

pub unsafe extern "C" fn dmp(addr: *mut c_void) {
    let buf = UnsafeRawBuf::from_address(addr as _);
    buf.write(42);
}
Commit count: 9

cargo fmt