Struct Process 

pub struct Process { /* private fields */ }

Process in a virtual system

Implementations

impl Process

pub fn with_parent_and_group(ppid: Pid, pgid: Pid) -> Process

Creates a new running process.

pub fn fork_from(ppid: Pid, parent: &Process) -> Process

Creates a new running process as a child of the given parent.

Some part of the parent process state is copied to the new process.

pub fn ppid(&self) -> Pid

Returns the process ID of the parent process.

pub fn pgid(&self) -> Pid

Returns the process group ID of this process.

pub fn uid(&self) -> Uid

Returns the real user ID of this process.

pub fn set_uid(&mut self, uid: Uid)

Sets the real user ID of this process.

pub fn euid(&self) -> Uid

Returns the effective user ID of this process.

pub fn set_euid(&mut self, euid: Uid)

Sets the effective user ID of this process.

pub fn gid(&self) -> Gid

Returns the real group ID of this process.

pub fn set_gid(&mut self, gid: Gid)

Sets the real group ID of this process.

pub fn egid(&self) -> Gid

Returns the effective group ID of this process.

pub fn set_egid(&mut self, egid: Gid)

Sets the effective group ID of this process.

pub fn fds(&self) -> &BTreeMap<Fd, FdBody>

Returns FDs open in this process.

pub fn get_fd(&self, fd: Fd) -> Option<&FdBody>

Returns the body for the given FD.

pub fn get_fd_mut(&mut self, fd: Fd) -> Option<&mut FdBody>

Returns the body for the given FD.

pub fn set_fd(&mut self, fd: Fd, body: FdBody) -> Result<Option<FdBody>, FdBody>

Assigns the given FD to the body.

If successful, returns an Ok value containing the previous body for the FD. If the FD is equal to or greater than the current soft limit for Resource::NOFILE, returns Err(body).

pub fn open_fd_ge(&mut self, min_fd: Fd, body: FdBody) -> Result<Fd, FdBody>

Assigns a new FD to the given body.

The new FD will be the minimum unused FD equal to or greater than min_fd.

If successful, the new FD is returned in Ok. If no more FD can be opened, returns Err(body).

pub fn open_fd(&mut self, body: FdBody) -> Result<Fd, FdBody>

Assigns a new FD to the given body.

The new FD will be the minimum unused FD, which will be returned as an Ok value.

If no more FD can be opened, returns Err(body).

pub fn close_fd(&mut self, fd: Fd) -> Option<FdBody>

Removes the FD body for the given FD.

pub fn close_fds(&mut self)

Removes all FD bodies in this process.

pub fn getcwd(&self) -> &Path

Returns the working directory path.

pub fn chdir(&mut self, path: PathBuf)

Changes the working directory.

This function does not check if the directory exists and is accessible.

pub fn wake_on_resumption(&mut self, waker: Weak<Cell<Option<Waker>>>)

Registers a waker that will be woken up when this process resumes.

The given waker will be woken up when this process is resumed by set_state or raise_signal. A strong reference to the waker must be held by the caller until the waker is woken up, when the waker is consumed and the Cell content is set to None.

This function does nothing if the process is not stopped.

pub fn state(&self) -> ProcessState

Returns the process state.

pub fn set_state(&mut self, state: ProcessState) -> bool

Sets the state of this process.

If the new state is Exited or Signaled, all file descriptors in this process are closed.

This function returns whether the state did change. If true, the state_has_changed flag is set and the caller must notify the state change by sending SIGCHLD to the parent process.

pub fn state_has_changed(&self) -> bool

Returns true if a new state has been set but not yet taken.

pub fn take_state(&mut self) -> ProcessState

Returns the process state and clears the state_has_changed flag.

pub fn blocked_signals(&self) -> &BTreeSet<Number>

Returns the currently blocked signals.

pub fn pending_signals(&self) -> &BTreeSet<Number>

Returns the currently pending signals.

A signal is pending when it has been raised but not yet delivered because it is being blocked.

pub fn block_signals( &mut self, how: SigmaskOp, signals: &[Number], ) -> SignalResult

Updates the signal blocking mask for this process.

If this function unblocks a signal, any pending signal is delivered.

If the signal changes the execution state of the process, this function returns a SignalResult with process_state_changed being true. In that case, the caller must send a SIGCHLD to the parent process of this process.

pub fn disposition(&self, number: Number) -> Disposition

Returns the current disposition for a signal.

If no disposition is set for the signal, the default disposition is returned.

pub fn set_disposition( &mut self, number: Number, disposition: Disposition, ) -> Disposition

Gets and sets the disposition for a signal.

This function sets the disposition to the given value and returns the previous disposition.

pub fn raise_signal(&mut self, signal: Number) -> SignalResult

Sends a signal to this process.

If the signal is being blocked, it will remain pending. Otherwise, it is immediately delivered.

If the signal changes the execution state of the process, this function returns a SignalResult with process_state_changed being true. In that case, the caller must send a SIGCHLD to the parent process of this process.

pub fn last_exec(&self) -> &Option<(CString, Vec<CString>, Vec<CString>)>

Returns the arguments to the last call to execve on this process.

Trait Implementations

impl Clone for Process

fn clone(&self) -> Process

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Process

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

Formats the value using the given formatter.