#ocaml #ffi #smart-pointers #rust

sys ocaml-boxroot-sys

Boxroot for OCaml: fast movable GC roots (C API)

5 unstable releases

0.3.1 Mar 12, 2024
0.3.0 Feb 9, 2023
0.3.0-rc.1 Feb 3, 2023
0.2.0 Mar 18, 2021
0.1.0 Mar 11, 2021

#189 in Memory management

Download history 3277/week @ 2024-02-26 3195/week @ 2024-03-04 3323/week @ 2024-03-11 3051/week @ 2024-03-18 4170/week @ 2024-03-25 3697/week @ 2024-04-01 4675/week @ 2024-04-08 4518/week @ 2024-04-15 6392/week @ 2024-04-22 6486/week @ 2024-04-29 7358/week @ 2024-05-06 16733/week @ 2024-05-13 13898/week @ 2024-05-20 16703/week @ 2024-05-27 10965/week @ 2024-06-03 12563/week @ 2024-06-10

54,611 downloads per month
Used in 4 crates (2 directly)

MIT license

53KB
1K SLoC

C 1K SLoC // 0.2% comments Rust 148 SLoC // 0.1% comments

Boxroot for OCaml: fast movable GC roots

This library extends the OCaml foreign function interface with an efficient and flexible GC rooting mechanism. See https://gitlab.com/ocaml-rust/ocaml-boxroot/.

This crate exposes the raw functionality of the Boxroot library as unsafe Rust functions. It is meant to be used by low-level libraries to expose GC roots for the OCaml GC as smart pointers in Rust (see the crate ocaml-interop).

Running tests

The link-ocaml-runtime-and-dummy-program feature needs to be enabled when running tests:

cargo test --features "link-ocaml-runtime-and-dummy-program"

Feature flags

bundle-boxroot

If this feature flag is not enabled (by default it is enabled), the compilation of the C code that implements boxroot will be skipped, and the user is responsible of linking boxroot into the final binary.

When this feature flag is enabled, the OCaml headers must be available to be able to compile the boxroot C code.


lib.rs:

The documentation of the functions can be found inside boxroot/boxroot.h (including rules for safe usage)

Dependencies

~175KB