rusl 0.5.0

Rust linux interface layer
Documentation 
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

use core::ptr::addr_of_mut;

use crate::platform::WaitPidFlags;
use sc::syscall;

#[derive(Debug, Copy, Clone)]
pub struct WaitPidResult {
    pub pid: i32,
    pub status: i32,
}

/// Waits for the specified process to finish.
/// See [Linux docs for details](https://man7.org/linux/man-pages/man2/wait4.2.html)
/// # Errors
/// See above
pub fn wait_pid(pid: i32, flags: WaitPidFlags) -> crate::Result<WaitPidResult> {
    let mut wstatus = 0i32;
    let res = unsafe { syscall!(WAIT4, pid, addr_of_mut!(wstatus), flags.bits().bits(), 0) };
    bail_on_below_zero!(res, "`WAIT4` syscall failed");
    // We're trusting the syscall [API here](https://man7.org/linux/man-pages/man2/wait4.2.html#RETURN_VALUE)
    #[expect(clippy::cast_possible_truncation, clippy::cast_possible_wrap)]
    Ok(WaitPidResult {
        pid: res as i32,
        status: wstatus,
    })
}