Merge product/wsl/readme/6.6 into v6.6.75

* commit 'b585a63f164e826c87e21b83cf9c4e97d3cc222e': (23 commits)
  Suggest using sudo to run the script
  Fix having the wrong quote mark
  Fix sequencing
  Quote $lo_dev
  Add script
  Quote the loopback device name
  Sequence commands with `&&` where it makes sense
  Add quotes
  Add shell prompts
  Fix instructions
  Move modules_install into its own command
  Fix spacing
  Include a suggestion to build in parallel
  First draft of changes
  README.md: Include more details for modules with custom kernels
  Update build dependencies
  README.md: include building step for modifying configs
  README.md: Add dwarves to list of build dependencies
  README.md: Improve the structure of the file
  README.md: Consolidate WSL specific instructions
  ...

Author: chessturo

README-Microsoft.WSL2

@@ -0,0 +1 @@
+README.md

README.md

@@ -0,0 +1,79 @@
+# Introduction
+
+The [WSL2-Linux-Kernel][wsl2-kernel] repo contains the kernel source code and
+configuration files for the [WSL2][about-wsl2] kernel.
+
+# Reporting Bugs
+
+If you discover an issue relating to WSL or the WSL2 kernel, please report it on
+the [WSL GitHub project][wsl-issue]. It is not possible to report issues on the
+[WSL2-Linux-Kernel][wsl2-kernel] project.
+
+If you're able to determine that the bug is present in the upstream Linux
+kernel, you may want to work directly with the upstream developers. Please note
+that there are separate processes for reporting a [normal bug][normal-bug] and
+a [security bug][security-bug].
+
+# Feature Requests
+
+Is there a missing feature that you'd like to see? Please request it on the
+[WSL GitHub project][wsl-issue].
+
+If you're able and interested in contributing kernel code for your feature
+request, we encourage you to [submit the change upstream][submit-patch].
+
+# Build Instructions
+
+Instructions for building an x86_64 WSL2 kernel with an Ubuntu distribution using bash are
+as follows:
+
+1. Install the build dependencies:  
+   `$ sudo apt install build-essential flex bison dwarves libssl-dev libelf-dev cpio qemu-utils`
+
+2. Modify WSL2 kernel configs (optional):  
+   `$ make menuconfig KCONFIG_CONFIG=Microsoft/config-wsl`
+
+3. Build the kernel using the WSL2 kernel configuration and put the modules in a `modules`
+   folder under the current working directory:  
+   `$ make KCONFIG_CONFIG=Microsoft/config-wsl && make INSTALL_MOD_PATH="$PWD/modules" modules_install`
+   
+   You may wish to include `-j$(nproc)` on the first `make` command to build in parallel.
+
+Then, you can use a provided script to create a VHDX containing the modules:
+   `$ sudo ./Microsoft/scripts/gen_modules_vhdx.sh "$PWD/modules" modules.vhdx`
+
+To save space, you can now delete the compilation artifacts:
+   `$ make clean && rm -r "$PWD/modules"`
+
+If you prefer, you can also build the modules VHDX manually as follows:
+
+1. Calculate the modules size (plus 1024 bytes for slack):
+   `modules_size=$(du -s "$PWD/modules" | awk '{print $1;}'); modules_size=$((modules_size + 1024));`
+
+2. Create a blank image file for the modules:
+   `dd if=/dev/zero of="$PWD/modules.img" bs=1 count=$modules_size`
+
+3. Setup filesystem and mount img file:
+   `lo_dev=$(losetup --find --show "$PWD/modules.img") && mkfs -t ext4 "$lo_dev" && sudo mount "$lo_dev" "$PWD/modules_img"`
+
+4. Copy over the modules, unmount the img now that we're done with it:
+   `cp -r "$PWD/modules" "$PWD/modules_img" && sudo umount "$PWD/modules_img"`
+
+5. Convert the img to VHDX:
+   `qemu-img convert -O VHDX "$PWD/modules.img" "$PWD/modules.vhdx"`
+
+6. Clean up:
+   `rm modules.img # optionally $PWD/modules dir too`
+
+# Install Instructions
+
+Please see the documentation on the [.wslconfig configuration
+file][install-inst] for information on using a custom built kernel.
+
+[wsl2-kernel]:  https://github.com/microsoft/WSL2-Linux-Kernel
+[about-wsl2]:   https://docs.microsoft.com/en-us/windows/wsl/about#what-is-wsl-2
+[wsl-issue]:    https://github.com/microsoft/WSL/issues/new/choose
+[normal-bug]:   https://www.kernel.org/doc/html/latest/admin-guide/bug-hunting.html#reporting-the-bug
+[security-bug]: https://www.kernel.org/doc/html/latest/admin-guide/security-bugs.html
+[submit-patch]: https://www.kernel.org/doc/html/latest/process/submitting-patches.html
+[install-inst]: https://docs.microsoft.com/en-us/windows/wsl/wsl-config#configure-global-options-with-wslconfig