pub struct PopenConfig {
    pub stdin: Redirection,
    pub stdout: Redirection,
    pub stderr: Redirection,
    pub detached: bool,
    pub executable: Option<OsString>,
    pub env: Option<Vec<(OsString, OsString)>>,
    pub cwd: Option<OsString>,
    /* private fields */
}
Expand description

Options for Popen::create.

When constructing PopenConfig, always use the Default trait, such as:

Popen::create(argv, PopenConfig {
     stdout: Redirection::Pipe,
     detached: true,
     // ... other fields you want to override ...
     ..Default::default()
})

This ensures that fields added later do not break existing code.

An alternative to using PopenConfig directly is creating processes using Exec, a builder for Popen.

Fields

stdin: Redirection

How to configure the executed program’s standard input.

stdout: Redirection

How to configure the executed program’s standard output.

stderr: Redirection

How to configure the executed program’s standard error.

detached: bool

Whether the Popen instance is initially detached.

executable: Option<OsString>

Executable to run.

If provided, this executable will be used to run the program instead of argv[0]. However, argv[0] will still be passed to the subprocess, which will see that as argv[0]. On some Unix systems, ps will show the string passed as argv[0], even though executable is actually running.

env: Option<Vec<(OsString, OsString)>>

Environment variables to pass to the subprocess.

If this is None, environment variables are inherited from the calling process. Otherwise, the specified variables are used instead.

Duplicates are eliminated, with the value taken from the variable appearing later in the vector.

cwd: Option<OsString>

Initial current working directory of the subprocess.

None means inherit the working directory from the parent.

Implementations

Clone the underlying PopenConfig, or return an error.

This is guaranteed not to fail as long as no Redirection::File variant is used for one of the standard streams. Otherwise, it fails if File::try_clone fails on one of the Redirections.

Returns the environment of the current process.

The returned value is in the format accepted by the env member of PopenConfig.

Trait Implementations

Formats the value using the given formatter. Read more

Returns the “default value” for a type. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.