Crate wslapi

APIs for managing the Windows Subsystem for Linux (wslapi.h)

use wslapi::*;

let wsl = Library::new().unwrap();

let nonexistant = "Nonexistant";
assert!(!wsl.is_distribution_registered(nonexistant));
assert!(wsl.get_distribution_configuration(nonexistant).is_err());

let mut found = 0;
for ubuntu in ["Ubuntu", "Ubuntu-18.04", "Ubuntu-16.04"].iter().copied() {
    if !wsl.is_distribution_registered(ubuntu) { continue }
    found += 1;

    let cfg = wsl.get_distribution_configuration(ubuntu).unwrap();
    assert!(cfg.default_uid == 0 || (1000 ..= 2000).contains(&cfg.default_uid));
    // 0 == root, 1000+ == regular user
    assert!(cfg.flags & WSL_DISTRIBUTION_FLAGS::DEFAULT == WSL_DISTRIBUTION_FLAGS::DEFAULT);
    // `cfg.flags` contains extra, undocumented flags like 0x8
    assert!((1..2).contains(&cfg.version)); // WSL version

    wsl.launch_interactive(ubuntu, "echo testing 123", true).unwrap();

    let stdin  = "echo testing 456\necho PATH: ${PATH}\n";
    let stdout = std::fs::File::create("target/basic.txt").unwrap();
    let stderr = (); // shorthand for Stdio::null()
    wsl.launch(ubuntu, "sh", true, stdin, stdout, stderr).unwrap().wait().unwrap();
}
assert_ne!(0, found, "Found {} ubuntu distros", found);

Structs

Configuration	The structified result of WslGetDistributionConfiguration
EnvironmentVariables	(TODO) The environment variables of WslGetDistributionConfiguration. Not yet implemented.
Error	A crate error. Convertable to std::io::Error, Box<dyn std::error::Error>
ExitStatus	(TODO) The exit status of a WSL process. Not yet implemented.
Library	A loaded wslapi.dll or api-ms-win-wsl-api-l1-1-0.dll instance
Process	A WslLaunched Process
Stdio	A WslLaunch stdin, stdout, or stderr parameter
WSL_DISTRIBUTION_FLAGS	Flags specifying WSL behavior

Type Definitions

Result

A crate Result.