Struct pal::unix::process::Builder

pub struct Builder<'a> { /* private fields */ }

A builder for a child process.

Implementations

impl<'a> Builder<'a>

pub fn new(program: impl Into<PathBuf>) -> Self

Creates a new process builder for program.

pub fn arg0(&mut self, arg: impl Into<OsString>) -> &mut Self

Sets argv[0].

pub fn arg(&mut self, arg: impl Into<OsString>) -> &mut Self

Appends a command-line argument.

pub fn args<I, S>(&mut self, args: I) -> &mut Self

where I: IntoIterator<Item = S>, S: Into<OsString>,

Appends a list of command-line arguments.

pub fn env<K, V>(&mut self, key: K, val: V) -> &mut Self

where K: Into<OsString>, V: Into<OsString>,

Sets the environment variable key to val.

pub fn env_remove<K: Into<OsString>>(&mut self, key: K) -> &mut Self

Removes the environment variable key.

pub fn env_clear(&mut self) -> &mut Self

Clears all environment variables.

pub fn stdin(&mut self, stdin: Stdio<'a>) -> &mut Self

Sets the policy for stdin.

pub fn stdout(&mut self, stdout: Stdio<'a>) -> &mut Self

Sets the policy for stdout.

pub fn stderr(&mut self, stderr: Stdio<'a>) -> &mut Self

Sets the policy for stderr.

pub fn close_fd(&mut self, fd: i32) -> &mut Self

Closes fd in the new process.

pub fn dup_fd(&mut self, oldfd: BorrowedFd<'a>, newfd: i32) -> &mut Self

Duplicates oldfd to newfd in the new process.

pub fn setuid(&mut self, uid: u32) -> &mut Self

Sets the real and effective user id of the new process.

pub fn uid(&self) -> Option<u32>

Gets the real and effective user id of the new process.

pub fn setgid(&mut self, gid: u32) -> &mut Self

Sets the real and effective group id of the new process.

pub fn gid(&self) -> Option<u32>

Gets the real and effective user id of the new process.

pub fn set_vfork(&mut self, vfork: bool) -> &mut Self

Sets whether the new process will vfork or not.

pub fn vfork(&mut self) -> bool

Gets whether the new process will vfork or not.

pub fn set_sandbox_failure_mode( &mut self, mode: SandboxFailureMode, ) -> &mut Self

Sets the sandbox failure mode.

pub fn sandbox_failure_mode(&mut self) -> SandboxFailureMode

Gets the sandbox failure mode.

pub fn set_permitted_caps(&mut self, caps: CapsHashSet) -> &mut Self

Sets the permitted and inheritable capabilities of the new process.

pub fn permitted_caps(&mut self) -> Option<CapsHashSet>

Gets the permitted and inheritable capabilities of the new process.

pub fn set_effective_caps(&mut self, caps: CapsHashSet) -> &mut Self

Sets the effective capabilities of the new process.

pub fn effective_caps(&mut self) -> Option<CapsHashSet>

Gets the effective capabilities of the new process.

pub fn set_ambient_caps(&mut self, caps: CapsHashSet) -> &mut Self

Sets the ambient capabilities of the new process.

pub fn ambient_caps(&mut self) -> Option<CapsHashSet>

Gets the ambient capabilities of the new process.

pub fn set_inheritable_caps(&mut self, caps: CapsHashSet) -> &mut Self

Sets the inheritable capabilities of the new process.

pub fn inheritable_caps(&mut self) -> Option<CapsHashSet>

Gets the inheritable capabilities of the new process.

pub fn set_bounding_caps(&mut self, caps: CapsHashSet) -> &mut Self

Sets the bounding capabilities of the new process.

pub fn bounding_caps(&mut self) -> Option<CapsHashSet>

Gets the bounding capabilities of the new process.

pub fn set_landlock_rules( &mut self, landlock_rules: RulesetCreated, ) -> &mut Self

Sets the landlock ruleset of the new process.

pub fn landlock_rules(&mut self) -> Option<RulesetCreated>

Gets the landlock ruleset of the new process.

pub fn set_seccomp_filter(&mut self, seccomp_filter: SeccompFilter) -> &mut Self

Sets the seccomp filter for the new process.

pub fn seccomp_filter(&mut self) -> Option<SeccompFilter>

Gets the seccomp filter for the new process.

pub fn setsid(&mut self, setsid: bool) -> &mut Self

Creates a new session with the new process as the leader.

pub fn controlling_terminal( &mut self, controlling_terminal: BorrowedFd<'a>, ) -> &mut Self

Sets the controlling terminal for the new process.

pub fn spawn(&self) -> Result<Child>

Spawns the process.