Struct WslRunner 

pub struct WslRunner {
    pub distro: Option<String>,
}

WSL process runner for Windows.

WslRunner provides secure process execution via WSL using argv-style APIs only. It wraps commands with wsl.exe --exec to execute them in a WSL distribution without shell interpretation.

Security

WslRunner enforces the following security properties:

• Uses wsl.exe --exec with argv-style argument passing only
• Arguments are passed as discrete OsString elements via CommandSpec
• NO shell string concatenation of user data
• NO sh -c or shell string evaluation
• Arguments are validated/normalized at trust boundaries

Platform Support

WslRunner is only functional on Windows. On non-Windows platforms, it will return an error indicating WSL is not available.

Example

use xchecker_utils::runner::{WslRunner, ProcessRunner, CommandSpec};
use std::time::Duration;

let runner = WslRunner::new();
let cmd = CommandSpec::new("echo")
    .arg("hello")
    .arg("world");

// On Windows with WSL, this executes: wsl.exe --exec echo hello world
let output = runner.run(&cmd, Duration::from_secs(30)).unwrap();

Fields

distro: Option<String>

Optional specific WSL distro to use (e.g., “Ubuntu-22.04”)

Implementations

impl WslRunner

pub const fn new() -> Self

Create a new WslRunner using the default WSL distribution.

Example

use xchecker_utils::runner::WslRunner;

let runner = WslRunner::new();

pub fn with_distro(distro: impl Into<String>) -> Self

Create a new WslRunner targeting a specific WSL distribution.

Arguments

• distro - The name of the WSL distribution (e.g., “Ubuntu-22.04”)

Example

use xchecker_utils::runner::WslRunner;

let runner = WslRunner::with_distro("Ubuntu-22.04");

Trait Implementations

impl Clone for WslRunner

fn clone(&self) -> WslRunner

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WslRunner

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

Formats the value using the given formatter.

impl Default for WslRunner

fn default() -> WslRunner

Returns the “default value” for a type.

impl ProcessRunner for WslRunner

fn run( &self, cmd: &CommandSpec, timeout: Duration, ) -> Result<ProcessOutput, RunnerError>

Execute a command via WSL using argv-style APIs.

This implementation:

• Wraps the command with wsl.exe --exec (no shell)
• Uses Command::new().args() only (no shell string evaluation)
• Validates arguments at trust boundaries
• Handles timeout via thread-based waiting
• Captures stdout and stderr

Arguments

• cmd - The command specification to execute
• timeout - Maximum duration to wait for the process to complete

Returns

• Ok(ProcessOutput) - The process completed (possibly with non-zero exit code)
• Err(RunnerError::Timeout) - The process timed out
• Err(RunnerError::WslExecutionFailed) - Failed to spawn or wait for process
• Err(RunnerError::WslNotAvailable) - WSL is not available (non-Windows platform)

Security

This method builds a WSL command using build_wsl_command() which:

• Uses --exec to bypass shell interpretation
• Passes arguments as discrete elements via CommandSpec
• Validates all arguments at trust boundaries
• NO shell string concatenation of user data occurs