Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Outdated Windows 10 instructions in the "Connect USB devices" How-to #1675

Closed
adamrehn opened this issue Dec 6, 2022 · 1 comment · Fixed by #1862
Closed

Outdated Windows 10 instructions in the "Connect USB devices" How-to #1675

adamrehn opened this issue Dec 6, 2022 · 1 comment · Fixed by #1862

Comments

@adamrehn
Copy link

adamrehn commented Dec 6, 2022

Documentation Issue

The Connect USB devices How-to page currently states that Windows 10 users will need to compile the WSL kernel from source in order to have access to a recent kernel version (>= 5.10.60.1) that includes USB/IP support:

Important

Windows 11 is recommended for connecting USB devices to a Linux distribution running on WSL 2. However, Windows 10 can be used to connect USB devices by building your own USBIP enabled WSL 2 kernel following the instructions in the USBIPD-WIN project repo.

This was true up until very recently, but the transition to the Windows Store version of WSL as the default under both Windows 10 and Windows 11 announced two weeks ago means that Windows 10 users now have access to up-to-date kernel versions without the need to compile from source! 🎉

In the interests of due diligence, I confirmed this by performing a manual update of WSL on a machine running Windows 10 version 22H2:

PS C:\WINDOWS\system32> wsl --update
Checking for updates...
Downloading updates...
Installing updates...
This change will take effect on the next full restart of WSL. To force a restart, please run 'wsl --shutdown'.
Kernel version: 5.10.102.1

After restarting WSL, the new kernel version is reported as expected:

$ uname -a
Linux DESKTOP-EVM723C 5.10.102.1-microsoft-standard-WSL2 #1 SMP Wed Mar 2 00:30:59 UTC 2022 x86_64 x86_64 x86_64 GNU/Linux

Link to documentation page

https://learn.microsoft.com/en-us/windows/wsl/connect-usb

Suggested Improvements

The text of the existing alert should be updated to instead direct Windows 10 users to update their WSL kernel to the latest version, with instructions for performing a manual update. A link to @craigloewen-msft's blog post The Windows Subsystem for Linux in the Microsoft Store is now generally available on Windows 10 and 11 might also be helpful, since it includes instructions for verifying that the user's version of Windows 10 has the required updates to access the Windows Store version of WSL.

@mattwojo
Copy link
Collaborator

Thanks for filing this issue @adamrehn! Super helpful. I've made the update in ee8080f

pull bot pushed a commit to demaford/WSL that referenced this issue Nov 22, 2023
mattwojo added a commit that referenced this issue Nov 28, 2023
* Resolve issues Nov 23 (#1848)

* Reorganize, reword config doc

* fix hostname command

* Clarify to resolve #1722

* Add systemd and ipv6 to comparison table

* Update prereqs for docker

* Fix based on issue 1793

* Add more context to address issue 1795

* Resolve issue 1798

* Add note about hostname flag IP differences

* Add note about terminate command

* Fix hardcoded links

* Fix links

* Editorial fixes

* Remove repeated anchor links

* Fix firewall config link

* Added wsl 2 note to import vhd flag

* Add warning about switching between architectures

* Remove issue link replace with FAQ link

* Add stacko tip re virtualbox

* Add Alma Linux to list

* Update USB support for Win10

Resolves #1675

* Add note about VM architecture for WSL 2

Resolves #1573

* Update WSL 2 explainer

* Add PS command

Resolves #1656

* Update descriptions and add link to Linux resources

* Fixes typo in set default command (#1856)

* Fix broken link to GH learning lab

* typo fix

* Fix the command parameter of configuring Hyper-V firewall (#1858)

---------

Co-authored-by: Jacob Wortmann <jacob@wortmann.dk>
Co-authored-by: Zhaoqiu Sheng <51221150+zhaoqiu-china@users.noreply.github.com>
mattwojo added a commit that referenced this issue Nov 28, 2023
* Resolve issues Nov 23 (#1848)

* Reorganize, reword config doc

* fix hostname command

* Clarify to resolve #1722

* Add systemd and ipv6 to comparison table

* Update prereqs for docker

* Fix based on issue 1793

* Add more context to address issue 1795

* Resolve issue 1798

* Add note about hostname flag IP differences

* Add note about terminate command

* Fix hardcoded links

* Fix links

* Editorial fixes

* Remove repeated anchor links

* Fix firewall config link

* Added wsl 2 note to import vhd flag

* Add warning about switching between architectures

* Remove issue link replace with FAQ link

* Add stacko tip re virtualbox

* Add Alma Linux to list

* Update USB support for Win10

Resolves #1675

* Add note about VM architecture for WSL 2

Resolves #1573

* Update WSL 2 explainer

* Add PS command

Resolves #1656

* Update descriptions and add link to Linux resources

* Fixes typo in set default command (#1856)

* Fix broken link to GH learning lab

* typo fix

* Fix the command parameter of configuring Hyper-V firewall (#1858)

---------

Co-authored-by: Jacob Wortmann <jacob@wortmann.dk>
Co-authored-by: Zhaoqiu Sheng <51221150+zhaoqiu-china@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants