Skip to content

Commit

Permalink
Update mount doc (#1357)
Browse files Browse the repository at this point in the history
* Add Connect to USB doc (#1355)

* Add connect usb doc, update windows install prereq

* Add usb to toc

* Add video link

* Update WSL/connect-usb.md

Co-authored-by: Craig Loewen <crloewen@microsoft.com>

* Update WSL/connect-usb.md

Co-authored-by: Craig Loewen <crloewen@microsoft.com>

* Update WSL/connect-usb.md

Co-authored-by: Craig Loewen <crloewen@microsoft.com>

* WSL 2 requirement

* Add Windows 10 note

Co-authored-by: Craig Loewen <crloewen@microsoft.com>

* Add connect USB device link, remove from limitations

* Update prereq

* Fix Typo

Co-authored-by: Craig Loewen <crloewen@microsoft.com>
  • Loading branch information
mattwojo and craigloewen-msft authored Nov 15, 2021
1 parent 2bb5490 commit afdb001
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 5 deletions.
2 changes: 1 addition & 1 deletion WSL/connect-usb.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Setting up the USB/IP project on your Windows machine will enable common develop

## Prerequisites

- Running on either Windows 11 (Build 22000 or higher) or Windows 10 (Build ?? or higher).
- Running Windows 11 (Build 22000 or higher). *(Windows 10 support is possible, see note below).*
- Linux distribution installed and [set to WSL 2](./basic-commands.md#set-wsl-version-to-1-or-2).
- Running [Linux kernel 5.10.60.1 or higher](./kernel-release-notes.md).

Expand Down
7 changes: 3 additions & 4 deletions WSL/wsl2-mount-disk.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,7 @@
---
title: Get started mounting a Linux disk in WSL 2
description: Learn how to set up a disk mount in WSL 2 and how to access it.
keywords: wsl, windows, windowssubsystem, gnu, linux, bash, disk, ext4, filesystem, mount
ms.date: 09/27/2021
ms.date: 11/15/2021
ms.topic: article
ms.localizationpriority: medium
---
Expand All @@ -11,6 +10,8 @@ ms.localizationpriority: medium

If you want to access a Linux disk format that isn't supported by Windows, you can use WSL 2 to mount your disk and access its content. This tutorial will cover the steps to identify the disk and partition to attach to WSL2, how to mount them, and how to access them.

If you are looking for guidance on how to connect a USB device (flash drive, SD card reader, etc), see [Connect USB devices](./connect-usb.md).

> [!NOTE]
> Administrator access is required to attach a disk to WSL 2.
> The WSL 2 `mount` command does not support mounting a disk (or partitions that belong to the disk) that is currently in use. `wsl --mount` always attaches the entire disk even if only a partition is requested. You can't mount the Windows installation disk.
Expand Down Expand Up @@ -221,6 +222,4 @@ If `Diskpath` is omitted, all attached disks are unmounted and detached.

- At this time, only entire disks can be attached to WSL 2, meaning that it's not possible to attach only a partition. Concretely, this means that it's not possible to use `wsl --mount` to read a partition on the boot device, because that device can't be detached from Windows.

- USB flash drives and SD cards are not supported at this time and will fail to attach to WSL 2. USB disks are supported though.

- Only filesystems that are natively supported in the kernel can be mounted by `wsl --mount`. This means that it's not possible to use installed filesystem drivers (such as ntfs-3g for example) by calling `wsl --mount`.

0 comments on commit afdb001

Please sign in to comment.