microsoft
/
WSL2-Linux-Kernel
зеркало из https://github.com/microsoft/WSL2-Linux-Kernel.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
WSL2-Linux-Kernel/README.md

47 строки
2.0 KiB
Markdown
Исходник Обычный вид История

README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
# Introduction
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
The [WSL2-Linux-Kernel][wsl2-kernel] repo contains the kernel source code and
configuration files for the [WSL2][about-wsl2] kernel.
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
# Reporting Bugs
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
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.
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
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].
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
# Feature Requests
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
Is there a missing feature that you'd like to see? Please request it on the
[WSL GitHub project][wsl-issue].
README.md: Consolidate WSL specific instructions Move all of the documentation specific to the WSL kernel into README.md. The README.md file is displayed in the GitHub web interface in favor of the upstream README file. Leave a symlink from README-Microsoft.WSL2 to README.md so that anyone watching that file for changes will continue to see updates. While consolidating documentation, clean up trailing spaces and adjust the build dependency installation instructions to include the missing apt command. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-22 03:27:34 +03:00
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
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 are
as follows:
1. Install the build dependencies:
README.md: Add dwarves to list of build dependencies dwarves package provides pahole without which build fails with BTF: .tmp_vmlinux.btf: pahole (pahole) is not available Failed to generate BTF for vmlinux Try to disable CONFIG_DEBUG_INFO_BTF Link: https://github.com/microsoft/WSL2-Linux-Kernel/pull/247 Signed-off-by: Vasyl Vavrychuk <vvavrychuk@gmail.com> Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2022-01-22 12:16:55 +03:00
`$ sudo apt install build-essential flex bison dwarves libssl-dev libelf-dev`
README.md: Improve the structure of the file Break the file into more sections and make use of more of Markdown's formatting features for better readability. Signed-off-by: Tyler Hicks <tyhicks@linux.microsoft.com>
2021-07-23 22:32:12 +03:00
2. Build the kernel using the WSL2 kernel configuration:
`$ make KCONFIG_CONFIG=Microsoft/config-wsl`
# 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