#clone #linux #syscall

clone3

Rust bindings to the clone3 linux system call

5 releases

0.2.3 Dec 7, 2022
0.2.2 Jul 8, 2022
0.2.1 Jul 7, 2022
0.2.0 Jan 12, 2021
0.1.0 Jan 10, 2021

#473 in Unix APIs

Download history 177/week @ 2023-10-29 185/week @ 2023-11-05 179/week @ 2023-11-12 185/week @ 2023-11-19 87/week @ 2023-11-26 52/week @ 2023-12-03 76/week @ 2023-12-10 62/week @ 2023-12-17 46/week @ 2023-12-24 36/week @ 2023-12-31 101/week @ 2024-01-07 260/week @ 2024-01-14 163/week @ 2024-01-21 85/week @ 2024-01-28 51/week @ 2024-02-04 362/week @ 2024-02-11

699 downloads per month

MIT license

17KB
348 lines

crates.io, docs.rs

clone3

Rust bindings to the clone3 linux system call.

Development

Currently the bindings we provide are unsafe. We could look into making a safe wrapper on a restricted subset of the api.


lib.rs:

Bindings to the clone3 linux system call.

See the clone3 man page for more information.

This is a complex and generally unsafe operation. Users must understand the documentation to use it safely and correctly.

Examples

use clone3::Clone3;

let mut pidfd = -1;
let mut clone3 = Clone3::default();
clone3.flag_pidfd(&mut pidfd);

match unsafe { clone3.call() }.unwrap() {
    0 => println!("i am the child"),
    child => println!("i am the parent, my child has pid {} and my pidfd is {}", child, pidfd),
}

Features

The clone3 api can change in a backward compatible manner between Linux kernel versions. This crate supports picking the target version through Cargo features like linux_5-5, linux_5-7. The default is the newest kernel version. Specifying no linux feature corresponds to the initial clone3 api.

Dependencies

~4–6MB
~111K SLoC