Struct Command

pub struct Command { /* private fields */ }

A command to be spawned.

Implementations

impl Command

pub fn new(prog: &str) -> Self

Creates a new command to be spawned.

prog should be the path to the program being spawned. If prog does not contain a /, then it will be searched in PATH similar to how a shell would do it.

The first argument passed to prog, argv[0], is prog itself.

pub fn arg(&mut self, arg: &str) -> &mut Self

Adds an argument to be passed to the command.

pub fn env(&mut self, key: &str, val: &str) -> &mut Self

Sets an environment variable for this command only.

pub fn fd<F: Into<OwnedFd>>(&mut self, idx: i32, fd: F) -> &mut Self

Sets a file descriptor of the process.

By default, the process starts with exactly stdin, stdout, and stderr open and all pointing to /dev/null.

pub fn stdin<F: Into<OwnedFd>>(&mut self, fd: F) -> &mut Self

Sets the stdin of the process.

This is equivalent to fd(0, fd).

pub fn stdout<F: Into<OwnedFd>>(&mut self, fd: F) -> &mut Self

Sets the stdout of the process.

This is equivalent to fd(1, fd).

pub fn stderr<F: Into<OwnedFd>>(&mut self, fd: F) -> &mut Self

Sets the stderr of the process.

This is equivalent to fd(2, fd).

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

Runs the application with access to privileged wayland protocols.

The default is false.

pub fn spawn(&self)

Executes the command.

This consumes all attached file descriptors.