Struct waitpid_any::WaitHandle

pub struct WaitHandle(_);

A locked handle to a process.

See WaitHandle::open for more details.

Implementations

impl WaitHandle

pub fn open(pid: i32) -> Result<Self>

Open an handle to the process with given PID.

The opened handle always points to the same process entity, thus preventing race condition caused by PID reusing.

Errors

Fails when the underlying syscall fails.

Caveats

1. PID itself does not own any resource in most platforms. Thus there is still a race condition when the process pointed by the original PID is dead, reaped, and recycled all before calling to this function. This is generally unavoidable. But you can try to open the PID as soon as possible, before any potential wait operations, to mitigate the issue.
2. If the given PID does not exists, it returns ESRCH on *NIX immediately. This can also happen if the process is exited and reaped before this call. You may want to regards this case as a successful wait, but the decision is up to you.

pub fn wait(&mut self) -> Result<()>

Blocks until the target process exits, and then returns Ok(()).

Errors

Fails when the underlying syscall fails.

pub fn wait_timeout(&mut self, timeout: Duration) -> Result<Option<()>>

Blocks until the target process exits, and then returns Ok(Some(())). If the process is not exited in timeout, it returns None.

Errors

Fails when the underlying syscall fails, or the process is still not exited after timeout elapsed.

Trait Implementations

impl Debug for WaitHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.