Struct WslExecutable 

pub struct WslExecutable(/* private fields */);

wsl.exe, as found on this host or as a test says it is.

Why %SystemRoot% is used here and refused in crate::runner_root

runner_root derives the default runner root from GetSystemDirectoryW and says explicitly that it will not read %SystemDrive%, because that value decides where an ACL’d directory is created — a wrong answer there is a security-relevant mistake that nothing downstream would notice.

This is the weaker question of where one well-known executable is, and its wrong answer is loud: wsl.exe is either at the path or it is not, and a missing program is a WslError::Spawn naming the path it tried. So the environment is used as a hint, with a documented fallback to a bare wsl.exe, which resolves through PATH exactly as it would in an operator’s own shell.

Implementations

impl WslExecutable

pub fn locate() -> Self

Where wsl.exe is on this host.

%SystemRoot%\System32\wsl.exe when %SystemRoot% names a directory that has it, and a bare wsl.exe otherwise.

pub fn at(path: impl Into<PathBuf>) -> Self

A named executable, for a test or for a caller that already knows.

pub fn path(&self) -> &Path

The path that will be launched.

Trait Implementations

impl Clone for WslExecutable

fn clone(&self) -> WslExecutable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WslExecutable

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

Formats the value using the given formatter.

impl Default for WslExecutable

fn default() -> Self

Returns the “default value” for a type.

impl Display for WslExecutable

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

Formats the value using the given formatter.

impl Eq for WslExecutable

impl PartialEq for WslExecutable

fn eq(&self, other: &WslExecutable) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for WslExecutable