Update WSL config docs

[mezzode]

Docs needed an updated since the current version of WSL from the Fall Creators Update needs a different configuration to the beta version. See #1148.

It does feel kind of wrong having a path going inside a Windows App folder, but it works. I wonder whether WSL should add some environment variables for rootfs instead, though thats not really an issue for this repo.

[msftclas]

All CLA requirements met.

[mezzode]

Related microsoft/WSL#2578

[bobbrow]

these look like the Beta paths.

[bobbrow]

So this works for Ubuntu, but what about OpenSUSE and SLES which are also available in the Windows Store? Should we provide configs for each of them?

[bobbrow]

I suspect that Ubuntu will be the most popular choice, but we should probably talk about the other distros as well. If you don't have time to test them out yourself, can you just add a note that the paths will be different for the other distros?

[mezzode]

I already put a note about other distros on line 48.

Note that ${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/ is the path to the root of the Ubuntu filesystem. This will be different if you are using a different distro.

[icylogic]

We can generate paths for openSUSE, SUSE Linux Enterprise Server by

PS R:\> ($(get-appxpackage).PackageFamilyName | findstr /i 'SUSE Ubuntu') -replace '^', "$`{localappdata`}/Packages/"

${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc
${localappdata}/Packages/46932SUSE.openSUSELeap42.2_022rs5jcyhyac
${localappdata}/Packages/46932SUSE.SUSELinuxEnterpriseServer12SP2_022rs5jcyhyac

Even for Fedora and any other subsystems in the future. (/i for case insensitive)

I think you could put this tip in the WSL config doc.

One could translate a Linux path $WSL_PATH like /usr/include under $subsystem to a Windows path by

PS R:\> ($(get-appxpackage).PackageFamilyName | findstr /i $subsystem) -replace '^', "$`{localappdata`}/Packages/" -replace '$', "/LocalState/rootfs$WSL_PATH"

${localappdata}/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/rootfs/usr/include

$subsystem could be

• UbuntuonWindows
• openSUSELeap42
• SUSELinuxEnterpriseServer12

for now.

[bobbrow]

Thanks @icylogic. I included your Powershell command in the doc.