Struct libafl::executors::command::CommandExecutorBuilder

pub struct CommandExecutorBuilder { /* private fields */ }

The builder for a default CommandExecutor that should fit most use-cases.

Implementations

impl CommandExecutorBuilder

pub fn program<O>(&mut self, program: O) -> &mut Self where
    O: AsRef<OsStr>, 

Set the binary to execute This option is required.

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

Sets the input mode to InputLocation::Arg and uses the current arg offset as argnum. During execution, at input will be provided as argument at this position. Use Self::arg_input_file_std if you want to provide the input as a file instead.

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

Sets the input mode to InputLocation::File and adds the filename as arg to at the current position. Uses a default filename. Use Self::arg_input_file to specify a custom filename.

pub fn arg_input_file<P: AsRef<Path>>(&mut self, path: P) -> &mut Self

Sets the input mode to InputLocation::File and adds the filename as arg to at the current position.

pub fn arg<O: AsRef<OsStr>>(&mut self, arg: O) -> &mut CommandExecutorBuilder

Adds an argument to the program’s commandline.

pub fn args<IT, O>(&mut self, args: IT) -> &mut CommandExecutorBuilder where
    IT: IntoIterator<Item = O>,
    O: AsRef<OsStr>, 

Adds a range of arguments to the program’s commandline.

pub fn envs<IT, K, V>(&mut self, vars: IT) -> &mut CommandExecutorBuilder where
    IT: IntoIterator<Item = (K, V)>,
    K: AsRef<OsStr>,
    V: AsRef<OsStr>, 

Adds a range of environment variables to the executed command.

pub fn env<K, V>(&mut self, key: K, val: V) -> &mut CommandExecutorBuilder where
    K: AsRef<OsStr>,
    V: AsRef<OsStr>, 

Adds an environment variable to the executed command.

pub fn current_dir<P: AsRef<Path>>(
    &mut self,
    dir: P
) -> &mut CommandExecutorBuilder

Sets the working directory for the child process.

pub fn debug_child(&mut self, debug_child: bool) -> &mut CommandExecutorBuilder

If set to true, the child’s output won’t be redirecited to /dev/null. Defaults to false.

pub fn build<EM, I, OT, S, Z>(
    &self,
    observers: OT
) -> Result<CommandExecutor<EM, I, OT, S, StdCommandConfigurator, Z>, Error> where
    OT: Debug + MatchName, 

Builds the ComandExecutor

Trait Implementations

impl Clone for CommandExecutorBuilder

fn clone(&self) -> CommandExecutorBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CommandExecutorBuilder

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

Formats the value using the given formatter.

impl Default for CommandExecutorBuilder

fn default() -> Self

Returns the “default value” for a type.