Struct Process 

pub struct Process { /* private fields */ }

A handle to a spawned process.

Fork Safety

The process handle contains a PID. After a fork, the child process will have a copy of this PID, but it refers to the same original process. Calling wait or kill from the child may lead to confusing results if multiple processes are managing the same PID.

Implementations

impl Process

pub fn new(pid: pid_t) -> Self

Create a handle for an existing PID.

pub fn pid(&self) -> pid_t

Return the process ID.

pub fn wait_step(&self) -> Result<Option<ExitStatus>, CoreError>

Perform a non-blocking wait for process termination.

Errors

• ECHILD: The process does not exist or is not a child of the caller.
• EINTR: The call was interrupted by a signal (handled internally).

pub fn wait_blocking(&self) -> Result<ExitStatus, CoreError>

Block until the process terminates.

Errors

• ECHILD: The process does not exist or is not a child of the caller.

pub fn kill(&self, sig: i32) -> Result<(), CoreError>

Send a signal to the process.

Errors

• EINVAL: Invalid signal number.
• EPERM: The caller does not have permission to send the signal.
• ESRCH: The process does not exist.

pub fn kill_pgroup(&self, sig: i32) -> Result<(), CoreError>

Send a signal to the process group.

Errors

Same as Self::kill.