Repository: microsoft/WSL Branch: master Commit: d7ff5b96315a Files: 730 Total size: 9.2 MB Directory structure: gitextract_550h3trh/ ├── .clang-format ├── .gdnsuppress ├── .github/ │ ├── CODEOWNERS │ ├── ISSUE_TEMPLATE/ │ │ ├── Bug_Report.yaml │ │ └── feature_request.md │ ├── actions/ │ │ └── triage/ │ │ └── action.yml │ ├── copilot-instructions.md │ ├── policies/ │ │ └── resourceManagement.yml │ ├── pull_request_template.md │ └── workflows/ │ ├── distributions.yml │ ├── documentation.yml │ ├── issue_edited.yml │ ├── modern-distributions.yml │ ├── new_issue.yml │ ├── new_issue_comment.yml │ └── winget.yml ├── .gitignore ├── .pipelines/ │ ├── build-stage.yml │ ├── flight-stage.yml │ ├── nuget-stage.yml │ ├── test-job.yml │ ├── test-stage.yml │ ├── wsl-build-nightly-localization.yml │ ├── wsl-build-nightly-onebranch.yml │ ├── wsl-build-notice.yml │ ├── wsl-build-pr-onebranch.yml │ ├── wsl-build-pr.yml │ └── wsl-build-release-onebranch.yml ├── CMakeLists.txt ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── DATA_AND_PRIVACY.md ├── Directory.Build.Props ├── LICENSE ├── NOTICE.txt ├── README.md ├── SECURITY.md ├── SUPPORT.md ├── UserConfig.cmake.sample ├── cgmanifest.json ├── cloudtest/ │ ├── CMakeLists.txt │ ├── TestGroup.xml.in │ └── TestMap.xml.in ├── cmake/ │ ├── FindIDL.cmake │ ├── FindLINUXBUILD.cmake │ ├── FindMC.cmake │ ├── findAppx.cmake │ ├── findNuget.cmake │ └── findVersion.cmake ├── diagnostics/ │ ├── collect-wsl-logs.ps1 │ ├── dump-init-stacks.sh │ ├── dump-init.sh │ ├── networking.sh │ └── wsl.wprp ├── distributions/ │ ├── DistributionInfo.json │ ├── requirements.txt │ ├── validate-modern.py │ └── validate.py ├── doc/ │ ├── README.md │ ├── docs/ │ │ ├── debugging.md │ │ ├── dev-loop.md │ │ ├── index.md │ │ └── technical-documentation/ │ │ ├── boot-process.md │ │ ├── drvfs.md │ │ ├── gns.md │ │ ├── index.md │ │ ├── init.md │ │ ├── interop.md │ │ ├── localhost.md │ │ ├── mini_init.md │ │ ├── plan9.md │ │ ├── relay.md │ │ ├── session-leader.md │ │ ├── systemd.md │ │ ├── wsl.exe.md │ │ ├── wslconfig.exe.md │ │ ├── wslg.exe.md │ │ ├── wslhost.exe.md │ │ ├── wslrelay.exe.md │ │ └── wslservice.exe.md │ └── mkdocs.yml ├── intune/ │ ├── WSL.admx │ └── en-US/ │ └── WSL.adml ├── localization/ │ ├── CMakeLists.txt │ └── strings/ │ ├── cs-CZ/ │ │ └── Resources.resw │ ├── da-DK/ │ │ └── Resources.resw │ ├── de-DE/ │ │ └── Resources.resw │ ├── en-GB/ │ │ └── Resources.resw │ ├── en-US/ │ │ └── Resources.resw │ ├── es-ES/ │ │ └── Resources.resw │ ├── fi-FI/ │ │ └── Resources.resw │ ├── fr-FR/ │ │ └── Resources.resw │ ├── hu-HU/ │ │ └── Resources.resw │ ├── it-IT/ │ │ └── Resources.resw │ ├── ja-JP/ │ │ └── Resources.resw │ ├── ko-KR/ │ │ └── Resources.resw │ ├── nb-NO/ │ │ └── Resources.resw │ ├── nl-NL/ │ │ └── Resources.resw │ ├── pl-PL/ │ │ └── Resources.resw │ ├── pt-BR/ │ │ └── Resources.resw │ ├── pt-PT/ │ │ └── Resources.resw │ ├── ru-RU/ │ │ └── Resources.resw │ ├── sv-SE/ │ │ └── Resources.resw │ ├── tr-TR/ │ │ └── Resources.resw │ ├── zh-CN/ │ │ └── Resources.resw │ └── zh-TW/ │ └── Resources.resw ├── msipackage/ │ ├── CMakeLists.txt │ └── package.wix.in ├── msixgluepackage/ │ ├── AppxManifest.in │ └── CMakeLists.txt ├── msixinstaller/ │ ├── AppxManifest.in │ └── CMakeLists.txt ├── nuget/ │ ├── CMakeLists.txt │ ├── Microsoft.WSL.PluginApi.nuspec.in │ └── README.WslPluginApi.MD ├── nuget.config ├── packages.config ├── src/ │ ├── linux/ │ │ ├── inc/ │ │ │ ├── lxdef.h │ │ │ ├── lxwil.h │ │ │ └── seccomp_defs.h │ │ ├── init/ │ │ │ ├── CMakeLists.txt │ │ │ ├── DnsServer.cpp │ │ │ ├── DnsServer.h │ │ │ ├── DnsTunnelingChannel.cpp │ │ │ ├── DnsTunnelingChannel.h │ │ │ ├── DnsTunnelingManager.cpp │ │ │ ├── DnsTunnelingManager.h │ │ │ ├── GnsEngine.cpp │ │ │ ├── GnsEngine.h │ │ │ ├── GnsPortTracker.cpp │ │ │ ├── GnsPortTracker.h │ │ │ ├── Localization.cpp │ │ │ ├── NetworkManager.cpp │ │ │ ├── NetworkManager.h │ │ │ ├── SecCompDispatcher.cpp │ │ │ ├── SecCompDispatcher.h │ │ │ ├── WslDistributionConfig.cpp │ │ │ ├── WslDistributionConfig.h │ │ │ ├── binfmt.cpp │ │ │ ├── binfmt.h │ │ │ ├── common.h │ │ │ ├── config.cpp │ │ │ ├── config.h │ │ │ ├── drvfs.cpp │ │ │ ├── drvfs.h │ │ │ ├── escape.cpp │ │ │ ├── escape.h │ │ │ ├── init.cpp │ │ │ ├── localhost.cpp │ │ │ ├── localhost.h │ │ │ ├── main.cpp │ │ │ ├── plan9.cpp │ │ │ ├── plan9.h │ │ │ ├── telemetry.cpp │ │ │ ├── telemetry.h │ │ │ ├── timezone.cpp │ │ │ ├── timezone.h │ │ │ ├── util.cpp │ │ │ ├── util.h │ │ │ ├── waitablevalue.h │ │ │ ├── wslinfo.cpp │ │ │ ├── wslinfo.h │ │ │ ├── wslpath.cpp │ │ │ └── wslpath.h │ │ ├── mountutil/ │ │ │ ├── CMakeLists.txt │ │ │ ├── mountflags.cpp │ │ │ ├── mountutil.c │ │ │ ├── mountutil.h │ │ │ └── mountutilcpp.h │ │ ├── netlinkutil/ │ │ │ ├── Address.cpp │ │ │ ├── CMakeLists.txt │ │ │ ├── Forwarder.h │ │ │ ├── Forwarder.hxx │ │ │ ├── Fwd.h │ │ │ ├── Interface.cpp │ │ │ ├── Interface.h │ │ │ ├── InterfaceConfiguration.h │ │ │ ├── IpNeighborManager.cpp │ │ │ ├── IpNeighborManager.h │ │ │ ├── IpRuleManager.cpp │ │ │ ├── IpRuleManager.h │ │ │ ├── Makefile.linux │ │ │ ├── Neighbor.cpp │ │ │ ├── Neighbor.h │ │ │ ├── NetLinkStrings.h │ │ │ ├── NetlinkChannel.h │ │ │ ├── NetlinkChannel.hxx │ │ │ ├── NetlinkError.cpp │ │ │ ├── NetlinkError.h │ │ │ ├── NetlinkMessage.h │ │ │ ├── NetlinkMessage.hxx │ │ │ ├── NetlinkParseException.cpp │ │ │ ├── NetlinkParseException.h │ │ │ ├── NetlinkResponse.cpp │ │ │ ├── NetlinkResponse.h │ │ │ ├── NetlinkResponse.hxx │ │ │ ├── NetlinkTransaction.cpp │ │ │ ├── NetlinkTransaction.h │ │ │ ├── NetlinkTransactionError.cpp │ │ │ ├── NetlinkTransactionError.h │ │ │ ├── Operation.h │ │ │ ├── Packet.h │ │ │ ├── Protocol.h │ │ │ ├── Route.cpp │ │ │ ├── Route.h │ │ │ ├── RoutingTable.cpp │ │ │ ├── RoutingTable.h │ │ │ ├── Rule.cpp │ │ │ ├── Rule.h │ │ │ ├── RuntimeErrorWithSourceLocation.cpp │ │ │ ├── RuntimeErrorWithSourceLocation.h │ │ │ ├── Syscall.h │ │ │ ├── Syscall.hxx │ │ │ ├── SyscallError.cpp │ │ │ ├── SyscallError.h │ │ │ ├── Utils.cpp │ │ │ ├── Utils.h │ │ │ ├── Utils.hxx │ │ │ └── address.h │ │ └── plan9/ │ │ ├── CMakeLists.txt │ │ ├── expected.h │ │ ├── p9await.h │ │ ├── p9commonutil.h │ │ ├── p9data.h │ │ ├── p9defs.h │ │ ├── p9errors.h │ │ ├── p9fid.cpp │ │ ├── p9fid.h │ │ ├── p9file.cpp │ │ ├── p9file.h │ │ ├── p9fs.cpp │ │ ├── p9fs.h │ │ ├── p9handler.cpp │ │ ├── p9handler.h │ │ ├── p9ihandler.h │ │ ├── p9io.cpp │ │ ├── p9io.h │ │ ├── p9log.h │ │ ├── p9lx.cpp │ │ ├── p9lx.h │ │ ├── p9platform.h │ │ ├── p9protohelpers.h │ │ ├── p9readdir.cpp │ │ ├── p9readdir.h │ │ ├── p9scheduler.cpp │ │ ├── p9scheduler.h │ │ ├── p9tracelogging.cpp │ │ ├── p9tracelogging.h │ │ ├── p9tracelogginghelper.h │ │ ├── p9util.cpp │ │ ├── p9util.h │ │ ├── p9xattr.cpp │ │ ├── p9xattr.h │ │ ├── precomp.h │ │ └── result_macros.h │ ├── shared/ │ │ ├── configfile/ │ │ │ ├── CMakeLists.txt │ │ │ ├── configfile.cpp │ │ │ ├── configfile.h │ │ │ ├── linux/ │ │ │ │ └── CMakeLists.txt │ │ │ └── windows/ │ │ │ └── CMakeLists.txt │ │ └── inc/ │ │ ├── CommandLine.h │ │ ├── JsonUtils.h │ │ ├── SocketChannel.h │ │ ├── conncheckshared.h │ │ ├── defs.h │ │ ├── gslhelpers.h │ │ ├── hns_schema.h │ │ ├── lxfsshares.h │ │ ├── lxinitshared.h │ │ ├── message.h │ │ ├── prettyprintshared.h │ │ ├── retryshared.h │ │ ├── socketshared.h │ │ └── stringshared.h │ └── windows/ │ ├── common/ │ │ ├── CMakeLists.txt │ │ ├── ConsoleProgressBar.cpp │ │ ├── ConsoleProgressBar.h │ │ ├── ConsoleProgressIndicator.cpp │ │ ├── ConsoleProgressIndicator.h │ │ ├── ConsoleState.cpp │ │ ├── ConsoleState.h │ │ ├── DeviceHostProxy.cpp │ │ ├── DeviceHostProxy.h │ │ ├── Distribution.cpp │ │ ├── Distribution.h │ │ ├── Dmesg.cpp │ │ ├── Dmesg.h │ │ ├── DnsResolver.cpp │ │ ├── DnsResolver.h │ │ ├── DnsTunnelingChannel.cpp │ │ ├── DnsTunnelingChannel.h │ │ ├── ExecutionContext.cpp │ │ ├── ExecutionContext.h │ │ ├── GnsChannel.cpp │ │ ├── GnsChannel.h │ │ ├── GnsPortTrackerChannel.cpp │ │ ├── GnsPortTrackerChannel.h │ │ ├── GuestDeviceManager.cpp │ │ ├── GuestDeviceManager.h │ │ ├── HandleConsoleProgressBar.cpp │ │ ├── HandleConsoleProgressBar.h │ │ ├── INetworkingEngine.h │ │ ├── Localization.cpp │ │ ├── LxssMessagePort.cpp │ │ ├── LxssMessagePort.h │ │ ├── LxssPort.h │ │ ├── LxssSecurity.cpp │ │ ├── LxssSecurity.h │ │ ├── LxssServerPort.cpp │ │ ├── LxssServerPort.h │ │ ├── NatNetworking.cpp │ │ ├── NatNetworking.h │ │ ├── Redirector.cpp │ │ ├── Redirector.h │ │ ├── RingBuffer.cpp │ │ ├── RingBuffer.h │ │ ├── Stringify.h │ │ ├── SubProcess.cpp │ │ ├── SubProcess.h │ │ ├── VirtioNetworking.cpp │ │ ├── VirtioNetworking.h │ │ ├── WslClient.cpp │ │ ├── WslClient.h │ │ ├── WslCoreConfig.cpp │ │ ├── WslCoreConfig.h │ │ ├── WslCoreFilesystem.cpp │ │ ├── WslCoreFilesystem.h │ │ ├── WslCoreFirewallSupport.cpp │ │ ├── WslCoreFirewallSupport.h │ │ ├── WslCoreHostDnsInfo.cpp │ │ ├── WslCoreHostDnsInfo.h │ │ ├── WslCoreMessageQueue.h │ │ ├── WslCoreNetworkEndpointSettings.cpp │ │ ├── WslCoreNetworkEndpointSettings.h │ │ ├── WslCoreNetworkingSupport.cpp │ │ ├── WslCoreNetworkingSupport.h │ │ ├── WslInstall.cpp │ │ ├── WslInstall.h │ │ ├── WslSecurity.cpp │ │ ├── WslSecurity.h │ │ ├── WslTelemetry.cpp │ │ ├── WslTelemetry.h │ │ ├── disk.cpp │ │ ├── disk.hpp │ │ ├── filesystem.cpp │ │ ├── filesystem.hpp │ │ ├── hcs.cpp │ │ ├── hcs.hpp │ │ ├── hcs_schema.h │ │ ├── helpers.cpp │ │ ├── helpers.hpp │ │ ├── hvsocket.cpp │ │ ├── hvsocket.hpp │ │ ├── install.cpp │ │ ├── install.h │ │ ├── interop.cpp │ │ ├── interop.hpp │ │ ├── lxssbusclient.cpp │ │ ├── lxssclient.cpp │ │ ├── notifications.cpp │ │ ├── notifications.h │ │ ├── precomp.h │ │ ├── registry.cpp │ │ ├── registry.hpp │ │ ├── relay.cpp │ │ ├── relay.hpp │ │ ├── socket.cpp │ │ ├── socket.hpp │ │ ├── string.cpp │ │ ├── string.hpp │ │ ├── svccomm.cpp │ │ ├── svccomm.hpp │ │ ├── wslutil.cpp │ │ └── wslutil.h │ ├── inc/ │ │ ├── LxssDynamicFunction.h │ │ ├── RegistryWatcher.h │ │ ├── WmiService.h │ │ ├── WmiVariant.h │ │ ├── WslCoreConfigInterface.h │ │ ├── WslPluginApi.h │ │ ├── comservicehelper.h │ │ ├── lxssbusclient.h │ │ ├── lxssclient.h │ │ ├── traceloggingconfig.h │ │ ├── wdk.h │ │ ├── wsl.h │ │ ├── wslconfig.h │ │ ├── wslhost.h │ │ ├── wslpolicies.h │ │ ├── wslrelay.h │ │ └── wslversioninfo.h │ ├── libwsl/ │ │ ├── CMakeLists.txt │ │ ├── DllMain.cpp │ │ ├── WslCoreConfigInterface.cpp │ │ └── libwsl.def │ ├── service/ │ │ ├── CMakeLists.txt │ │ ├── exe/ │ │ │ ├── BridgedNetworking.cpp │ │ │ ├── BridgedNetworking.h │ │ │ ├── CMakeLists.txt │ │ │ ├── DistributionRegistration.cpp │ │ │ ├── DistributionRegistration.h │ │ │ ├── GnsRpcServer.cpp │ │ │ ├── GnsRpcServer.h │ │ │ ├── GuestTelemetryLogger.cpp │ │ │ ├── GuestTelemetryLogger.h │ │ │ ├── IMirroredNetworkManager.h │ │ │ ├── Lifetime.cpp │ │ │ ├── Lifetime.h │ │ │ ├── LxssConsoleManager.cpp │ │ │ ├── LxssConsoleManager.h │ │ │ ├── LxssCreateProcess.cpp │ │ │ ├── LxssCreateProcess.h │ │ │ ├── LxssHttpProxy.cpp │ │ │ ├── LxssHttpProxy.h │ │ │ ├── LxssInstance.cpp │ │ │ ├── LxssInstance.h │ │ │ ├── LxssIpTables.cpp │ │ │ ├── LxssIpTables.h │ │ │ ├── LxssUserCallback.cpp │ │ │ ├── LxssUserCallback.h │ │ │ ├── LxssUserSession.cpp │ │ │ ├── LxssUserSession.h │ │ │ ├── LxssUserSessionFactory.cpp │ │ │ ├── LxssUserSessionFactory.h │ │ │ ├── MirroredNetworking.cpp │ │ │ ├── MirroredNetworking.h │ │ │ ├── PluginManager.cpp │ │ │ ├── PluginManager.h │ │ │ ├── ServiceMain.cpp │ │ │ ├── WslCoreAdviseHandler.h │ │ │ ├── WslCoreGuestNetworkService.cpp │ │ │ ├── WslCoreGuestNetworkService.h │ │ │ ├── WslCoreInstance.cpp │ │ │ ├── WslCoreInstance.h │ │ │ ├── WslCoreNetworkEndpoint.h │ │ │ ├── WslCoreTcpIpStateTracking.cpp │ │ │ ├── WslCoreTcpIpStateTracking.h │ │ │ ├── WslCoreVm.cpp │ │ │ ├── WslCoreVm.h │ │ │ ├── WslMirroredNetworking.cpp │ │ │ ├── WslMirroredNetworking.h │ │ │ ├── application.manifest │ │ │ ├── main.rc │ │ │ └── resource.h │ │ ├── inc/ │ │ │ ├── CMakeLists.txt │ │ │ ├── windowsdefs.idl │ │ │ └── wslservice.idl │ │ ├── mc/ │ │ │ ├── CMakeLists.txt │ │ │ └── wsleventschema.mc │ │ └── stub/ │ │ ├── CMakeLists.txt │ │ ├── WslServiceProxyStub.def │ │ └── WslServiceProxyStub.rc │ ├── wsl/ │ │ ├── CMakeLists.txt │ │ ├── main.cpp │ │ ├── main.rc │ │ └── resource.h │ ├── wslg/ │ │ ├── CMakeLists.txt │ │ ├── main.cpp │ │ ├── main.rc │ │ └── resource.h │ ├── wslhost/ │ │ ├── CMakeLists.txt │ │ ├── main.cpp │ │ ├── main.rc │ │ └── resource.h │ ├── wslinstall/ │ │ ├── CMakeLists.txt │ │ ├── DllMain.cpp │ │ ├── version.rc │ │ └── wslinstall.def │ ├── wslinstaller/ │ │ ├── exe/ │ │ │ ├── CMakeLists.txt │ │ │ ├── ServiceMain.cpp │ │ │ ├── WslInstaller.cpp │ │ │ ├── WslInstaller.h │ │ │ ├── WslInstallerFactory.cpp │ │ │ ├── WslInstallerFactory.h │ │ │ └── main.rc │ │ ├── inc/ │ │ │ ├── CMakeLists.txt │ │ │ └── wslinstallerservice.idl │ │ ├── stub/ │ │ │ ├── CMakeLists.txt │ │ │ ├── WslInstallerProxyStub.def │ │ │ └── WslInstallerProxyStub.rc │ │ └── wslinstaller.idl │ ├── wslrelay/ │ │ ├── CMakeLists.txt │ │ ├── localhost.cpp │ │ ├── localhost.h │ │ ├── main.cpp │ │ ├── main.rc │ │ └── resource.h │ └── wslsettings/ │ ├── Activation/ │ │ ├── ActivationHandler.cs │ │ ├── DefaultActivationHandler.cs │ │ ├── IActivationHandler.cs │ │ └── ProtocolActivationHandler.cs │ ├── App.xaml │ ├── App.xaml.cs │ ├── Behaviors/ │ │ ├── NavigationViewHeaderBehavior.cs │ │ └── NavigationViewHeaderMode.cs │ ├── CMakeLists.txt │ ├── Constants.cs │ ├── Contracts/ │ │ ├── Services/ │ │ │ ├── IActivationService.cs │ │ │ ├── INavigationService.cs │ │ │ ├── INavigationViewService.cs │ │ │ ├── IPageService.cs │ │ │ ├── IWindowService.cs │ │ │ └── IWslConfigService.cs │ │ └── ViewModels/ │ │ └── INavigationAware.cs │ ├── Controls/ │ │ ├── HyperlinkTextBlock.xaml │ │ ├── HyperlinkTextBlock.xaml.cs │ │ ├── OOBEContent.xaml │ │ └── OOBEContent.xaml.cs │ ├── Converters/ │ │ ├── BooleanToVisibilityConverter.cs │ │ ├── MegabyteNumberConverter.cs │ │ ├── MegabyteStringConverter.cs │ │ └── MillisecondsStringConverter.cs │ ├── Helpers/ │ │ ├── FrameExtensions.cs │ │ ├── NavigationHelper.cs │ │ ├── ResourceExtensions.cs │ │ ├── RuntimeHelper.cs │ │ └── TitleBarHelper.cs │ ├── LibWsl.cs │ ├── Services/ │ │ ├── ActivationService.cs │ │ ├── NavigationService.cs │ │ ├── NavigationViewService.cs │ │ ├── PageService.cs │ │ ├── WindowService.cs │ │ └── WslConfigService.cs │ ├── Styles/ │ │ ├── Button.xaml │ │ ├── CommonStyles.xaml │ │ ├── FontSizes.xaml │ │ └── Thickness.xaml │ ├── Usings.cs │ ├── ViewModels/ │ │ ├── OOBE/ │ │ │ ├── DistroManagementViewModel.cs │ │ │ ├── DockerDesktopIntegrationViewModel.cs │ │ │ ├── GPUAccelerationViewModel.cs │ │ │ ├── GUIAppsViewModel.cs │ │ │ ├── GeneralViewModel.cs │ │ │ ├── NetworkingIntegrationViewModel.cs │ │ │ ├── VSCodeIntegrationViewModel.cs │ │ │ ├── VSIntegrationViewModel.cs │ │ │ ├── WelcomeToUbuntuViewModel.cs │ │ │ └── WorkingAcrossFileSystemsViewModel.cs │ │ ├── Settings/ │ │ │ ├── AboutViewModel.cs │ │ │ ├── DeveloperViewModel.cs │ │ │ ├── FileSystemViewModel.cs │ │ │ ├── MemAndProcViewModel.cs │ │ │ ├── NetworkingViewModel.cs │ │ │ ├── OptionalFeaturesViewModel.cs │ │ │ └── WslConfigSettingViewModel.cs │ │ └── ShellViewModel.cs │ ├── Views/ │ │ ├── OOBE/ │ │ │ ├── DistroManagementPage.xaml │ │ │ ├── DistroManagementPage.xaml.cs │ │ │ ├── DockerDesktopIntegrationPage.xaml │ │ │ ├── DockerDesktopIntegrationPage.xaml.cs │ │ │ ├── GPUAccelerationPage.xaml │ │ │ ├── GPUAccelerationPage.xaml.cs │ │ │ ├── GUIAppsPage.xaml │ │ │ ├── GUIAppsPage.xaml.cs │ │ │ ├── GeneralPage.xaml │ │ │ ├── GeneralPage.xaml.cs │ │ │ ├── NetworkingIntegrationPage.xaml │ │ │ ├── NetworkingIntegrationPage.xaml.cs │ │ │ ├── ShellPage.xaml │ │ │ ├── ShellPage.xaml.cs │ │ │ ├── VSCodeIntegrationPage.xaml │ │ │ ├── VSCodeIntegrationPage.xaml.cs │ │ │ ├── VSIntegrationPage.xaml │ │ │ ├── VSIntegrationPage.xaml.cs │ │ │ ├── WorkingAcrossFileSystemsPage.xaml │ │ │ └── WorkingAcrossFileSystemsPage.xaml.cs │ │ └── Settings/ │ │ ├── AboutPage.xaml │ │ ├── AboutPage.xaml.cs │ │ ├── DeveloperPage.xaml │ │ ├── DeveloperPage.xaml.cs │ │ ├── FileSystemPage.xaml │ │ ├── FileSystemPage.xaml.cs │ │ ├── MemAndProcPage.xaml │ │ ├── MemAndProcPage.xaml.cs │ │ ├── NetworkingPage.xaml │ │ ├── NetworkingPage.xaml.cs │ │ ├── OptionalFeaturesPage.xaml │ │ ├── OptionalFeaturesPage.xaml.cs │ │ ├── ShellPage.xaml │ │ └── ShellPage.xaml.cs │ ├── Windows/ │ │ ├── MainWindow.xaml │ │ ├── MainWindow.xaml.cs │ │ ├── OOBEWindow.xaml │ │ └── OOBEWindow.xaml.cs │ ├── app.manifest │ ├── directory.build.targets.in │ └── properties/ │ └── AssemblyInfo.cs.in ├── storebroker/ │ ├── PDPs/ │ │ ├── cs-CZ/ │ │ │ └── PDP.xml │ │ ├── da-DK/ │ │ │ └── PDP.xml │ │ ├── de-DE/ │ │ │ └── PDP.xml │ │ ├── en-GB/ │ │ │ └── PDP.xml │ │ ├── en-us/ │ │ │ └── PDP.xml │ │ ├── es-ES/ │ │ │ └── PDP.xml │ │ ├── fi-FI/ │ │ │ └── PDP.xml │ │ ├── fr-FR/ │ │ │ └── PDP.xml │ │ ├── hu-HU/ │ │ │ └── PDP.xml │ │ ├── it-IT/ │ │ │ └── PDP.xml │ │ ├── ja-JP/ │ │ │ └── PDP.xml │ │ ├── ko-KR/ │ │ │ └── PDP.xml │ │ ├── nb-NO/ │ │ │ └── PDP.xml │ │ ├── nl-NL/ │ │ │ └── PDP.xml │ │ ├── pl-PL/ │ │ │ └── PDP.xml │ │ ├── pt-BR/ │ │ │ └── PDP.xml │ │ ├── pt-PT/ │ │ │ └── PDP.xml │ │ ├── qps-ploc/ │ │ │ └── PDP.xml │ │ ├── qps-ploca/ │ │ │ └── PDP.xml │ │ ├── qps-plocm/ │ │ │ └── PDP.xml │ │ ├── ru-RU/ │ │ │ └── PDP.xml │ │ ├── sv-SE/ │ │ │ └── PDP.xml │ │ ├── tr-TR/ │ │ │ └── PDP.xml │ │ ├── zh-CN/ │ │ │ └── PDP.xml │ │ └── zh-TW/ │ │ └── PDP.xml │ └── sbconfig.json ├── test/ │ ├── README.md │ ├── linux/ │ │ └── unit_tests/ │ │ ├── Makefile │ │ ├── auxv.c │ │ ├── binfmt.c │ │ ├── brk.c │ │ ├── build_tests.sh │ │ ├── cgroup.c │ │ ├── common.c │ │ ├── common.h │ │ ├── dev_pt.c │ │ ├── dev_pt_2.c │ │ ├── dev_pt_common.c │ │ ├── dev_pt_common.h │ │ ├── drvfs.c │ │ ├── dup.c │ │ ├── epoll.c │ │ ├── eventfd.c │ │ ├── execve.c │ │ ├── flock.c │ │ ├── fork.c │ │ ├── fscommon.c │ │ ├── fstab.c │ │ ├── get_set_id.c │ │ ├── getaddrinfo.c │ │ ├── gettime.c │ │ ├── inotify.c │ │ ├── interop.c │ │ ├── ioprio.c │ │ ├── keymgmt.c │ │ ├── lxtcommon.h │ │ ├── lxtevent.c │ │ ├── lxtevent.h │ │ ├── lxtfs.c │ │ ├── lxtfs.h │ │ ├── lxtlog.c │ │ ├── lxtlog.h │ │ ├── lxtmount.c │ │ ├── lxtmount.h │ │ ├── lxtutil.c │ │ ├── lxtutil.h │ │ ├── madvise.c │ │ ├── mprotect.c │ │ ├── mremap.c │ │ ├── namespace.c │ │ ├── netlink.c │ │ ├── overlayfs.c │ │ ├── pipe.c │ │ ├── poll.c │ │ ├── random.c │ │ ├── resourcelimits.c │ │ ├── sched.c │ │ ├── select.c │ │ ├── sem.c │ │ ├── shm.c │ │ ├── socket.c │ │ ├── socket_nonblock.c │ │ ├── splice.c │ │ ├── sysfs.c │ │ ├── sysinfo.c │ │ ├── timer.c │ │ ├── timerfd.c │ │ ├── tty.c │ │ ├── ttys.c │ │ ├── unittests.c │ │ ├── unittests.h │ │ ├── user.c │ │ ├── utimensat.c │ │ ├── vfsaccess.c │ │ ├── vnet.c │ │ ├── waitpid.c │ │ ├── wslpath.c │ │ └── xattr.c │ └── windows/ │ ├── CMakeLists.txt │ ├── Common.cpp │ ├── Common.h │ ├── DrvFsTests.cpp │ ├── InstallerTests.cpp │ ├── MountTests.cpp │ ├── NetworkTests.cpp │ ├── Plan9Tests.cpp │ ├── PluginTests.cpp │ ├── PluginTests.h │ ├── PolicyTests.cpp │ ├── SimpleTests.cpp │ ├── UnitTests.cpp │ ├── lxsstest.h │ └── testplugin/ │ ├── CMakeLists.txt │ └── Plugin.cpp ├── tools/ │ ├── FormatSource.ps1.in │ ├── SetupClangFormat.bat │ ├── build-bundle.bat │ ├── create-dev-cert.ps1 │ ├── create-initrd.ps1 │ ├── deploy/ │ │ ├── deploy-to-host.ps1 │ │ └── deploy-to-vm.ps1 │ ├── devops/ │ │ ├── create-change.py │ │ ├── create-release.py │ │ ├── find-release.py │ │ ├── requirements.txt │ │ ├── validate-copyright-headers.py │ │ ├── validate-localization.py │ │ └── version_functions.ps1 │ ├── generateLocalizationHeader.ps1 │ ├── hooks/ │ │ └── pre-commit │ └── test/ │ ├── CloudTest-Setup.bat │ ├── build-test-distro.ps1 │ ├── copy_and_build_tests.ps1 │ ├── copy_tests.ps1 │ ├── gh-release-server.py │ ├── run-tests.ps1 │ ├── setup-vm-for-tests.ps1 │ ├── test-setup.ps1 │ └── test.bat.in └── triage/ ├── config.yml ├── install-latest-wsl.ps1 └── no-filter.wpaProfile ================================================ FILE CONTENTS ================================================ ================================================ FILE: .clang-format ================================================ --- # this file work is a derivative of onecoreuap/net/.clang-format # https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md # Language: Cpp # BasedOnStyle: LLVM AccessModifierOffset: -4 AlignAfterOpenBracket: AlwaysBreak AlignConsecutiveAssignments: false AlignEscapedNewlines: DontAlign AlignOperands: true AlignTrailingComments: true AllowAllParametersOfDeclarationOnNextLine: true AllowShortBlocksOnASingleLine: false AllowShortCaseLabelsOnASingleLine: false AllowShortFunctionsOnASingleLine: None AllowShortIfStatementsOnASingleLine: false AllowShortLoopsOnASingleLine: false AlwaysBreakAfterDefinitionReturnType: None AlwaysBreakAfterReturnType: None AlwaysBreakBeforeMultilineStrings: true AlwaysBreakTemplateDeclarations: true BinPackArguments: false BinPackParameters: false BreakBeforeBinaryOperators: None BreakBeforeBraces: Custom BraceWrapping: AfterCaseLabel: true AfterClass: true AfterControlStatement: true AfterEnum: true AfterFunction: true AfterNamespace: false AfterStruct: true AfterUnion: true AfterExternBlock: false BeforeCatch: true BeforeElse: true SplitEmptyFunction: true SplitEmptyRecord: true SplitEmptyNamespace: true BreakBeforeTernaryOperators: true BreakConstructorInitializers: AfterColon ColumnLimit: 130 CommentPragmas: '^ IWYU pragma:' CompactNamespaces: true ConstructorInitializerAllOnOneLineOrOnePerLine: true ConstructorInitializerIndentWidth: 4 ContinuationIndentWidth: 4 Cpp11BracedListStyle: true DerivePointerAlignment: false DisableFormat: false ExperimentalAutoDetectBinPacking: false FixNamespaceComments: true ForEachMacros: [ foreach, Q_FOREACH, BOOST_FOREACH ] IncludeBlocks: Regroup IncludeCategories: - Regex: '^"(stdafx.h|pch.h|precomp.h)"$' Priority: -1 IndentCaseLabels: false InsertBraces: true IndentWidth: 4 IndentWrappedFunctionNames: false KeepEmptyLinesAtTheStartOfBlocks: true MacroBlockBegin: '^BEGIN_COM_MAP$|^BEGIN_CONNECTION_POINT_MAP$|^BEGIN_HELPER_NODEMAP$|^BEGIN_MODULE$|^BEGIN_MSG_MAP$|^BEGIN_OBJECT_MAP$|^BEGIN_TEST_CLASS$|^BEGIN_TEST_METHOD$|^BEGIN_TEST_METHOD_PROPERTIES$' MacroBlockEnd: '^END_COM_MAP$|^END_CONNECTION_POINT_MAP$|^END_HELPER_NODEMAP$|^END_MODULE$|^END_MSG_MAP$|^END_OBJECT_MAP$|^END_TEST_CLASS$|^END_TEST_METHOD$|^END_TEST_METHOD_PROPERTIES$' MaxEmptyLinesToKeep: 1 NamespaceIndentation: Inner ObjCBlockIndentWidth: 2 ObjCSpaceAfterProperty: false ObjCSpaceBeforeProtocolList: true PenaltyBreakBeforeFirstCallParameter: 19 PenaltyBreakComment: 300 PenaltyBreakFirstLessLess: 120 PenaltyBreakString: 1000 PenaltyExcessCharacter: 1 PenaltyReturnTypeOnItsOwnLine: 1000 PointerAlignment: Left SortIncludes: false SpaceAfterCStyleCast: false SpaceBeforeAssignmentOperators: true SpaceBeforeParens: ControlStatements SpaceInEmptyParentheses: false SpacesBeforeTrailingComments: 1 SpacesInAngles: false SpacesInContainerLiterals: true SpacesInCStyleCastParentheses: false SpacesInParentheses: false SpacesInSquareBrackets: false Standard: Cpp11 StatementMacros: [ _Acquires_exclusive_lock_, _Acquires_lock_, _Acquires_nonreentrant_lock_, _Acquires_shared_lock_, _Analysis_assume_smart_lock_acquired_, _Analysis_assume_smart_lock_released_, _Create_lock_level_, _Detaches_lock_, _Function_class_, _Global_cancel_spin_lock_, _Global_critical_region_, _Global_interlock_, _Global_priority_region_, _Has_lock_kind_, _Has_lock_level_, _IRQL_always_function_max_, _IRQL_always_function_min_, _IRQL_raises_, _IRQL_requires_, _IRQL_requires_max_, _IRQL_requires_min_, _IRQL_requires_same_, _IRQL_restores_, _IRQL_restores_global_, _IRQL_saves_, _IRQL_saves_global_, _Lock_level_order_, _Moves_lock_, _Must_inspect_result_, _No_competing_thread_, _Post_same_lock_, _Post_writable_byte_size_, _Pre_satisfies_, _Releases_exclusive_lock_, _Releases_lock_, _Releases_nonreentrant_lock_, _Releases_shared_lock_, _Replaces_lock_, _Requires_exclusive_lock_held_, _Requires_lock_held_, _Requires_lock_not_held_, _Requires_no_locks_held_, _Requires_shared_lock_held_, _Ret_maybenull_, _Ret_range_, _Success_, _Swaps_locks_, _Use_decl_annotations_, _When_, RpcEndExcept, ] TabWidth: 4 TypenameMacros: [ IFACEMETHOD, STDMETHOD, ] UseTab: Never ... ================================================ FILE: .gdnsuppress ================================================ { "hydrated": false, "properties": { "helpUri": "https://eng.ms/docs/microsoft-security/security/azure-security/cloudai-security-fundamentals-engineering/security-integration/guardian-wiki/microsoft-guardian/general/suppressions" }, "version": "1.0.0", "suppressionSets": { "default": { "name": "default", "createdDate": "2025-04-30 22:17:21Z", "lastUpdatedDate": "2025-04-30 22:17:21Z" } }, "results": { "3d7d59d41a06e01093616033ddd4ecec1e8dcb65363768638eea6acb6d012b4e": { "signature": "3d7d59d41a06e01093616033ddd4ecec1e8dcb65363768638eea6acb6d012b4e", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "aa145b1818ed203013a6267ca382110ec5ea9c1bf50a812964d4c7b5671224ec": { "signature": "aa145b1818ed203013a6267ca382110ec5ea9c1bf50a812964d4c7b5671224ec", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "c5f15f6ef4ac3f1e82c31ae0f651ab0f1c8448e34824bf231dd2104cef70d9e5": { "signature": "c5f15f6ef4ac3f1e82c31ae0f651ab0f1c8448e34824bf231dd2104cef70d9e5", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "e8eb99fd7876f9c79c0ff194de9e21cc77d63573a9b73ba1666778a247dcebff": { "signature": "e8eb99fd7876f9c79c0ff194de9e21cc77d63573a9b73ba1666778a247dcebff", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "43df748a685bc9feca8cf04c518f57a82012d61665dca65d8a1fb652a55d9391": { "signature": "43df748a685bc9feca8cf04c518f57a82012d61665dca65d8a1fb652a55d9391", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "fc58019c679cf3c469af5161b1f237f7552ee81c3d3ae29aff2d18fcceafe3e7": { "signature": "fc58019c679cf3c469af5161b1f237f7552ee81c3d3ae29aff2d18fcceafe3e7", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "bedcd464fd4426dbd786cb09b7407100aa548dfff85d3c89e7fd79c8c2623391": { "signature": "bedcd464fd4426dbd786cb09b7407100aa548dfff85d3c89e7fd79c8c2623391", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "06d5d116da395c14acda7a67c6530e675cc6d59593a94f37fbc2b91ce05380ca": { "signature": "06d5d116da395c14acda7a67c6530e675cc6d59593a94f37fbc2b91ce05380ca", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "a93af66a96249e7041eee45e325c2548da917d4c6984e7cf67fa0c052a01a980": { "signature": "a93af66a96249e7041eee45e325c2548da917d4c6984e7cf67fa0c052a01a980", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "2950fa4920cef845442e43dccfbdd49ca5935a1f0aa115c3b25bf5397d39bac7": { "signature": "2950fa4920cef845442e43dccfbdd49ca5935a1f0aa115c3b25bf5397d39bac7", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "d747605a4cb9b5cbe7715f638b3909572302db204327120c50f712064c405380": { "signature": "d747605a4cb9b5cbe7715f638b3909572302db204327120c50f712064c405380", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "be9c9eacd39f7740ac8794956f9133718e7bac4556a7a29ebdbcae5a1c762faf": { "signature": "be9c9eacd39f7740ac8794956f9133718e7bac4556a7a29ebdbcae5a1c762faf", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "1af653b6acce89da21e37933f80d0686bf8a01aab386620533b42e06b55a3f26": { "signature": "1af653b6acce89da21e37933f80d0686bf8a01aab386620533b42e06b55a3f26", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "5ba96332382fbe9cfb5c6baf51b5bd6e2644f1aa86c3fad66562dd648458f431": { "signature": "5ba96332382fbe9cfb5c6baf51b5bd6e2644f1aa86c3fad66562dd648458f431", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "29432097a113f870ee7f86e585601fa1a6013f50b65893a359391ef47f996c73": { "signature": "29432097a113f870ee7f86e585601fa1a6013f50b65893a359391ef47f996c73", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "352c2da0bfcde6f9f60c43359e7263b07247d26bff0343a369c8e3667c37fbe1": { "signature": "352c2da0bfcde6f9f60c43359e7263b07247d26bff0343a369c8e3667c37fbe1", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "64bf4920e1b5b21e7312594ca9d95e3b48ac05a9cef507b21d91ba588a0ab08e": { "signature": "64bf4920e1b5b21e7312594ca9d95e3b48ac05a9cef507b21d91ba588a0ab08e", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "720d1478e66c5f46670729c232d5afb787cdcc007f53e67d31edd4457e60967c": { "signature": "720d1478e66c5f46670729c232d5afb787cdcc007f53e67d31edd4457e60967c", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "cf0a86680efb56a7eb351df85c51c6ad2e1ae64f108b8729ab7a9dd148d8312b": { "signature": "cf0a86680efb56a7eb351df85c51c6ad2e1ae64f108b8729ab7a9dd148d8312b", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "3cedf840f8bdf45d29de68eedf06e3548fbdf86ebe3929c38b1be7babd790142": { "signature": "3cedf840f8bdf45d29de68eedf06e3548fbdf86ebe3929c38b1be7babd790142", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "2e746764a2b4ee4971e2afded4c2dd99c5bf7647a5c8d9ae027d901caf7c5982": { "signature": "2e746764a2b4ee4971e2afded4c2dd99c5bf7647a5c8d9ae027d901caf7c5982", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "04e31f322d76e5b2d92d36987ae5453b9d7b4eb1aba2e59f9956e088756eb3d3": { "signature": "04e31f322d76e5b2d92d36987ae5453b9d7b4eb1aba2e59f9956e088756eb3d3", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "df6145ffc4e1301e28b405ec934470ab2346ac60ef1b5a806a470f6a86907141": { "signature": "df6145ffc4e1301e28b405ec934470ab2346ac60ef1b5a806a470f6a86907141", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "53daee355a750916f6516911381cd31bfbb8de644cb0158a7bfb6456ffab163c": { "signature": "53daee355a750916f6516911381cd31bfbb8de644cb0158a7bfb6456ffab163c", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "cf5679eb50b6062e91bab7a9a53aa2c356a41289192081f733e42c6def3abc96": { "signature": "cf5679eb50b6062e91bab7a9a53aa2c356a41289192081f733e42c6def3abc96", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "9dac4ccae735c85dd3974f876f336accefa2f90f3cea74801bf4b148926bd132": { "signature": "9dac4ccae735c85dd3974f876f336accefa2f90f3cea74801bf4b148926bd132", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "d05aa96a810d8140a0c2269e8d5e64b8b6db02652da6842547e1e1c4139096b5": { "signature": "d05aa96a810d8140a0c2269e8d5e64b8b6db02652da6842547e1e1c4139096b5", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "cd0ad7bf2ffe4b3d068dc6c9731aa1d8f001250f30ebd3667a8982f03e72c879": { "signature": "cd0ad7bf2ffe4b3d068dc6c9731aa1d8f001250f30ebd3667a8982f03e72c879", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "8415dbbf5b26dadc3e7d7f09b496a7f53452c60b67019bbb92c48dd1cd0f703a": { "signature": "8415dbbf5b26dadc3e7d7f09b496a7f53452c60b67019bbb92c48dd1cd0f703a", "alternativeSignatures": [ "88c2fa648d6200a3832a1a4b6d568c43a9dd89e05e4032c4286450c4d3a9171d" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "20edc36496c8274a97fe9179b56fcc1b5aab4b7e0d6769c23e14181844f64f35": { "signature": "20edc36496c8274a97fe9179b56fcc1b5aab4b7e0d6769c23e14181844f64f35", "alternativeSignatures": [ "14b018ac237bbbfe6304e73f454e190a2c60d335f249db0a9af6500eeae4808f" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" }, "2652e38833372ca84eeebf1e9cd6145d4556e3851f7e698f95b5f01574cef372": { "signature": "2652e38833372ca84eeebf1e9cd6145d4556e3851f7e698f95b5f01574cef372", "alternativeSignatures": [ "d705445d04087b944ab3e7777bce5c61a4efc64fc7be2953cf7ed8573321a87b" ], "memberOf": [ "default" ], "createdDate": "2025-04-30 22:17:21Z" } } } ================================================ FILE: .github/CODEOWNERS ================================================ # File containing policy for file ownership # Reviewers for all files in the repository * @microsoft/wsl-maintainers ================================================ FILE: .github/ISSUE_TEMPLATE/Bug_Report.yaml ================================================ --- name: "WSL - Bug Report" description: Report a bug on Windows Subsystem for Linux body: - type: markdown attributes: value: | Please [search for existing issues](https://github.com/microsoft/WSL/issues) before creating a new one. If you'd like to create a new bug report, please [read the guidance here](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md) before getting started. This will save you time. - type: input attributes: label: Windows Version description: | Please run `cmd.exe /c ver` to get the build of Windows you are on. placeholder: "Microsoft Windows [Version 10.0.19042.867]" validations: required: true - type: input attributes: label: WSL Version description: | If you are running Windows Subsystem for Linux from the Microsoft Store, please run `wsl.exe --version`. Else `0.0.0.0` placeholder: "0.0.0.0" validations: required: true - type: checkboxes attributes: label: Are you using WSL 1 or WSL 2? description: | Tell us whether the issue is on WSL 2 and/or WSL 1. You can tell by running `wsl -l -v`. options: - label: "WSL 2" - label: "WSL 1" - type: input attributes: label: Kernel Version description: | Please tell us what version of the Linux kernel you are using, or if you are using a custom kernel. You can run `wsl.exe --status` if that command is available to you, or by running `cat /proc/version` in your distro. placeholder: "5.4.72" validations: required: false - type: input attributes: label: Distro Version description: | Please tell us what distro you are using (if applicable). You can get additional information about the version where possible, e.g. on Debian / Ubuntu, run `lsb_release -r` placeholder: "Ubuntu 16.04" validations: required: false - type: textarea attributes: label: Other Software description: If you're reporting a bug involving WSL's interaction with other applications, please tell us. What applications? What versions? placeholder: | Docker Desktop (Windows), version 3.2.2 traceroute, Version: 1:2.0.21-1 Visual Studio Code 1.54.3 with Remote-WSL Extension 0.54.6 MyCustomApplication validations: required: false - type: textarea attributes: label: Repro Steps description: Please list out the steps to reproduce your bug. placeholder: Your steps go here. Include relevant environmental variables or any other configuration. validations: required: true - type: textarea attributes: label: Expected Behavior description: What were you expecting to see? Include any relevant examples or documentation links. placeholder: If you want to include screenshots, paste them into the text area or follow up with a separate comment. validations: required: true - type: textarea attributes: label: Actual Behavior description: What happened instead? placeholder: Include the terminal output, straces of the failing command, etc. as necessary. validations: required: true - type: textarea attributes: label: Diagnostic Logs description: | Please provide additional diagnostics if needed. See the [guidance](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md) for info on how to gather Feedback Hub logs, networking logs, and more. placeholder: Your links to logs or other information go here. validations: required: false ================================================ FILE: .github/ISSUE_TEMPLATE/feature_request.md ================================================ --- name: Feature request / Contribution idea about: Suggest a feature or improvement for the Windows Subsystem for Linux title: '' labels: 'feature' assignees: '' --- **Is your feature request related to a problem? Please describe.** A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] **Describe the solution you'd like** A clear and concise description of what you want to happen. **Describe alternatives you've considered** A clear and concise description of any alternative solutions or features you've considered. **Additional context** Add any other context or screenshots about the feature request here. ================================================ FILE: .github/actions/triage/action.yml ================================================ name: Run automated triage inputs: issue: required: false type: string comment: required: false type: string token: required: false type: string previous_body: required: false type: string runs: using: "composite" steps: - name: 'Run WTI' shell: pwsh env: previous_body: "${{ inputs.previous_body }}" run: | $ErrorActionPreference = [System.Management.Automation.ActionPreference]::Stop $maybe_comment = @() if (![string]::IsNullOrEmpty("${{ inputs.comment }}")) { $maybe_comment = @("--comment", "${{ inputs.comment }}") } $maybe_previous_body = @() if (![string]::IsNullOrEmpty("$env:previous_body")) { $env:previous_body | Out-File -Encoding utf8 "triage\previous_body.txt" $maybe_previous_body = @("--previous-issue-body", "previous_body.txt") } curl.exe -L https://github.com/OneBlue/wti/releases/download/v0.1.12/wti.exe -o triage/wti.exe cd triage && .\wti.exe --issue ${{ inputs.issue }} --config config.yml --github-token "${{ inputs.token }}" --ignore-tags @maybe_comment @maybe_previous_body ================================================ FILE: .github/copilot-instructions.md ================================================ # Windows Subsystem for Linux (WSL) **ALWAYS reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.** WSL is the Windows Subsystem for Linux - a compatibility layer for running Linux binary executables natively on Windows. This repository contains the core Windows components that enable WSL functionality. ## Working Effectively ### Critical Platform Requirements - **Full builds ONLY work on Windows** with Visual Studio and Windows SDK 26100 - **DO NOT attempt to build the main WSL components on Linux** - they require Windows-specific APIs, MSBuild, and Visual Studio toolchain - Many validation and development tasks CAN be performed on Linux (documentation, formatting, Python validation scripts) ### Windows Build Requirements (Required for Full Development) - CMake >= 3.25 (`winget install Kitware.CMake`) - Visual Studio with these components: - Windows SDK 26100 - MSBuild - Universal Windows platform support for v143 build tools (X64 and ARM64) - MSVC v143 - VS 2022 C++ ARM64 build tools (Latest + Spectre) (X64 and ARM64) - C++ core features - C++ ATL for latest v143 tools (X64 and ARM64) - C++ Clang compiler for Windows - .NET desktop development - .NET WinUI app development tools - Enable Developer Mode in Windows Settings OR run with Administrator privileges (required for symbolic link support) ### Building WSL (Windows Only) 1. Clone the repository 2. Generate Visual Studio solution: `cmake .` 3. Build: `cmake --build . -- -m` OR open `wsl.sln` in Visual Studio 4. **NEVER CANCEL: Build takes 20-45 minutes on typical hardware. Set timeout to 60+ minutes.** Build parameters: - `cmake . -A arm64` - Build for ARM64 - `cmake . -DCMAKE_BUILD_TYPE=Release` - Release build - `cmake . -DBUILD_BUNDLE=TRUE` - Build bundle msix package (requires ARM64 built first) ### Deploying WSL (Windows Only) - Install MSI: `bin\\\wsl.msi` - OR use script: `powershell tools\deploy\deploy-to-host.ps1` - For Hyper-V VM: `powershell tools\deploy\deploy-to-vm.ps1 -VmName -Username -Password ` ## Cross-Platform Development Tasks ### Documentation (Works on Linux/Windows) - Install tools: `pip install mkdocs-mermaid2-plugin mkdocs --break-system-packages` - Build docs: `mkdocs build -f doc/mkdocs.yml` - **Build time: ~0.5 seconds. Set timeout to 5+ minutes for safety.** - Output location: `doc/site/` - **Note**: May show warnings about mermaid CDN access on restricted networks ### Code Formatting and Validation (Works on Linux/Windows) - Format check: `clang-format --dry-run --style=file ` - Apply formatting: `clang-format -i --style=file ` - Format all source: `powershell formatsource.ps1` (available at repo root after running `cmake .`) - Validate copyright headers: `python3 tools/devops/validate-copyright-headers.py` - **Note**: Will report missing headers in generated/dependency files (_deps/), which is expected - Validate localization: `python3 tools/devops/validate-localization.py` - **Note**: Only works after Windows build (requires localization/strings/en-us/Resources.resw) ### Distribution Validation (Limited on Linux) - Validate distribution info: `python3 distributions/validate.py distributions/DistributionInfo.json` - **Note**: May fail on Linux due to network restrictions accessing distribution URLs ## Testing ### Unit Tests (Windows Only - TAEF Framework) **CRITICAL: ALWAYS build the ENTIRE project before running tests:** ```powershell # Build everything first - this is required! cmake --build . -- -m # Then run tests bin\\\test.bat ``` **Why full build is required:** - Tests depend on multiple components (libwsl.dll, wsltests.dll, wslservice.exe, etc.) - Partial builds (e.g., only `configfile` or `wsltests`) will cause test failures - Changed components must be built together to ensure compatibility - **DO NOT skip the full build step even if only one file changed** Test execution: - Run all tests: `bin\\\test.bat` - **NEVER CANCEL: Full test suite takes 30-60 minutes. Set timeout to 90+ minutes.** - Run subset: `bin\\\test.bat /name:*UnitTest*` - Run specific test: `bin\\\test.bat /name:::` - WSL1 tests: Add `-Version 1` flag - Fast mode (after first run): Add `-f` flag (requires `wsl --set-default test_distro`) - **Requires Administrator privileges** - test.bat will fail without admin rights Test debugging: - Wait for debugger: `/waitfordebugger` - Break on failure: `/breakonfailure` - Run in-process: `/inproc` ### Linux Unit Tests (Linux Only) - Location: `test/linux/unit_tests/` - Build script: `test/linux/unit_tests/build_tests.sh` - **Note**: Requires specific Linux build environment setup not covered in main build process ## Validation Scenarios ### Always Test These After Changes: 1. **Documentation Build**: Run `mkdocs build -f doc/mkdocs.yml` and verify no errors 2. **Code Formatting**: Run `clang-format --dry-run --style=file` on changed files 3. **Windows Build** (if on Windows): Full cmake build cycle 4. **Distribution Validation**: Run Python validation scripts on any distribution changes ### Manual Validation Requirements - **Windows builds**: Install MSI and test basic WSL functionality (`wsl --version`, `wsl -l`) - **Documentation changes**: Review generated HTML in `doc/site/` - **Distribution changes**: Test with actual WSL distribution installation ## Repository Navigation ### Key Directories - `src/windows/` - Main Windows WSL service components - `src/linux/` - Linux-side WSL components - `src/shared/` - Shared code between Windows and Linux - `test/windows/` - Windows-based tests (TAEF framework) - `test/linux/unit_tests/` - Linux unit test suite - `doc/` - Documentation source (MkDocs) - `tools/` - Build and deployment scripts - `distributions/` - Distribution validation and metadata ### Key Files - `CMakeLists.txt` - Main build configuration - `doc/docs/dev-loop.md` - Developer build instructions - `test/README.md` - Testing framework documentation - `CONTRIBUTING.md` - Contribution guidelines - `.clang-format` - Code formatting rules - `UserConfig.cmake.sample` - Optional build customizations ### Frequently Used Commands (Platform-Specific) #### Windows Development: ```bash # Initial setup cmake . cmake --build . -- -m # 20-45 minutes, NEVER CANCEL # Deploy and test powershell tools\deploy\deploy-to-host.ps1 wsl --version # Run tests bin\x64\debug\test.bat # 30-60 minutes, NEVER CANCEL ``` #### Cross-Platform Validation: ```bash # Documentation (0.5 seconds) mkdocs build -f doc/mkdocs.yml # Code formatting find src -name "*.cpp" -o -name "*.h" | xargs clang-format --dry-run --style=file # Copyright header validation (reports expected issues in _deps/) python3 tools/devops/validate-copyright-headers.py # Distribution validation (may fail on networks without external access) python3 distributions/validate.py distributions/DistributionInfo.json ``` ## Debugging and Logging ### ETL Tracing (Windows Only) ```powershell # Collect traces wpr -start diagnostics\wsl.wprp -filemode # [reproduce issue] wpr -stop logs.ETL # Available profiles: # - WSL (default) - General WSL tracing # - WSL-Storage - Enhanced storage tracing # - WSL-Networking - Comprehensive networking tracing # - WSL-HvSocket - HvSocket-specific tracing # Example: wpr -start diagnostics\wsl.wprp!WSL -filemode ``` ### Log Analysis Tools - Use WPA (Windows Performance Analyzer) for ETL traces - Key providers: `Microsoft.Windows.Lxss.Manager`, `Microsoft.Windows.Subsystem.Lxss` ### Debug Console (Linux) Add to `%USERPROFILE%\.wslconfig`: ```ini [wsl2] debugConsole=true ``` ### Common Debugging Commands - Debug shell: `wsl --debug-shell` - Collect WSL logs: `powershell diagnostics\collect-wsl-logs.ps1` - Network logs: `powershell diagnostics\collect-wsl-logs.ps1 -LogProfile networking` ## Critical Timing and Timeout Guidelines **NEVER CANCEL these operations - always wait for completion:** - **Full Windows build**: 20-45 minutes (set timeout: 60+ minutes) - **Full test suite**: 30-60 minutes (set timeout: 90+ minutes) - **Unit test subset**: 5-15 minutes (set timeout: 30+ minutes) - **Documentation build**: ~0.5 seconds (set timeout: 5+ minutes) - **Distribution validation**: 2-5 minutes (set timeout: 15+ minutes) ## CI/CD Integration ### GitHub Actions - **distributions.yml**: Validates distribution metadata (Linux) - **documentation.yml**: Builds and deploys docs (Linux) - **modern-distributions.yml**: Tests modern distribution support ### Pre-commit Validation Always run before committing: 1. `clang-format --dry-run --style=file` on changed C++ files 2. `python3 tools/devops/validate-copyright-headers.py` (ignore _deps/ warnings) 3. `mkdocs build -f doc/mkdocs.yml` if documentation changed 4. Full Windows build if core components changed **Note**: The `.gitignore` file properly excludes build artifacts (*.sln, *.dll, *.pdb, obj/, bin/, etc.) - do not commit these files. ## Development Environment Setup ### Windows (Full Development) 1. Install Visual Studio with required components (listed above) 2. Install CMake 3.25+ 3. Enable Developer Mode 4. Clone repository 5. Run `cmake .` to generate solution ### Linux (Documentation/Validation Only) 1. Install Python 3.8+ 2. Install clang-format 3. Install docs tools: `pip install mkdocs-mermaid2-plugin mkdocs` 4. Clone repository 5. Run validation commands as needed Remember: **This is a Windows-focused project**. While some tasks can be performed on Linux, full WSL development requires Windows with Visual Studio. ================================================ FILE: .github/policies/resourceManagement.yml ================================================ id: name: GitOps.PullRequestIssueManagement description: GitOps.PullRequestIssueManagement primitive owner: resource: repository disabled: false where: configuration: resourceManagementConfiguration: scheduledSearches: - description: frequencies: - hourly: hour: 3 filters: - isIssue - isOpen - hasLabel: label: needs-author-feedback - noActivitySince: days: 7 actions: - closeIssue - addReply: reply: >- This issue has been automatically closed since it has not had any author activity for the past **7 days**. If you're still experiencing this issue please re-file it as a new issue. Thank you! - description: Close year old issues frequencies: - weekday: day: Thursday time: 12:00 filters: - isIssue - isOpen - isNotLabeledWith: label: feature - noActivitySince: days: 365 actions: - closeIssue - addReply: reply: >- This issue has been automatically closed since it has not had any activity for the past **year**. If you're still experiencing this issue please re-file this as a new issue or feature request. Thank you! eventResponderTasks: - if: - payloadType: Issue_Comment - isAction: action: Created - isActivitySender: issueAuthor: True - hasLabel: label: needs-author-feedback then: - removeLabel: label: needs-author-feedback description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/dup(licate|e)?(\s+of)?\s+\#[\d]+' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - addReply: reply: >- Hi! We've identified this issue as a duplicate of another one that already exists in this repository. This specific instance is being closed in favor of tracking the concern over on the referenced thread. Thanks for your report! - closeIssue - addLabel: label: duplicate description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/need-repro' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - addReply: reply: >- We’ve labelled your issue as ‘need-repro’ since we need more steps to help identify your problem. Could you please provide us with reproducible steps for the issue you’re experiencing, including things such as the specific command line steps necessary to reproduce the behavior and their output. Thank you! - addLabel: label: need-repro description: - if: - payloadType: Issue_Comment then: - cleanEmailReply description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/template' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - closeIssue - addReply: reply: >- Hi! We've closed your issue since you haven't used the template, or it is incomplete. Could you please provide all the requested info in the bug template and resubmit? Having that information will help us be able to accurately diagnose and resolve your issue. Thank you! - lockIssue description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/fixed' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - closeIssue - addLabel: label: fixedininsiderbuilds - addReply: reply: >- This bug or feature request originally submitted has been addressed in whole or in part. Related or ongoing bug or feature gaps should be opened as a new issue submission if one does not already exist. Thank you! - removeLabel: label: fixinbound description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/logs?' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - addReply: reply: >- Hello! Could you please provide more logs to help us better diagnose your issue? To collect WSL logs, download and execute [collect-wsl-logs.ps1](https://github.com/Microsoft/WSL/blob/master/diagnostics/collect-wsl-logs.ps1) in an **administrative powershell prompt**: ``` Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\collect-wsl-logs.ps1 ``` The script will output the path of the log file once done. Once completed please upload the output files to this GitHub issue. See [Collect WSL logs (recommended method)](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#8-collect-wsl-logs-recommended-method). If you choose to email these logs instead of attaching them to the bug, please send them to wsl-gh-logs@microsoft.com with the GitHub issue number in the subject, and include a link to your GitHub issue comment in the message body. Thank you! - addLabel: label: needs-author-feedback description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/dump?' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - addReply: reply: >- Hello! Could you please provide logs and process dumps to help us better diagnose your issue? To collect WSL logs and dumps, download and execute [collect-wsl-logs.ps1](https://github.com/Microsoft/WSL/blob/master/diagnostics/collect-wsl-logs.ps1) in an **administrative powershell prompt**: ``` Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\collect-wsl-logs.ps1 -Dump ``` The script will output the path of the log file once done. Once completed please upload the output files to this GitHub issue. See [Collect WSL logs (recommended method)](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#8-collect-wsl-logs-recommended-method). Thank you! - addLabel: label: needs-author-feedback description: - if: - payloadType: Issue_Comment - commentContains: pattern: '\/bsod?' isRegex: True - or: - activitySenderHasPermission: permission: Admin - activitySenderHasPermission: permission: Write then: - addReply: reply: >- Hello! Could you please provide a kernel dump to help us better diagnose your issue? To collect a kernel dump, follow [10) Reporting a Windows crash (BSOD)](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#10-reporting-a-windows-crash-bsod) Thank you! - addLabel: label: needs-author-feedback description: onFailure: onSuccess: ================================================ FILE: .github/pull_request_template.md ================================================ ## Summary of the Pull Request ## PR Checklist - [ ] **Closes:** Link to issue #xxx - [ ] **Communication:** I've discussed this with core contributors already. If work hasn't been agreed, this work might be rejected - [ ] **Tests:** Added/updated if needed and all pass - [ ] **Localization:** All end user facing strings can be localized - [ ] **Dev docs:** Added/updated if needed - [ ] **Documentation updated:** If checked, please file a pull request on [our docs repo](https://github.com/MicrosoftDocs/wsl/) and link it here: #xxx ## Detailed Description of the Pull Request / Additional comments ## Validation Steps Performed ================================================ FILE: .github/workflows/distributions.yml ================================================ name: Validate distributions on: pull_request: paths: ['distributions/**'] jobs: check: name: Validate distributions runs-on: ubuntu-latest steps: - name: Checkout repo uses: actions/checkout@v4 - name: Run validation run: python distributions/validate.py distributions/DistributionInfo.json shell: bash ================================================ FILE: .github/workflows/documentation.yml ================================================ name: Build documentation on: workflow_dispatch: push: branches: [main, master] jobs: DeployDocs: environment: name: github-pages url: ${{ steps.deployment.outputs.page_url }} runs-on: ubuntu-latest permissions: contents: read pages: write id-token: write steps: - name: Checkout actions uses: actions/checkout@v4 - name: Install packages run: pip install mkdocs-mermaid2-plugin mkdocs --break-system-packages shell: bash - name: Build documentation run: mkdocs build -f doc/mkdocs.yml shell: bash - uses: actions/upload-pages-artifact@v4 with: path: doc/site - name: Deploy to GitHub Pages id: deployment uses: actions/deploy-pages@v4 ================================================ FILE: .github/workflows/issue_edited.yml ================================================ name: Process edited issue on: workflow_dispatch: issues: types: [edited] jobs: wti: name: Run wti runs-on: windows-2022 permissions: issues: write steps: - name: Checkout repo uses: actions/checkout@v4 - uses: ./.github/actions/triage with: issue: "${{ github.event.issue.number }}" previous_body: "${{ github.event.changes.body.from }}" token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: .github/workflows/modern-distributions.yml ================================================ name: Validate tar based distributions on: pull_request: paths: ['distributions/**'] jobs: check: name: Validate tar based distributions changes runs-on: ubuntu-latest steps: - name: Checkout repo uses: actions/checkout@v4 with: fetch-depth: 0 - name: Install pip packages run: pip install -r distributions/requirements.txt shell: bash - name: Run validation run: | python distributions/validate-modern.py \ --repo-path . \ --compare-with-branch 'origin/${{ github.base_ref }}' \ --manifest distributions/DistributionInfo.json \ shell: bash ================================================ FILE: .github/workflows/new_issue.yml ================================================ name: Process new issue on: workflow_dispatch : issues: types: [opened] jobs: wti: name: Run wti runs-on: windows-2022 permissions: issues: write steps: - name: Checkout repo uses: actions/checkout@v4 - uses: ./.github/actions/triage with: issue: "${{ github.event.issue.number }}" token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: .github/workflows/new_issue_comment.yml ================================================ name: Process new comment on issue on: workflow_dispatch : issue_comment: types: [created] jobs: wti: name: Run wti runs-on: windows-2022 permissions: issues: write if: ${{ !github.event.issue.pull_request && github.event.issue.user.id == github.event.comment.user.id }} steps: - name: Checkout repo uses: actions/checkout@v4 - uses: ./.github/actions/triage with: issue: '${{ github.event.issue.number }}' comment: '${{ github.event.comment.id }}' token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: .github/workflows/winget.yml ================================================ name: Publish to WinGet on: release: types: [released] jobs: publish: if: github.event.release.prerelease == false runs-on: windows-latest # Action can only run on Windows steps: - name: Publish WSL run: | Set-StrictMode -Version Latest $ErrorActionPreference = "Stop" $assets = '${{ toJSON(github.event.release.assets) }}' | ConvertFrom-Json $wingetRelevantAssetx64 = $assets | Where-Object { $_.name -like '*x64.msi' } | Select-Object -First 1 $wingetRelevantAssetARM64 = $assets | Where-Object { $_.name -like '*arm64.msi' } | Select-Object -First 1 $version = "${{ github.event.release.tag_name }}" $wingetx64URL = $wingetRelevantAssetx64.browser_download_url $wingetARM64URL = $wingetRelevantAssetARM64.browser_download_url $wingetPackageId = "Microsoft.WSL" & curl.exe -JLO https://aka.ms/wingetcreate/latest & .\wingetcreate.exe update $wingetPackageId -s -v $version -u "$wingetx64URL|x64" "$wingetARM64URL|arm64" -t "${{ secrets.WINGET_TOKEN }}" ================================================ FILE: .gitignore ================================================ .vscode/* .vs/ !vendor/.preserve out tmp /.vs/ /.vscode/ *.sln *.slnx *.user *.csproj *.vcxproj *.filters *.pdb *.lib *.dll obj/ Debug/ Release/ Properties/ /_deps/ /package/Strings/en-US/ /packages/ CMakeFiles/ CMakeCache.txt *.msix cmake_install.cmake build_tools/ *_i.c *_p.c *_p.c wslsupport/wslsupport.h dlldata.c .gdbinit llvm/ *.a *.so *.o linux/init/init linux/init initrd/init bin/ *.nupkg generated/ *.nuspec test/linux/unit_tests/wsl_unit_tests *.dir/ UserConfig.cmake *.wix *.wixobj *.wixpdb test.bat AppxManifest.xml package_layout/ priconf.xml resources.map.txt resources.pri msi-install-*.txt kernellogs.txt FormatSource.ps1 msixinstaller/x64 package/x64 /appx-logs.txt tools/clang-format.exe /linux-crashes doc/site/ directory.build.targets test-storage/ *.vhdx ================================================ FILE: .pipelines/build-stage.yml ================================================ parameters: - name: isRelease type: boolean default: true - name: packageVersion type: string default: "" - name: isNightly type: boolean default: false - name: nugetPackages type: object default: - Microsoft.WSL.PluginApi.nuspec - name: traceLoggingConfig type: string default: '' - name: targets type: object default: - target: "wsl;libwsl;wslg;wslservice;wslhost;wslrelay;wslinstaller;wslinstall;initramfs;wslserviceproxystub;wslsettings;wslinstallerproxystub;testplugin" pattern: "wsl.exe,libwsl.dll,wslg.exe,wslservice.exe,wslhost.exe,wslrelay.exe,wslinstaller.exe,wslinstall.dll,wslserviceproxystub.dll,wslsettings/wslsettings.dll,wslsettings/wslsettings.exe,wslinstallerproxystub.dll,wsldevicehost.dll,WSLDVCPlugin.dll,testplugin.dll,wsldeps.dll" - target: "msixgluepackage" pattern: "gluepackage.msix" - target: "msipackage" pattern: "wsl.msi" - name: platforms type: object default: - x64 - arm64 - name: pool type: string default: '' - name: vsoOrg type: string - name: vsoProject type: string - name: esrp type: object default: ConnectedServiceName: "AzureConnection-AME" signConfigType: "inlineSignParams" SessionTimeout: 60 MaxConcurrency: 50 MaxRetryAttempts: 5 ServiceEndpointUrl: $(EsrpServiceEndpointUrl) AuthAKVName: $(EsrpAuthAKVName) AuthSignCertName: $(EsrpAuthSignCertName) AppRegistrationClientId: $(EsrpAppRegistrationClientId) AppRegistrationTenantId: $(EsrpAppRegistrationTenantId) EsrpClientId: $(EsrpClientId) stages: - stage: build jobs: - job: displayName: "Formatting & localization checks" timeoutInMinutes: 30 variables: ob_outputDirectory: '$(Build.SourcesDirectory)\out' ${{ if eq(parameters.pool, '') }}: pool: {'type': 'windows'} ${{ else }}: pool: ${{ parameters.pool }} steps: - script: python tools/devops/validate-localization.py localization/strings en-US displayName: Validate localization resources - script: python tools\devops\validate-copyright-headers.py src displayName: Validate copyright headers (src/) - script: python tools\devops\validate-copyright-headers.py test displayName: Validate copyright headers (test/) - task: CMake@1 displayName: "CMake ." inputs: workingDirectory: "." cmakeArgs: . - task: PowerShell@2 inputs: targetType: "filePath" filePath: FormatSource.ps1 arguments: "-ModifiedOnly $false -Verify $true" displayName: "Clang-format check" - job: build displayName: "Build WSL package" timeoutInMinutes: 120 ${{ if eq(parameters.pool, '') }}: pool: {'type': 'windows'} ${{ else }}: pool: ${{ parameters.pool }} variables: NUGET_PLUGIN_HANDSHAKE_TIMEOUT_IN_SECONDS: 60 NUGET_PLUGIN_REQUEST_TIMEOUT_IN_SECONDS: 60 ob_outputDirectory: '$(Build.SourcesDirectory)\out' ob_artifactBaseName: 'drop_wsl' ob_artifactSuffix: '_build' ob_sdl_codeSignValidation_excludes: -|**testbin\** Codeql.PublishDatabaseLog: true Codeql.SourceRoot: src packageStagingDir: '$(Build.SourcesDirectory)\packageStagingDir' ${{ if eq(parameters.isRelease, 'true') }}: packageInputDirArg: '-DPACKAGE_INPUT_DIR=$(packageStagingDir)' ${{ else }}: packageInputDirArg: '' steps: - task: CodeQL3000Init@0 inputs: Enabled: ${{ and(parameters.isNightly, eq(variables['Build.SourceBranch'], 'refs/heads/main'))}} - task: UseDotNet@2 displayName: Install .NET Core SDK (required by EsrpCodeSigning) condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) inputs: packageType: "sdk" - task: PowerShell@2 displayName: Set trace logging configuration condition: ne('${{ parameters.traceLoggingConfig }}', '') inputs: targetType: 'inline' script: 'Set-Content -Path src/windows/inc/traceloggingconfig.h -Value $env:config.replace("\n", "`n")' env: config: '${{ parameters.traceLoggingConfig }}' - task: PowerShell@2 displayName: "Compute package version" name: version inputs: targetType: inline ${{ if eq(parameters.packageVersion, '') }}: script: | $gitversion_version = (Select-Xml -Path packages.config -XPath '/packages/package[@id=''GitVersion.CommandLine'']/@version').Node.Value $env:path = "packages/GitVersion.CommandLine.$gitversion_version/tools;$env:path" . .\tools\devops\version_functions.ps1 $version = Get-VersionInfo -Nightly $${{ parameters.isNightly }} Write-Host "##vso[task.setvariable variable=WSL_PACKAGE_VERSION;isOutput=true]$($version.MsixVersion)" Write-Host "##vso[task.setvariable variable=WSL_NUGET_PACKAGE_VERSION;isOutput=true]$($version.NugetVersion)" ${{ else }}: script: | Write-Host "##vso[task.setvariable variable=WSL_PACKAGE_VERSION;isOutput=true]$([string]('${{ parameters.packageVersion }}' + '.0'))" Write-Host "##vso[task.setvariable variable=WSL_NUGET_PACKAGE_VERSION;isOutput=true]$([string]('${{ parameters.packageVersion }}'))" - ${{ each platform in parameters.platforms }}: - task: CMake@1 displayName: "CMake ${{ platform }}" inputs: workingDirectory: "." cmakeArgs: . --fresh -A ${{ platform }} -DCMAKE_BUILD_TYPE=Release -DCMAKE_SYSTEM_VERSION=10.0.26100.0 -DPACKAGE_VERSION=$(version.WSL_PACKAGE_VERSION) -DWSL_NUGET_PACKAGE_VERSION=$(version.WSL_NUGET_PACKAGE_VERSION) -DSKIP_PACKAGE_SIGNING=${{ parameters.isRelease }} -DOFFICIAL_BUILD=${{ parameters.isRelease }} -DPIPELINE_BUILD_ID=$(Build.BuildId) -DVSO_ORG=${{ parameters.vsoOrg }} -DVSO_PROJECT=${{ parameters.vsoProject }} -DWSL_BUILD_WSL_SETTINGS=true $(packageInputDirArg)\${{ platform }} # This additional Restore NuGet package task is added as a workaround for WSL Settings to have its packages restored properly. # Without this, building wsl settings may encounter the following error: # # The plugin credential provider could not acquire credentials. Authentication may require manual action. # Consider re-running the command with --interactive for `dotnet`, /p:NuGetInteractive="true" for MSBuild or removing the -NonInteractive switch for `NuGet` # Response status code does not indicate success: 401 (Unauthorized) - script: _deps\nuget.exe restore -NonInteractive - ${{ each target in parameters.targets }}: - script: cmake --build . --config Release --target ${{ target.target }} -- -m condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) displayName: "Build ${{ target.target }} (${{ platform }})" - ${{ if eq(parameters.isRelease, 'true') }}: - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@5 displayName: "Sign ${{ target.target }} (${{ platform }})" condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) inputs: ConnectedServiceName: ${{ parameters.esrp.ConnectedServiceName}} signConfigType: ${{ parameters.esrp.signConfigType }} SessionTimeout: ${{ parameters.esrp.SessionTimeout }} MaxConcurrency: ${{ parameters.esrp.MaxConcurrency }} MaxRetryAttempts: ${{ parameters.esrp.MaxRetryAttempts }} ServiceEndpointUrl: ${{ parameters.esrp.ServiceEndpointUrl }} AuthAKVName: ${{ parameters.esrp.AuthAKVName }} AuthSignCertName: ${{ parameters.esrp.AuthSignCertName }} AppRegistrationClientId: ${{ parameters.esrp.AppRegistrationClientId }} AppRegistrationTenantId: ${{ parameters.esrp.AppRegistrationTenantId }} FolderPath: "bin\\${{ platform }}\\Release" Pattern: "${{ target.pattern }}" UseMSIAuthentication: true EsrpClientId: ${{ parameters.esrp.EsrpClientId }} inlineOperation: | [ { "KeyCode": "CP-230012", "OperationCode": "SigntoolSign", "Parameters" : { "OpusName" : "Microsoft", "OpusInfo" : "http://www.microsoft.com", "FileDigest" : "/fd \"SHA256\"", "PageHash" : "/NPH", "TimeStamp" : "/tr \"http://rfc3161.gtm.corp.microsoft.com/TSS/HttpTspServer\" /td sha256" }, "ToolName" : "sign", "ToolVersion" : "1.0" }, { "KeyCode" : "CP-230012", "OperationCode" : "SigntoolVerify", "Parameters" : {}, "ToolName" : "sign", "ToolVersion" : "1.0" } ] - task: PowerShell@2 displayName: "Copy signed ${{ target.target }} to staging (${{ platform }})" condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) inputs: targetType: inline script: | $arch = '${{ platform }}' $pattern = '${{ target.pattern }}' $inputDir = "bin\$arch\Release" $outputDir = "$(packageStagingDir)\$arch" New-Item -ItemType Directory -Path "$outputDir\wslsettings" -Force foreach ($file in $pattern.Split(',')) { $sourcePath = Join-Path $inputDir $file if (Test-Path $sourcePath) { $destPath = Join-Path $outputDir $file Write-Host "Copying signed file: $sourcePath -> $destPath" Copy-Item -Path $sourcePath -Destination $destPath -Force } else { Write-Warning "File not found: $sourcePath" } } - script: cmake --build . --config Release -- -m displayName: "Build installer msix and tests (${{ platform }})" - task: PowerShell@2 displayName: "Move ${{ platform }} installer msi to output directory" inputs: targetType: inline script: | New-Item -ItemType Directory -Path "$(ob_outputDirectory)\bundle" -Force $arch = '${{ platform }}' Copy-Item -Path "bin\$arch\release\wsl.msi" -Destination "$(ob_outputDirectory)\bundle\wsl.$(version.WSL_PACKAGE_VERSION).$arch.msi" - ${{ if eq(parameters.isRelease, 'true') }}: - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@5 displayName: "Sign the bundle" condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) inputs: ConnectedServiceName: ${{ parameters.esrp.ConnectedServiceName}} signConfigType: ${{ parameters.esrp.signConfigType }} SessionTimeout: ${{ parameters.esrp.SessionTimeout }} MaxConcurrency: ${{ parameters.esrp.MaxConcurrency }} MaxRetryAttempts: ${{ parameters.esrp.MaxRetryAttempts }} ServiceEndpointUrl: ${{ parameters.esrp.ServiceEndpointUrl }} AuthAKVName: ${{ parameters.esrp.AuthAKVName }} AuthSignCertName: ${{ parameters.esrp.AuthSignCertName }} AppRegistrationClientId: ${{ parameters.esrp.AppRegistrationClientId }} AppRegistrationTenantId: ${{ parameters.esrp.AppRegistrationTenantId }} FolderPath: "bundle" Pattern: "*.msixbundle" UseMSIAuthentication: true EsrpClientId: ${{ parameters.esrp.EsrpClientId }} inlineOperation: | [ { "KeyCode": "CP-230012", "OperationCode": "SigntoolSign", "Parameters" : { "OpusName" : "Microsoft", "OpusInfo" : "http://www.microsoft.com", "FileDigest" : "/fd \"SHA256\"", "PageHash" : "/NPH", "TimeStamp" : "/tr \"http://rfc3161.gtm.corp.microsoft.com/TSS/HttpTspServer\" /td sha256" }, "ToolName" : "sign", "ToolVersion" : "1.0" }, { "KeyCode" : "CP-230012", "OperationCode" : "SigntoolVerify", "Parameters" : {}, "ToolName" : "sign", "ToolVersion" : "1.0" } ] - script: md.exe $(ob_outputDirectory)\bin\nuget displayName: "Create the nuget directory" - ${{ each package in parameters.nugetPackages }}: - script: nuget.exe pack ${{ package }} -OutputDirectory $(ob_outputDirectory)\bin\nuget -NonInteractive displayName: Build ${{ package }} - ${{ if eq(parameters.isRelease, 'true') }}: - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@5 displayName: "Sign nuget packages" condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) inputs: ConnectedServiceName: ${{ parameters.esrp.ConnectedServiceName}} signConfigType: ${{ parameters.esrp.signConfigType }} SessionTimeout: ${{ parameters.esrp.SessionTimeout }} MaxConcurrency: ${{ parameters.esrp.MaxConcurrency }} MaxRetryAttempts: ${{ parameters.esrp.MaxRetryAttempts }} ServiceEndpointUrl: ${{ parameters.esrp.ServiceEndpointUrl }} AuthAKVName: ${{ parameters.esrp.AuthAKVName }} AuthSignCertName: ${{ parameters.esrp.AuthSignCertName }} AppRegistrationClientId: ${{ parameters.esrp.AppRegistrationClientId }} AppRegistrationTenantId: ${{ parameters.esrp.AppRegistrationTenantId }} FolderPath: '$(ob_outputDirectory)\bin\nuget' Pattern: "*.nupkg" UseMSIAuthentication: true EsrpClientId: ${{ parameters.esrp.EsrpClientId }} inlineOperation: | [ { "KeyCode": "CP-401405", "OperationCode": "NuGetSign", "Parameters" : {}, "ToolName" : "sign", "ToolVersion" : "1.0" }, { "KeyCode" : "CP-401405", "OperationCode" : "NuGetVerify", "Parameters" : {}, "ToolName" : "sign", "ToolVersion" : "1.0" } ] - powershell: | foreach ($arch in @("x64", "ARM64")) { $binFolder = ".\bin\$arch\Release" $pdbFolder = Join-Path $(ob_outputDirectory) "pdb\$arch\Release" mkdir $pdbFolder foreach ($filter in @("*.pdb", "*.debug")) { foreach ($e in (Get-ChildItem -Recurse -Path $binFolder -Filter $filter)) {Move-Item -Path $e.fullname -Destination (Join-Path $pdbFolder $e.name)} } } displayName: Collect symbols - powershell: | mkdir appxsym foreach ($arch in @("x64", "ARM64")) { Get-ChildItem -Path $(ob_outputDirectory)\pdb\$arch\release\*.pdb -Exclude wsltests.pdb | Compress-Archive -DestinationPath appxsym/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_$arch.zip Copy-Item -Path appxsym/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_$arch.zip -Destination appxsym/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_$arch.appxsym } mkdir $(ob_outputDirectory)/appxupload Get-ChildItem -Path appxsym/*.appxsym,bundle/release/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_x64_ARM64.msixbundle | Compress-Archive -DestinationPath $(ob_outputDirectory)/appxupload/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_x64_ARM64.zip Move-Item -Path $(ob_outputDirectory)/appxupload/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_x64_ARM64.zip -Destination $(ob_outputDirectory)/appxupload/Microsoft.WSL_$(version.WSL_PACKAGE_VERSION)_x64_ARM64.appxupload rm appxsym/*.appxsym displayName: Create appxupload condition: and(succeeded(), eq('${{ parameters.isRelease }}', true)) - powershell: | $taefVersion = (Select-Xml -Path packages.config -XPath '/packages/package[@id=''Microsoft.Taef'']/@version').Node.Value New-Item -ItemType Directory -Path "$(ob_outputDirectory)\bundle" -Force foreach ($arch in @("x64", "ARM64")) { mkdir $(ob_outputDirectory)\testbin\$arch\release Move-Item -Path "bin\$arch\release\wsltests.dll" -Destination "$(ob_outputDirectory)\testbin\$arch\release\wsltests.dll" Move-Item -Path "bin\$arch\release\testplugin.dll" -Destination "$(ob_outputDirectory)\testbin\$arch\release\testplugin.dll" Move-Item -Path "packages\Microsoft.Taef.$taefVersion\build\Binaries\$arch" -Destination "$(ob_outputDirectory)\testbin\$arch\release\taef" } Move-Item -Path "bin\x64\cloudtest" -Destination "$(ob_outputDirectory)\testbin\x64\cloudtest" Move-Item -Path "tools\test\test-setup.ps1" -Destination "$(ob_outputDirectory)\testbin\test-setup.ps1" Move-Item -Path "tools\test\CloudTest-Setup.bat" -Destination "$(ob_outputDirectory)\testbin\CloudTest-Setup.bat" Move-Item -Path "diagnostics\wsl.wprp" -Destination "$(ob_outputDirectory)\testbin\wsl.wprp" Move-Item -Path "test\linux\unit_tests" -Destination "$(ob_outputDirectory)\testbin\unit_tests" Move-Item -Path bundle\release\* -Destination $(ob_outputDirectory)\bundle $TestDistroVersion = (Select-Xml -Path packages.config -XPath '/packages/package[@id=''Microsoft.WSL.TestDistro'']/@version').Node.Value Copy-Item "packages\Microsoft.WSL.TestDistro.$TestDistroVersion\test_distro.tar.xz" "$(ob_outputDirectory)\testbin\x64" displayName: Move artifacts to drop directory - task: PublishSymbols@2 displayName: Publish symbols inputs: SymbolServerType: "TeamServices" TreatNotIndexedAsWarning: true SymbolsProduct: WSL SymbolsVersion: $(version.WSL_PACKAGE_VERSION) SearchPattern: | $(ob_outputDirectory)/pdb/**/*.pdb $(ob_outputDirectory)/bin/**/*.exe $(ob_outputDirectory)/bin/**/*.dll - ${{ if ne(parameters.pool, '') }}: - task: PublishPipelineArtifact@1 inputs: targetPath: $(ob_outputDirectory) artifactName: $(ob_artifactBaseName)$(ob_artifactSuffix) - task: CodeQL3000Finalize@0 condition: ${{ and(parameters.isNightly, eq(variables['Build.SourceBranch'], 'refs/heads/main'))}} ================================================ FILE: .pipelines/flight-stage.yml ================================================ parameters: - name: publishPackage type: boolean default: false - name: packageVersion type: string default: '' - name: bypassTests type: boolean default: false stages: - stage: flight ${{ if eq(parameters.bypassTests, true) }}: dependsOn: [build] ${{ else }}: dependsOn: [test] jobs: - job: flight displayName: 'Package and Flight WSL package' dependsOn: [] # The stage handles this dependency pool: type: windows variables: AppId: 9P9TQF7MRM4R FlightId: $(StoreBrokerFlightId) StoreBrokerPath: $(Build.SourcesDirectory)\storebroker # location of StoreBroker information in the repo StoreBrokerPayloadPath: $(Build.ArtifactStagingDirectory)\StoreBrokerPayload # location of package created for flight WSL_PACKAGE_VERSION: $[ dependencies.build.outputs['version.WSL_PACKAGE_VERSION'] ] ob_outputDirectory: '$(Build.SourcesDirectory)\out' ob_artifactBaseName: 'drop_wsl' ob_artifactSuffix: '_flight' ob_sdl_checkcflags_enabled : false # Disable the CFLAGS check since we're not actually building anything in this stage steps: # Source: https://learn.microsoft.com/azure/devops/pipelines/build/run-retention?view=azure-devops&tabs=powershell - task: PowerShell@2 condition: and(succeeded(), not(canceled())) displayName: Retain this build inputs: failOnStderr: true targetType: 'inline' script: | $contentType = "application/json"; $headers = @{ Authorization = 'Bearer $(System.AccessToken)' }; $rawRequest = @{ daysValid = 365 * 2; definitionId = $(System.DefinitionId); ownerId = 'User:$(Build.RequestedForId)'; protectPipeline = $false; runId = $(Build.BuildId) }; $request = ConvertTo-Json @($rawRequest); $uri = "$(System.CollectionUri)$(System.TeamProject)/_apis/build/retention/leases?api-version=6.0-preview.1"; Invoke-RestMethod -uri $uri -method POST -Headers $headers -ContentType $contentType -Body $request; # Download the build drop - task: DownloadPipelineArtifact@2 displayName: Download Bundle artifact inputs: artifact: "drop_wsl_build" path: drop # copy the appxupload folder to the storebroker folder - powershell: | mkdir $(StoreBrokerPath)\appxpackage\ Copy-Item -Path drop\appxupload\* -Destination $(StoreBrokerPath)\appxpackage\ -Recurse -Force displayName: Copy AppxUpload artifact # creates a submission package that is published to the store; containers store page information and the WSL appxupload - task: MS-RDX-MRO.windows-store-publish.package-task.store-package@3 displayName: 'Creating StoreBroker Payload' inputs: serviceEndpoint: 'AzureConnection-StoreBroker-WIF' sbConfigPath: $(StoreBrokerPath)\sbconfig.json sourceFolder: $(StoreBrokerPath)\appxpackage\ contents: Microsoft.WSL_${{ parameters.packageVersion }}.0_x64_ARM64.appxupload pdpPath: $(StoreBrokerPath)\PDPs\ pdpInclude: PDP.xml pdpMediaPath: $(StoreBrokerPath)\Media\ outSBPackagePath: $(StoreBrokerPayloadPath) outSBName: WindowsSubsystemForLinux # copy the storebroker submission package to the drop folder so it can be used if needed - powershell: | New-Item -ItemType Directory -Force -Path $(ob_outputDirectory) Copy-Item -Path $(StoreBrokerPayloadPath)\* -Destination $(ob_outputDirectory) -Recurse -Force Copy-Item -Path SBLog.txt -Destination $(ob_outputDirectory) -Force displayName: Copy StoreBrokerPayload to drop # submit the package flight to the WSL SelfHost Flight Group - task: MS-RDX-MRO.windows-store-publish.flight-task.store-flight@3 displayName: 'Flight StoreBroker Package to Partner Center - WSL SelfHost Flight Group' condition: and(succeeded(), eq('${{ parameters.publishPackage }}', true)) inputs: serviceEndpoint: 'AzureConnection-StoreBroker-WIF' appId: $(AppId) flightId: $(FlightId) inputMethod: JsonAndZip jsonPath: $(StoreBrokerPayloadPath)\WindowsSubsystemForLinux.json zipPath: $(StoreBrokerPayloadPath)\WindowsSubsystemForLinux.zip force: true skipPolling: true # skips polling Partner Centre/store API for the state of the package; skipping will mean that errors in the process will only show up in Partner Center targetPublishMode: Immediate # on completion of this task, the package will be published to the WSL SelfHost flight once certified (no manual clicking of any buttons in Partner Center) preserveSubmissionId: false deletePackages: true numberOfPackagesToKeep: 0 - task: PipAuthenticate@1 displayName: 'Pip Authenticate' inputs: artifactFeeds: 'wsl' # Create a draft github release - powershell: | pip install --user -r tools/devops/requirements.txt python tools/devops/create-release.py '${{ parameters.packageVersion }}' drop\bundle\Microsoft.WSL_${{ parameters.packageVersion }}.0_x64_ARM64.msixbundle drop\bundle\wsl.${{ parameters.packageVersion }}.0.arm64.msi drop\bundle\wsl.${{ parameters.packageVersion }}.0.x64.msi --no-fetch --github-token "$env:token" ${{ iif(parameters.publishPackage, '--publish --auto-release-notes', '--use-current-ref') }} displayName: Create GitHub release env: token: $(GITHUB_RELEASE_TOKEN) ================================================ FILE: .pipelines/nuget-stage.yml ================================================ parameters: - name: isNightly type: boolean default: false - name: nugetPackages type: object default: - Microsoft.WSL.PluginApi stages: - stage: nuget dependsOn: [build, test] jobs: - job: nuget displayName: 'Publish nuget packages' condition: and(succeeded(), or(eq(variables['Build.Reason'], 'Schedule'), eq('${{ parameters.isNightly }}', false))) dependsOn: [] # The stage handles this dependency pool: type: windows variables: WSL_NUGET_PACKAGE_VERSION: $[ dependencies.build.outputs['version.WSL_NUGET_PACKAGE_VERSION'] ] NUGET_PLUGIN_HANDSHAKE_TIMEOUT_IN_SECONDS: 60 NUGET_PLUGIN_REQUEST_TIMEOUT_IN_SECONDS: 60 ob_outputDirectory: '$(Build.SourcesDirectory)\out' ob_artifactBaseName: 'drop_wsl' ob_artifactSuffix: '_nuget' steps: - task: DownloadPipelineArtifact@2 displayName: Download nuget artifacts inputs: artifact: "drop_wsl_build" path: drop # Note: this task might fail if there's been no commits between two nightly pipelines, which is fine. - ${{ each package in parameters.nugetPackages }}: - task: NuGetCommand@2 displayName: Push nuget/${{ package }}.$(WSL_NUGET_PACKAGE_VERSION).nupkg inputs: command: 'push' packagesToPush: drop/nuget/${{ package }}.$(WSL_NUGET_PACKAGE_VERSION).nupkg nuGetFeedType: 'internal' publishVstsFeed: wsl allowPackageConflicts: ${{ parameters.isNightly }} ================================================ FILE: .pipelines/test-job.yml ================================================ parameters: - name: branch type: string - name: version type: string - name: image type: string - name: run type: boolean - name: pool type: string default: '' jobs: - job: test_${{ parameters.branch }}_${{ parameters.version }} displayName: "${{ parameters.version }} tests - ${{ parameters.branch }}" dependsOn: [] condition: and(succeeded(), eq('${{ parameters.run }}', true)) variables: ob_outputDirectory: '$(Build.SourcesDirectory)\out' ob_artifactBaseName: 'drop_wsl' ob_artifactSuffix: '_test' timeoutInMinutes: 360 cancelTimeoutInMinutes: 420 ${{ if eq(parameters.pool, '') }}: pool: {'type': 'cloudtestagentless'} ${{ else }}: pool: ${{ parameters.pool }} steps: - task: CloudTestServerBuildTask@2 inputs: DisplayName: "${{ parameters.version }} tests - ${{ parameters.branch }}" connectedServiceName: "CloudTest-PROD" cloudTestTenant: "wsl" testMapLocation: 'testbin\x64\cloudtest\wsl-test-image-${{ parameters.image }}-${{ parameters.version}}\TestMap.xml' pipelineArtifactName: "drop_wsl_build" pipelineArtifactBuildUrl: '$(System.TaskDefinitionsUri)$(System.TeamProject)/_build/results?buildId=$(Build.BuildId)' buildDropArtifactName: "" timeoutInMinutes: 360 cancelTimeoutInMinutes: 420 TestTimeout: "0.05:00:00" parserProperties: "worker:VsTestVersion=V150;session:HoldTrigger=Failure;VstsTestResultAttachmentUploadBehavior=Always" notificationSubscribers: $(Build.RequestedForEmail) scheduleBuildRequesterAlias: "lowdev" ================================================ FILE: .pipelines/test-stage.yml ================================================ parameters: - name: rs_prerelease_only type: boolean default: false - name: pool type: string default: '' - name: versions type: object default: - wsl1 - wsl2 - name: test_images type: object default: - name: rs_prerelease image: rs_prerelease-2025-01-30 - name: ni_release image: win11-23h2-ent-2024-11-18 - name: fe_release image: 2022-datacenter-g2-2024-09-10 - name: vb_release image: win10-22h2-ent-g2-2024-09-10 # TODO: ge_release stages: - stage: test dependsOn: [build] jobs: - ${{ each version in parameters.versions }}: - ${{ each image in parameters.test_images }}: - template: test-job.yml@self parameters: branch: "${{ image.name }}" version: ${{ version }} image: "${{ image.image }}" run: ${{ or(not(parameters.rs_prerelease_only), eq(image.name, 'rs_prerelease')) }} pool: "${{ parameters.pool }}" ================================================ FILE: .pipelines/wsl-build-nightly-localization.yml ================================================ trigger: branches: include: - master paths: include: - 'localization/strings/en-US/Resources.resw' # Schedule nightly build # Cron syntax: "mm HH DD MM DW" = minutes, hours, days, months, day of week (UTC time) schedules: # "0 8" = 8AM UTC = 12AM PST - cron: "0 8 * * *" displayName: Nightly Touchdown Build Schedule branches: include: - "master" always: true pool: vmImage: 'windows-latest' steps: - checkout : self persistCredentials: true - task: TouchdownBuildTask@5 displayName: Touchdown Build Localization inputs: environment: 'PRODEXT' teamId: '38646' authType: 'FederatedIdentity' FederatedIdentityServiceConnection: 'Azure-Connection' isPreview: false resourceFilePath: | localization\strings\en-US\Resources.resw;O:localization\strings\ storebroker\PDPs\en-us\PDP.xml;O:storebroker\PDPs\ localizationTarget: true pseudoSetting: 'Excluded' cultureMappingType: 'None' - task: PipAuthenticate@1 inputs: artifactFeeds: 'wsl' - powershell: | pip install --user -r tools/devops/requirements.txt python tools/devops/create-change.py . "$env:token" "WSL localization" "Localization change from build: $env:buildId" "user/localization/$env:buildId" displayName: Create pull request env: token: $(GithubPRToken) buildId: $(Build.BuildId) ================================================ FILE: .pipelines/wsl-build-nightly-onebranch.yml ================================================ trigger: none schedules: # "0 8" = 8AM UTC = 12AM PST - cron: "0 8 * * *" displayName: Nightly build branches: include: [master] always: true variables: WindowsContainerImage: "onebranch.azurecr.io/windows/ltsc2022/vse2022:latest" WindowsHostVersion: '1ESWindows2022' resources: repositories: - repository: templates type: git name: OneBranch.Pipelines/GovernedTemplates ref: refs/heads/main extends: template: v2/Microsoft.NonOfficial.yml@templates parameters: platform: name: "windows_undocked" featureFlags: EnableCDPxPAT: false WindowsHostVersion: 1ESWindows2022 globalSdl: credscan: enabled: true perStage: credscan: enabled: true tsa: enabled: false git: fetchDepth: -1 fetchTags: true stages: - template: build-stage.yml@self parameters: isRelease: false isNightly: true vsoOrg: microsoft vsoProject: Microsoft.WSL - template: test-stage.yml@self parameters: rs_prerelease_only: false ================================================ FILE: .pipelines/wsl-build-notice.yml ================================================ trigger: branches: include: - master pool: vmImage: 'windows-latest' steps: - checkout : self persistCredentials: true - task: ComponentGovernanceComponentDetection@0 displayName: Component Detection - task: notice@0 displayName: Generate NOTICE file inputs: outputfile: $(System.DefaultWorkingDirectory)/NOTICE.txt outputformat: text - task: PipAuthenticate@1 inputs: artifactFeeds: 'wsl' - powershell: | pip install --user -r tools/devops/requirements.txt python tools/devops/create-change.py . "$env:token" "WSL notice" "Notice change from build: $env:buildId" "user/notice/$env:buildId" displayName: Create pull request env: token: $(GithubPRToken) buildId: $(Build.BuildId) ================================================ FILE: .pipelines/wsl-build-pr-onebranch.yml ================================================ trigger: branches: include: - master - release/* variables: WindowsContainerImage: "onebranch.azurecr.io/windows/ltsc2022/vse2022:latest" WindowsHostVersion: '1ESWindows2022' resources: repositories: - repository: templates type: git name: OneBranch.Pipelines/GovernedTemplates ref: refs/heads/main extends: template: v2/Microsoft.NonOfficial.yml@templates parameters: platform: name: "windows_undocked" featureFlags: EnableCDPxPAT: false WindowsHostVersion: 1ESWindows2022 globalSdl: suppression: suppressionFile: $(Build.SourcesDirectory)\.gdnsuppress suppressionSet: default apiscan: enabled: false credscan: enabled: true perStage: credscan: enabled: true policheck: enabled: true break: true severity: Note git: fetchDepth: -1 fetchTags: true stages: - template: build-stage.yml@self parameters: isRelease: false - template: test-stage.yml@self parameters: rs_prerelease_only: true ================================================ FILE: .pipelines/wsl-build-pr.yml ================================================ trigger: branches: include: - master - release/* stages: - template: build-stage.yml@self parameters: isRelease: false pool: 'wsl-build' vsoOrg: shine-oss vsoProject: wsl - template: test-stage.yml@self parameters: rs_prerelease_only: true pool: server ================================================ FILE: .pipelines/wsl-build-release-onebranch.yml ================================================ parameters: - name: bypassTests displayName: 'Publish release even if tests fail' type: boolean default: false - name: testVersion displayName: 'Test the release pipeline' type: string default: '' trigger: tags: include: ['*.*.*'] variables: WindowsContainerImage: "onebranch.azurecr.io/windows/ltsc2022/vse2022:latest" WindowsHostVersion: '1ESWindows2022' resources: repositories: - repository: templates type: git name: OneBranch.Pipelines/GovernedTemplates ref: refs/heads/main extends: template: v2/Microsoft.Official.yml@templates parameters: platform: name: "windows_undocked" featureFlags: EnableCDPxPAT: false WindowsHostVersion: 1ESWindows2022 globalSdl: credscan: enabled: true perStage: credscan: enabled: true tsa: enabled: false evidence: enabled: false git: fetchDepth: -1 fetchTags: true stages: - template: build-stage.yml@self parameters: isRelease: true packageVersion: ${{ iif(eq(parameters.testVersion, ''), variables['Build.SourceBranchName'], parameters.testVersion) }} traceLoggingConfig: $(ReleaseTraceLoggingConfig) vsoOrg: microsoft vsoProject: Microsoft.WSL - template: test-stage.yml@self parameters: rs_prerelease_only: false - template: flight-stage.yml@self parameters: publishPackage: ${{ iif(eq(parameters.testVersion, ''), true, false) }} packageVersion: ${{ iif(eq(parameters.testVersion, ''), variables['Build.SourceBranchName'], parameters.testVersion) }} bypassTests: ${{ parameters.bypassTests }} - ${{ if eq(parameters.testVersion, '') }}: - template: nuget-stage.yml@self parameters: isNightly: false ================================================ FILE: CMakeLists.txt ================================================ cmake_minimum_required(VERSION 3.25) set(CMAKE_SYSTEM_VERSION 10.0.26100.0) project(wsl) # Rationalize TARGET_PLATFORM # When neither CMAKE_GENERATOR_PLATFORM nor TARGET_PLATFORM is set, default to the host architecture. if("${CMAKE_GENERATOR_PLATFORM}" STREQUAL "" AND "${TARGET_PLATFORM}" STREQUAL "") if("${CMAKE_HOST_SYSTEM_PROCESSOR}" STREQUAL "ARM64") set(TARGET_PLATFORM "arm64") else() set(TARGET_PLATFORM "x64") endif() message(STATUS "No platform specified, defaulting to '${TARGET_PLATFORM}' based on host architecture.") endif() if("${CMAKE_GENERATOR_PLATFORM}" STREQUAL "arm64" OR "${TARGET_PLATFORM}" STREQUAL "arm64") set(TARGET_PLATFORM "arm64") set(TEST_DISTRO_PLATFORM "arm64") elseif("${CMAKE_GENERATOR_PLATFORM}" MATCHES "x64|amd64" OR "${TARGET_PLATFORM}" MATCHES "x64|amd64") set(TARGET_PLATFORM "x64") set(TEST_DISTRO_PLATFORM "amd64") else() message(FATAL_ERROR "Unsupported platform: ${CMAKE_GENERATOR_PLATFORM}") endif() if (NOT ${CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION} STREQUAL ${CMAKE_SYSTEM_VERSION}) message(FATAL_ERROR "Incorrect Windows SDK version: ${CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION}, requires ${CMAKE_SYSTEM_VERSION}") endif() include(FetchContent) # Import GSL and nlohmannjson set(FETCHCONTENT_BASE_DIR ${CMAKE_BINARY_DIR}/_deps/${TARGET_PLATFORM}) FetchContent_Declare(GSL URL https://github.com/microsoft/GSL/archive/refs/tags/v4.0.0.tar.gz URL_HASH SHA256=f0e32cb10654fea91ad56bde89170d78cfbf4363ee0b01d8f097de2ba49f6ce9) FetchContent_MakeAvailable(GSL) FetchContent_GetProperties(GSL SOURCE_DIR GSL_SOURCE_DIR) FetchContent_Declare(nlohmannjson URL https://github.com/nlohmann/json/releases/download/v3.12.0/json.tar.xz URL_HASH SHA256=42f6e95cad6ec532fd372391373363b62a14af6d771056dbfc86160e6dfff7aa ) FetchContent_MakeAvailable(nlohmannjson) FetchContent_GetProperties(nlohmannjson SOURCE_DIR NLOHMAN_JSON_SOURCE_DIR) # Import modules list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake") find_package(IDL REQUIRED) find_package(LINUXBUILD REQUIRED) find_package(NUGET REQUIRED) find_package(VERSION REQUIRED) find_package(MC REQUIRED) find_package(Appx REQUIRED) # Download nuget packages restore_nuget_packages() # Load nuget packages versions and paths parse_nuget_packages_versions() find_nuget_package(Microsoft.Direct3D.Linux DIRECT3D /build/native) find_nuget_package(Microsoft.Identity.MSAL.WSL.Proxy MSAL /build/native/bin) find_nuget_package(Microsoft.RemoteDesktop.Client.MSRDC.SessionHost MSRDC /build/native/bin) find_nuget_package(Microsoft.Taef TAEF /) find_nuget_package(Microsoft.Windows.ImplementationLibrary WIL /) find_nuget_package(Microsoft.WSL.DeviceHost WSL_DEVICE_HOST /build/native) find_nuget_package(Microsoft.WSL.Kernel KERNEL /build/native) find_nuget_package(Microsoft.WSL.bsdtar BSDTARD /build/native/bin) find_nuget_package(Microsoft.WSL.LinuxSdk LINUXSDK /) find_nuget_package(Microsoft.WSL.TestDistro TEST_DISTRO /) find_nuget_package(Microsoft.WSLg WSLG /build/native/bin) find_nuget_package(vswhere VSWHERE /tools) find_nuget_package(Wix WIX /tools/net6.0/any) # Architecture-specific nuget packages from the OS repo. if (${TARGET_PLATFORM} STREQUAL "x64") find_nuget_package(Microsoft.DXCore.Linux.amd64fre DXCORE /build/native) find_nuget_package(Microsoft.WSL.Dependencies.amd64fre WSLDEPS /build/native) endif() if (${TARGET_PLATFORM} STREQUAL "arm64") find_nuget_package(Microsoft.DXCore.Linux.arm64fre DXCORE /build/native) find_nuget_package(Microsoft.WSL.Dependencies.arm64fre WSLDEPS /build/native) endif() # Wsl Settings packages find_nuget_package(CommunityToolkit.Mvvm CTK_MVVM /) find_nuget_package(CommunityToolkit.WinUI.Animations CTK_ANIMATIONS /) find_nuget_package(CommunityToolkit.WinUI.Controls.SettingsControls CTK_STTNGS_CTRLS /) find_nuget_package(Microsoft.Extensions.Hosting EXTS_HOSTING /) find_nuget_package(Microsoft.NETCore.App.Runtime.win-${TARGET_PLATFORM} DOTNET_RUNTIME /) find_nuget_package(Microsoft.WindowsAppSDK WIN_APP_SDK /) find_nuget_package(Microsoft.Windows.SDK.NET.Ref WINDOWS_SDK_DOTNET /) find_nuget_package(Microsoft.Xaml.Behaviors.WinUI.Managed XAML_BEHAVIORS /) find_nuget_package(WinUIEx WINUIEX /) set(WSLG_TS_PLUGIN_DLL "WSLDVCPlugin.dll") # Default to debug build if unspecified if(NOT CMAKE_BUILD_TYPE) set(CMAKE_BUILD_TYPE "Debug") endif() set(SUPPORTED_LANGS cs-CZ;da-DK;de-DE;en-GB;en-US;es-ES;fi-FI;fr-FR;hu-HU;it-IT;ja-JP;ko-KR;nb-NO;nl-NL;pl-PL;pt-BR;pt-PT;ru-RU;sv-SE;tr-TR;zh-CN;zh-TW) if (EXISTS "${CMAKE_CURRENT_LIST_DIR}/UserConfig.cmake") find_package(USER REQUIRED PATHS ${CMAKE_CURRENT_LIST_DIR}) endif() # Optional target configuration if (NOT DEFINED WSL_BUILD_WSL_SETTINGS) set(WSL_BUILD_WSL_SETTINGS false) endif () # Only generate the build configuration that CMake is configured for set(CMAKE_CONFIGURATION_TYPES "${CMAKE_BUILD_TYPE}" CACHE STRING "" FORCE) find_commit_hash(COMMIT_HASH) if (NOT PACKAGE_VERSION) find_version(PACKAGE_VERSION WSL_NUGET_PACKAGE_VERSION) # Fetch the package version from git if not specified endif () if (NOT PACKAGE_VERSION MATCHES "^([0-9]+).([0-9]+).([0-9]+).([0-9]+)$") message(FATAL_ERROR "PACKAGE_VERSION is invalid: '${PACKAGE_VERSION}'. Needs to match '([0-9]+).([0-9]+).([0-9]+).([0-9]+)'") endif() set(PACKAGE_VERSION_MAJOR ${CMAKE_MATCH_1}) set(PACKAGE_VERSION_MINOR ${CMAKE_MATCH_2}) set(PACKAGE_VERSION_REVISION ${CMAKE_MATCH_3}) # The store requires the revision number to be 0, so enforce this on official builds if (OFFICIAL_BUILD AND NOT PACKAGE_VERSION MATCHES "^([0-9]+).([0-9]+).([0-9]+).0$") message(FATAL_ERROR "PACKAGE_VERSION is invalid: '${PACKAGE_VERSION}'. Needs to match '([0-9]+).([0-9]+).([0-9]+).0' for official builds") endif() # Configure output directories set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin/${TARGET_PLATFORM}) set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/Debug) set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/Release) set_property(GLOBAL PROPERTY USE_FOLDERS ON) # Packaging variables set(BIN ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}) file(MAKE_DIRECTORY ${BIN}) set (GENERATED_DIR ${CMAKE_BINARY_DIR}/generated) file(MAKE_DIRECTORY ${GENERATED_DIR}) set(PACKAGE_CERTIFICATE ${GENERATED_DIR}/dev-cert.pfx) file(CREATE_LINK ${WSL_DEVICE_HOST_SOURCE_DIR}/bin/${TARGET_PLATFORM}/wsldevicehost.dll ${BIN}/wsldevicehost.dll) file(CREATE_LINK ${WSLG_SOURCE_DIR}/${TARGET_PLATFORM}/${WSLG_TS_PLUGIN_DLL} ${BIN}/${WSLG_TS_PLUGIN_DLL}) file(CREATE_LINK ${WSLDEPS_SOURCE_DIR}/bin/wsldeps.dll ${BIN}/wsldeps.dll) if (${SKIP_PACKAGE_SIGNING}) set(PACKAGE_SIGN_COMMAND echo Skipped package signing for:) else() if (NOT EXISTS ${PACKAGE_CERTIFICATE}) execute_process( COMMAND powershell.exe -ExecutionPolicy Bypass -NoProfile -NonInteractive ${CMAKE_CURRENT_LIST_DIR}/tools/create-dev-cert.ps1 -OutputPath ${PACKAGE_CERTIFICATE} COMMAND_ERROR_IS_FATAL ANY) endif() set(PACKAGE_SIGN_COMMAND SignTool.exe sign /a /v /fd SHA256 /f ${PACKAGE_CERTIFICATE}) endif() # Generate local test script configure_file(${CMAKE_CURRENT_LIST_DIR}/tools/test/test.bat.in ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/test.bat) # Common build flags set(CMAKE_CXX_STANDARD 20) if (${CMAKE_BUILD_TYPE} STREQUAL "Debug") set(CMAKE_MSVC_RUNTIME_LIBRARY MultiThreadedDebug) else() set(CMAKE_MSVC_RUNTIME_LIBRARY MultiThreaded) endif() if (${TARGET_PLATFORM} STREQUAL "x64") add_compile_definitions(_AMD64_) endif() if (${TARGET_PLATFORM} STREQUAL "arm64") add_compile_definitions(_ARM64_) endif() add_definitions(/sdl) # Default-initialize class members add_definitions(/FS) # Enable parallel PDB access add_compile_definitions(UNICODE WIL_SUPPRESS_PRIVATE_API_USE CPPWINRT_SUPPRESS_STATIC_INITIALIZERS NOMINMAX _CRT_SECURE_NO_WARNINGS KERNEL_VERSION="${KERNEL_VERSION}" WSLDEPS_VERSION="${WSLDEPS_VERSION}" WSLG_VERSION="${WSLG_VERSION}" WSLG_TS_PLUGIN_DLL=L"${WSLG_TS_PLUGIN_DLL}" WSL_DEVICE_HOST_VERSION="${WSL_DEVICE_HOST_VERSION}" COMMIT_HASH="${COMMIT_HASH}" WSL_PACKAGE_VERSION="${PACKAGE_VERSION}" MSRDC_VERSION="${MSRDC_VERSION}" DIRECT3D_VERSION="${DIRECT3D_VERSION}" DXCORE_VERSION="${DXCORE_VERSION}" WSL_PACKAGE_VERSION_MAJOR=${PACKAGE_VERSION_MAJOR} WSL_PACKAGE_VERSION_MINOR=${PACKAGE_VERSION_MINOR} WSL_PACKAGE_VERSION_REVISION=${PACKAGE_VERSION_REVISION} WSL_BUILD_WSL_SETTINGS=${WSL_BUILD_WSL_SETTINGS}) if (${OFFICIAL_BUILD}) add_compile_definitions(WSL_OFFICIAL_BUILD) endif() if (${WSL_BUILD_THIN_PACKAGE}) add_compile_definitions(WSL_DEV_THIN_MSI_PACKAGE="${BIN}/wsl.msi") endif () string(REPLACE "/Zi" "" CMAKE_CXX_FLAGS_DEBUG ${CMAKE_CXX_FLAGS_DEBUG}) # make sure /Zi is removed from the debug flags set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /bigobj /W3 /WX /ZH:SHA_256") set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} /Z7 -DDEBUG -DDBG") set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /Zi /guard:cf /Qspectre") # Linker flags set(CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE} /debug:full /debugtype:cv,fixup /guard:cf /DYNAMICBASE") set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /debug:full /debugtype:cv,fixup /guard:cf /DYNAMICBASE") if (${TARGET_PLATFORM} STREQUAL "x64") set(CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE} /CETCOMPAT") set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /CETCOMPAT") endif() # Common link libraries link_directories(${WSLDEPS_SOURCE_DIR}/lib/) set(COMMON_LINK_LIBRARIES ws2_32.lib Userenv.lib RuntimeObject.lib Pathcch.lib ntdll.lib RpcRT4.lib Mswsock.lib Shlwapi.lib synchronization.lib Bcrypt.lib icu.lib) set(MSI_LINK_LIBRARIES Wintrust.lib msi.lib) set(HCS_LINK_LIBRARIES computecore.lib computenetwork.lib Iphlpapi.lib) set(SERVICE_LINK_LIBRARIES MI.lib wsldeps.lib) # Linux if(${TARGET_PLATFORM} STREQUAL "" OR ${TARGET_PLATFORM} STREQUAL "x64") set(LLVM_ARCH x86_64) elseif(${TARGET_PLATFORM} STREQUAL "arm64") set(LLVM_ARCH aarch64) else() message(FATAL_ERROR "Unsupported platform: '${TARGET_PLATFORM}'") endif() # Determine the Visual Studio installation directory which contains LLVM tools. # Supported versions: VS2022 and VS2026. # Prefer VS2022 to keep local clang-format output aligned with pipeline expectations. function(find_vs_install_dir VERSION_RANGE OUTPUT_VAR) execute_process( COMMAND "${VSWHERE_SOURCE_DIR}/vswhere.exe" -version "${VERSION_RANGE}" -products * -requires Microsoft.VisualStudio.Component.VC.Llvm.Clang -property installationPath -prerelease -latest OUTPUT_VARIABLE _vs_install_dir OUTPUT_STRIP_TRAILING_WHITESPACE COMMAND_ERROR_IS_FATAL ANY ) set(${OUTPUT_VAR} "${_vs_install_dir}" PARENT_SCOPE) endfunction() find_vs_install_dir("[17.0,18.0)" VS_INSTALL_DIR) if (NOT VS_INSTALL_DIR) find_vs_install_dir("[18.0,19.0)" VS_INSTALL_DIR) if (VS_INSTALL_DIR) message(WARNING "Visual Studio 2022 was not found; using Visual Studio 2026 instead. clang-format output may differ from pipeline expectations.") endif() endif() if (NOT VS_INSTALL_DIR) message(FATAL_ERROR "Could not determine Visual Studio installation directory.") endif() if("${CMAKE_HOST_SYSTEM_PROCESSOR}" STREQUAL "AMD64") set(LLVM_INSTALL_DIR "${VS_INSTALL_DIR}/VC/Tools/Llvm/x64/bin") else() set(LLVM_INSTALL_DIR "${VS_INSTALL_DIR}/VC/Tools/Llvm/${CMAKE_HOST_SYSTEM_PROCESSOR}/bin") endif() if (NOT EXISTS ${LLVM_INSTALL_DIR}) message(FATAL_ERROR "C++ Clang Compiler for Windows is not installed at ${LLVM_INSTALL_DIR}. Please install it from the Visual Studio Installer.") endif() # Generate the clang-format script which contains a path to clang-format.exe configure_file(${CMAKE_CURRENT_LIST_DIR}/tools/FormatSource.ps1.in ${CMAKE_BINARY_DIR}/FormatSource.ps1) cmake_path(COMPARE "${wsl_SOURCE_DIR}" EQUAL "${wsl_BINARY_DIR}" BUILD_IN_SOURCE) if (NOT ${BUILD_IN_SOURCE}) # Testing on 3.26 project_type_DIR paths appear canonicalized file(CREATE_LINK ${LLVM_INSTALL_DIR}/clang-format.exe ${wsl_SOURCE_DIR}/tools/clang-format.exe COPY_ON_ERROR) endif() set(LINUXSDK_PATH ${LINUXSDK_SOURCE_DIR}/${LLVM_ARCH}) set(LLVM_TARGET "${LLVM_ARCH}-unknown-linux-musl") set(LINUX_CC ${LLVM_INSTALL_DIR}/clang.exe) set(LINUX_CXX ${LLVM_INSTALL_DIR}/clang++.exe) set(LINUX_AR ${LLVM_INSTALL_DIR}/llvm-ar.exe) set(LINUX_COMMON_FLAGS --gcc-toolchain=${LINUXSDK_PATH} -fpic -B${LINUXSDK_PATH} -isysroot ${LINUXSDK_PATH} -isystem ${LINUXSDK_PATH}/include/c++/v1 -isystem ${LINUXSDK_PATH}/include -isystem ${GSL_SOURCE_DIR}/include -isystem "${WSLDEPS_SOURCE_DIR}/include/lxcore" -isystem "${WSLDEPS_SOURCE_DIR}/include/schemas" -I "${CMAKE_CURRENT_LIST_DIR}/src/linux/inc" -I "${CMAKE_CURRENT_LIST_DIR}/src/linux/mountutil" -I "${CMAKE_CURRENT_LIST_DIR}/src/linux/plan9" -I "${CMAKE_CURRENT_LIST_DIR}/src/shared/configfile" -I "${CMAKE_CURRENT_LIST_DIR}/src/shared/inc" -I "${NLOHMAN_JSON_SOURCE_DIR}/include" -I "${CMAKE_BINARY_DIR}/generated" --no-standard-libraries -Werror -Wall -Wpointer-arith -D_POSIX_C_SOURCE=200809L -Dswprintf_s=swprintf -fms-extensions -target ${LLVM_TARGET} -D_GNU_SOURCE=1 -D_LARGEFILE64_SOURCE -DWSL_PACKAGE_VERSION="${PACKAGE_VERSION}" -DWSL_PACKAGE_VERSION_MAJOR=${PACKAGE_VERSION_MAJOR} -DWSL_PACKAGE_VERSION_MINOR=${PACKAGE_VERSION_MINOR} -DWSL_PACKAGE_VERSION_REVISION=${PACKAGE_VERSION_REVISION} ) if (${TARGET_PLATFORM} STREQUAL "x64") set(LINUX_COMMON_FLAGS ${LINUX_COMMON_FLAGS} -D_AMD64_) endif() if (${TARGET_PLATFORM} STREQUAL "arm64") set(LINUX_COMMON_FLAGS ${LINUX_COMMON_FLAGS} -D_ARM64_) endif() set(LINUX_CXXFLAGS ${LINUX_COMMON_FLAGS} -std=c++20) set(LINUX_CFLAGS ${LINUX_COMMON_FLAGS} -std=c99) string(TOLOWER ${CMAKE_BUILD_TYPE} build_type) if (build_type STREQUAL debug) set(LINUX_BUILD_TYPE_FLAGS -g3 -fno-inline-functions -DDEBUG -DDBG) else() set(LINUX_BUILD_TYPE_FLAGS -g -O2 -DNDEBUG) endif() set(LINUX_LDFLAGS -target ${LLVM_TARGET} --gcc-toolchain=${LINUXSDK_PATH} -B${LINUXSDK_PATH} -isysroot ${LINUXSDK_PATH} -nostartfiles --no-standard-libraries -fuse-ld=lld.exe -L${LINUXSDK_PATH}/lib -L${LINUXSDK_PATH}/lib/linux -L${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE} -lclang_rt.builtins-${LLVM_ARCH} -l:libc.a -static) set(COMMON_LINUX_LINK_LIBRARIES configfile) file(GLOB COMMON_LINUX_HEADERS CONFIGURE_DEPENDS "${CMAKE_CURRENT_LIST_DIR}/src/shared/inc/*.h") if(DEFINED ENV{WSL_DEV_BINARY_PATH}) set(WSL_DEV_BINARY_PATH $ENV{WSL_DEV_BINARY_PATH}) endif() if (DEFINED WSL_DEV_BINARY_PATH) # Development shortcut to make the package smaller add_compile_definitions(WSL_SYSTEM_DISTRO_PATH="${WSL_DEV_BINARY_PATH}/system.vhd" WSL_KERNEL_PATH="${WSL_DEV_BINARY_PATH}/kernel" WSL_KERNEL_MODULES_PATH="${WSL_DEV_BINARY_PATH}/modules.vhd" WSL_DEV_INSTALL_PATH="${WSL_DEV_BINARY_PATH}" WSL_GPU_LIB_PATH="${WSL_DEV_BINARY_PATH}/lib") endif() # Common include paths include_directories(${CMAKE_CURRENT_SOURCE_DIR}/wil/include) include_directories(${WSLDEPS_SOURCE_DIR}/include) include_directories(${WSLDEPS_SOURCE_DIR}/include/Windows) include_directories(${WSLDEPS_SOURCE_DIR}/include/schemas) include_directories(${WSLDEPS_SOURCE_DIR}/include/lxcore) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/src/shared/inc) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/src/windows/inc) include_directories(${CMAKE_CURRENT_BINARY_DIR}/src/windows/service/inc/${TARGET_PLATFORM}/${CMAKE_BUILD_TYPE}) include_directories(${CMAKE_CURRENT_BINARY_DIR}/src/windows/wslinstaller/inc/${TARGET_PLATFORM}/${CMAKE_BUILD_TYPE}) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/src/linux/init/inc) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/src/windows/common) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/src/shared/configfile) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/localization) include_directories(${CMAKE_BINARY_DIR}/generated) include_directories(${WIL_SOURCE_DIR}/include) include_directories(${GSL_SOURCE_DIR}/include) include_directories(${TAEF_SOURCE_DIR}/build/include) include_directories(${NLOHMAN_JSON_SOURCE_DIR}/include) link_directories(${TAEF_SOURCE_DIR}/build/Library/${TARGET_PLATFORM}) set(TAEF_LINK_LIBRARIES TE.Common.lib Wex.Common.lib Wex.Logger.lib) # Subprojects add_subdirectory(nuget) add_subdirectory(msixgluepackage) add_subdirectory(msipackage) add_subdirectory(msixinstaller) add_subdirectory(src/windows/common) add_subdirectory(src/windows/service) add_subdirectory(src/windows/wslinstaller/inc) add_subdirectory(src/windows/wslinstaller/stub) add_subdirectory(src/windows/wslinstaller/exe) add_subdirectory(src/shared/configfile) add_subdirectory(src/windows/wsl) add_subdirectory(src/windows/wslg) add_subdirectory(src/windows/wslhost) add_subdirectory(src/windows/wslrelay) add_subdirectory(src/windows/wslinstall) if (WSL_BUILD_WSL_SETTINGS) add_subdirectory(src/windows/libwsl) add_subdirectory(src/windows/wslsettings) endif() add_subdirectory(src/linux/netlinkutil) add_subdirectory(src/linux/mountutil) add_subdirectory(src/linux/plan9) add_subdirectory(src/linux/init) add_subdirectory(localization) add_subdirectory(test/windows) if (DEFINED PIPELINE_BUILD_ID) add_subdirectory(cloudtest) endif() if(DEFINED ENV{WSL_POST_BUILD_COMMAND}) set(WSL_POST_BUILD_COMMAND $ENV{WSL_POST_BUILD_COMMAND}) endif () ================================================ FILE: CODE_OF_CONDUCT.md ================================================ # Microsoft Open Source Code of Conduct This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). Resources: - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) - Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns ================================================ FILE: CONTRIBUTING.md ================================================ # WSL contributing guide There are a few main ways to contribute to WSL, with guides to each one: 1. [Add a feature or bugfix to WSL](#add-a-feature-or-bugfix-to-wsl) 2. [File a WSL issue](#file-a-wsl-issue) ## Add a feature or bugfix to WSL We welcome any contributions to the WSL source code to add features or fix bugs! Before you start actually working on the feature, please **[file it as an issue, or a feature request in this repository](https://github.com/microsoft/WSL/issues)** so that we can track it and provide any feedback if necessary. Once you have done so, please see [the developer docs](./doc/docs/dev-loop.md) for instructions on how to build WSL locally on your machine for development. When your fix is ready, please [submit it as a pull request in this repository](https://github.com/microsoft/WSL/pulls) and the WSL team will triage and respond to it. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. ## File a WSL issue You can file issues for WSL at the WSL repository, or linked repositories. Before filing an issue please search for any existing issues and upvote or comment on those if possible. 1. If your issue is related to WSL documentation, please file it at [microsoftdocs/wsl](https://github.com/microsoftdocs/WSL/issues) 2. If your issue is related to a Linux GUI app, please file it at [microsoft/wslg](https://github.com/microsoft/wslg/issues) 3. Otherwise, if you have a technical issue related to WSL in general, such as start up issues, etc., please file it at [microsoft/wsl](https://github.com/microsoft/WSL/issues) Please provide as much information as possible when reporting a bug or filing an issue on the Windows Subsystem for Linux, and be sure to include logs as necessary! Please see the [notes for collecting WSL logs](#notes-for-collecting-wsl-logs) section below for more info on filing issues. ## Thank you Thank you in advance for your contribution! We appreciate your help in making WSL a better tool for everyone. ## Notes for collecting WSL logs ### Important: Reporting BSODs and Security issues **Do not open GitHub issues for Windows crashes (BSODs) or security issues.** Instead, send Windows crashes or other security-related issues to secure@microsoft.com. See the `10) Reporting a Windows crash (BSOD)` section below for detailed instructions. ### Reporting issues in Windows Console or WSL text rendering/user experience Note that WSL distro's launch in the Windows Console (unless you have taken steps to launch a 3rd party console/terminal). Therefore, *please file UI/UX related issues in the [Windows Console issue tracker](https://github.com/microsoft/console)*. ### Collect WSL logs for networking issues Install iptables and tcpdump in your WSL distribution using the following commands. Note: This will not work if WSL has Internet connectivity issues. ``` # sudo apt-get update # sudo apt-get -y install iptables tcpdump ``` Install [WPR](https://learn.microsoft.com/windows-hardware/test/wpt/windows-performance-recorder) To collect WSL networking logs, do the following steps in an administrative powershell prompt: ``` Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\collect-wsl-logs.ps1 -LogProfile networking ``` The script will output when log collection starts. Reproduce the problem, then press any key to stop the log collection. The script will output the path of the log file once done. For additional network creation logs (restarts WSL), use: ``` .\collect-wsl-logs.ps1 -LogProfile networking -RestartWslReproMode ```
### Collect WSL logs (recommended method) If you choose to email these logs instead of attaching them to the bug, please send them to wsl-gh-logs@microsoft.com with the GitHub issue number in the subject, and include a link to your GitHub issue comment in the message body. To collect WSL logs, download and execute [collect-wsl-logs.ps1](https://github.com/Microsoft/WSL/blob/master/diagnostics/collect-wsl-logs.ps1) in an administrative powershell prompt: ``` Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\collect-wsl-logs.ps1 ``` The script will output the path of the log file once done. For specific scenarios, you can use different log profiles: - `.\collect-wsl-logs.ps1 -LogProfile storage` - Enhanced storage tracing - `.\collect-wsl-logs.ps1 -LogProfile networking` - Comprehensive networking tracing (includes packet capture, tcpdump, etc.) - `.\collect-wsl-logs.ps1 -LogProfile networking -RestartWslReproMode` - Networking tracing with WSL restart for network creation logs - `.\collect-wsl-logs.ps1 -LogProfile hvsocket` - HvSocket-specific tracing ### 10) Reporting a Windows crash (BSOD) To collect a kernel crash dump, first run the following command in an elevated command prompt: ``` reg.exe add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CrashControl /v AlwaysKeepMemoryDump /t REG_DWORD /d 1 /f ``` Then reproduce the issue, and let the machine crash and reboot. After reboot, the kernel dump will be in `%SystemRoot%\MEMORY.DMP` (unless this path has been overridden in the advanced system settings). Please send this dump to: secure@microsoft.com . Make sure that the email body contains: - The GitHub issue number, if any - That this dump is intended for the WSL team ### 11) Reporting a WSL process crash The easiest way to report a WSL process crash is by [collecting a user-mode crash dump](https://learn.microsoft.com/windows/win32/wer/collecting-user-mode-dumps). To collect dumps of all running WSL processes, please open a PowerShell prompt with admin privileges, navigate to a folder where you'd like to put your log files and run these commands: ``` Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force .\collect-wsl-logs.ps1 -Dump ``` The script will output the path to the log file when it is done. #### Enable automatic crash dump collection If your crash is sporadic or hard to reproduce, please enable automatic crash dumps to catch logs for this behavior: ``` md C:\crashes reg.exe add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" /f reg.exe add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" /v DumpFolder /t REG_EXPAND_SZ /d C:\crashes /f reg.exe add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" /v DumpType /t REG_DWORD /d 2 /f ``` Crash dumps will then automatically be written to C:\crashes. Once you're done, crash dump collection can be disabled by running the following command in an elevated command prompt: ``` reg.exe delete "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps" /f ``` ### 12) Collect wslservice time travel debugging traces To collect time travel debugging traces: 1) [Install WinDbg preview](https://apps.microsoft.com/store/detail/windbg-preview/9PGJGD53TN86?hl=en-us&gl=us&rtc=1) 2) Open WinDbg preview as administrator by running `windbgx` in an elevated command prompt 3) Navigate to `file` -> `Attach to process` 4) Check `Record with Time Travel Debugging` (at the bottom right) 4) Check `Show processes from all users` (at the bottom) 5) Select `wslservice.exe`. Note, if wslservice.exe is not running, you make it start it with: `wsl.exe -l` 6) Click `Configure and Record` (write down the folder you chose for the traces) 7) Reproduce the issue 8) Go back to WinDbg and click `Stop and Debug` 9) Once the trace is done collecting, click `Stop Debugging` and close WinDbg 10) Go to the folder where the trace was collected, and locate the .run file. It should look like: `wslservice*.run` 11) Share that file on the issue ================================================ FILE: DATA_AND_PRIVACY.md ================================================ # WSL data & privacy ## Overview WSL collects diagnostic data using Windows telemetry, just like other Windows components. You can disable this by opening Windows Settings, navigating to Privacy and Security -> Diagnostics & Feedback and disabling 'Diagnostic data'. You can also view all diagnostic data that you are sending in that menu using the 'View diagnostic data' option. For more information please read the [Microsoft privacy statement](https://www.microsoft.com/privacy/privacystatement). ## What does WSL collect? 1. Usage - Understanding what features and settings are most often used in WSL helps us make decisions on where to focus our time and energy. 2. Stability - Monitoring bugs and system crashes assists us in prioritizing the most urgent issues. 3. Performance - Assessing the performance of WSL gives us an understanding of what runtimes / components could be causing slow downs. This supports our commitment in providing you a speedy and effective WSL. You can search for WSL telemetry events by looking for calls to `WSL_LOG_TELEMETRY` in the source code of this repository. ================================================ FILE: Directory.Build.Props ================================================ true true true ================================================ FILE: LICENSE ================================================ MIT License Copyright (c) Microsoft Corporation. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE ================================================ FILE: NOTICE.txt ================================================ NOTICES AND INFORMATION Do Not Translate or Localize This software incorporates material from third parties. Microsoft makes certain open source code available at https://3rdpartysource.microsoft.com, or you may send a check or money order for US $5.00, including the product name, the open source component name, platform, and version number, to: Source Code Compliance Team Microsoft Corporation One Microsoft Way Redmond, WA 98052 USA Notwithstanding any other terms, you may reverse engineer this software to the extent required to debug changes to any libraries licensed under the GNU Lesser General Public License. --------------------------------------------------------- llvm/llvm-project d32170dbd5b0d54436537b6b75beaf44324e0c28 - Apache-2.0 WITH LLVM-exception (c) (tm) (c) Value A (c) auto AS (c) Value Sd (c) auto AST (c) CXType PT (c) Type I1Ty (c) Value RHS (c) X1 ... X1 (c) Type I32Ty (c) Value Elt0 Copyright 2014 (c) Type Int8Ty (c) Type V8x8Ty (c) Value FMSub (c) unsigned AS (c) Constant One (c) Type FloatTy (c) Type Int16Ty (c) Type Int32Ty (c) Type Int64Ty (c) Value AllocA (c) Value Alloca Alloc1 a1 (c) R1 Alloc1 a2 (c) R1 (c) FileID MainID (c) Lower C Upper (c) Stmt NumExprs (c) Type DoubleTy (c) Type I32PtrTy (c) Value AllocaA Coproc, Opc1, CRm (c) ConstantInt C2 (c) EUR CHECK-NEXT (c) Scale 1 Offset (c) State UNQUOTED (c) Type IndexType Copyright (c) 2012 Copyright (c) 2013 Copyright (c) 2019 Exprs new (c) Stmt (c) ExprResult NewE (c) Metadata Ops MD (c) SelectInst SelI (c) SmallVector MDs (c) TransferBatch B (c) Type Int32PtrTy (c) Type Int64PtrTy (c) BasicBlock Entry (c) CXXRecordDecl CD (c) FunctionType FTy (c) Offset C- Offset Copyright 2010 INRIA Copyright 2011 INRIA Copyright 2012 INRIA Copyright 2014 INRIA Copyright 2015 INRIA Copyright 2016 INRIA (c) FunctionType FnTy (c) QualType ResultTy (c) SourceRange Range AsmToks new (c) Token SubExprs new (c) Stmt (c) 2008 Red Hat, Inc. (c) 2011 Anthony Green (c) BasicBlock EntryBB (c) FunctionType FFnTy (c) FunctionType IFnTy (c) SourceLocation Loc Condition (c) Branches Context (c) LineToUnit Copyright (c) 2013 IBM (c) ErrMsg Stream Error (c) SmallVector NewVars (c) SmallVector ToErase Bbb kind copyright' Bbb (c) Constant PosDivisorC CommonPtr new (c) Common Copyright (c) 2012 CHECK (c) CharUnits AlignedSize (c) Constant NullV2I32Ptr (c) Constant PosDividendC Copyright 2010-2011 INRIA Copyright 2014-2015 INRIA COPYRIGHT,v 1.3 2003/06/02 Coproc, Opc1, Rt, Rt2, CRm Copyright 2003 Google Inc. Copyright 2008 Google Inc. Copyright 2009 Google Inc. Copyright 2015 Google Inc. Copyright 2018 Google Inc. Copyright The LLVM project coprime. APInt A HugePrime copyrighted by the author. (c) IdentifierInfo NumExprs (c) VectorType Int8PtrVecTy (c) Willem van Schaik, 1999 Copyright (c) 1997, Phillip Copyright 2005, Google Inc. Copyright 2006, Google Inc. Copyright 2007, Google Inc. Copyright 2008, Google Inc. Copyright 2012 Google, Inc. Copyright 2013, Google Inc. Copyright 2015, Google Inc. InitCache (c) TransferBatch copyright u'2015, LLVM Team Copyright 2006, Dean Edwards (c) CHECK-NEXT 194 CHECK-NEXT (c) CXXBaseSpecifier NumBases (c) Designator NumDesignators (c) StringLiteral NumClobbers Constraints new (c) StringRef Copyright (c) 2002 Bo Thorsen Copyright (c) 2010 Apple Inc. Copyright (c) by P.J. Plauger Copyright 2010 Zencoder, Inc. Copyright 2017 Roman Lebedev. ParamInfo new (c) ParmVarDecl Copyright (c) 2000 Software AG Copyright (c) 2002 Roger Sayle Copyright (c) 2008 David Daney Copyright (c) 2009 Google Inc. Copyright (c) 2016 Aaron Watry Copyright (c) 2017 Google Inc. Copyright (c) 2018 Jim Ingham. Copyright 2009 The Go Authors. Copyright 2010 The Go Authors. Copyright 2011 The Go Authors. Copyright 2012 The Go Authors. Copyright 2013 The Go Authors. Copyright 2014 The Go Authors. Copyright 2015 The Go Authors. (c) (3) educational corporation (c) CHECK-NEXT foo() CHECK-NEXT (copr0) ConstantDataVector CDV1 (copr1) ConstantDataVector CDV2 Copyright (c) 1994 X Consortium Copyright (c) 2008 Matteo Frigo Copyright (c) 2009 Matteo Frigo Copyright (c) 2010 CodeSourcery Copyright (c) 2011 Kyle Moffett Copyright (c) 2011 Tilera Corp. Copyright (c) 2011 Timothy Wall Copyright (c) 2012 Peter Harris Copyright (c) 2012 Tilera Corp. Copyright 2008-2010 Apple, Inc. Copyright 2015 Sven Verdoolaege Copyright 2016 Sven Verdoolaege Copyright 2017 Sven Verdoolaege Copyright 2018 Sven Verdoolaege Copyright, License, and Patents Other Coprocessor Instructions. (c) StringLiteral NumConstraints Copyright (c) 1996 Red Hat, Inc. Copyright (c) 2002 Ranjit Mathew Copyright (c) 2004 Anthony Green Copyright (c) 2004 Simon Posnjak Copyright (c) 2008 Anthony Green Copyright (c) 2008 Red Hat, Inc. Copyright (c) 2011 Anthony Green Copyright (c) 2012 Anthony Green Copyright (c) 2014 Red Hat, Inc. Copyright 2011 Sven Verdoolaege. (c) foo() pragma omp target teams Copyright (c) 1992 Henry Spencer. Copyright (c) 2000 John Hornkvist Copyright (c) 2001 John Hornkvist Copyright (c) 2006 Kirill Simonov Copyright (c) 2012 Alan Hourihane Copyright 2001-2004 Unicode, Inc. copyright u'2003- d, LLVM Project copyright u'2011- d, LLVM Project (c) CyclesSaved + LocalCyclesSaved Copyright (c) 1999-2007 Apple Inc. Copyright (c) 2009 The Go Authors. Copyright (c) 2009-2019 Polly Team Copyright (c) 2012 Thorsten Glaser Copyright (c) 2013 Tensilica, Inc. Copyright 2012 Universiteit Leiden Copyright 2016-2017 Tobias Grosser copyright u'2007- d, The LLDB Team copyright u'2013- d, Analyzer Team Constraint new (c) AtomicConstraint Copyright (c) 1998 Cygnus Solutions Copyright (c) 1998 Geoffrey Keating Copyright (c) 2001 David E. O'Brien Copyright (c) 2013 Mentor Graphics. Copyright (c) 2015the LLVM Project. Copyright 2009-2010 The Go Authors. copyright u'2007- d, The Clang Team copyright u'2010- d, The Polly Team copyright u'2011-2018, LLVM Project Copyright (C ) Microsoft Corporation Copyright (c) 2000, 2007 Software AG Copyright (c) 2001 Alexander Peslyak Copyright (c) 2012, 2013 Xilinx, Inc Copyright (c) 2014, 2015 Google Inc. Copyright (c) 2019 The MLIR Authors. Copyright (c) Microsoft Corporation. Copyright 2009, 2010 The Go Authors. Copyright 2015-2016 Sven Verdoolaege Copyright 2016, 2017 Tobias Grosser. Copyright 2016-2017 Sven Verdoolaege (c) PointerType InitPtrType InitValue Copyright (c) 1996-2003 Red Hat, Inc. Copyright (c) 1996-2004 Red Hat, Inc. Copyright (c) 1999-2003 Steve Purcell Copyright (c) 2012-2016, Yann Collet. Copyright 2011,2015 Sven Verdoolaege. Copyright (c) 1996, 1998 Red Hat, Inc. Copyright (c) 1998, 2008 Red Hat, Inc. Copyright (c) 1999, 2008 Red Hat, Inc. Copyright (c) 2004 Renesas Technology. Copyright (c) 2008 Christian Haggstrom Copyright (c) 2008, 2010 Red Hat, Inc. Copyright (c) 2011, 2012 Anthony Green Copyright (c) 2011, 2013 Anthony Green Copyright (c) 2011, 2014 Anthony Green Copyright (c) 2012, 2013 Anthony Green Copyright (c) 2012, 2014 Anthony Green Copyright 2007-2010 by the Sphinx team (c) 2006 Free Software Foundation, Inc. (c) CHECK-NEXT T break CHECK-NEXT Preds Copyright (c) 1998, 2012 Andreas Schwab Copyright (c) 2002-2004 Tim J. Robbins. Copyright (c) 2005 Free Standards Group Copyright 2005-2007 Universiteit Leiden Copyright 2006-2007 Universiteit Leiden Copyright 2012 Ecole Normale Superieure Copyright 2013 Ecole Normale Superieure Copyright 2014 Ecole Normale Superieure Copyright 2016 Ismael Jimenez Martinez. Portions Copyright 2009 The Go Authors. in LLVM, Diploma Thesis, (c) April 2011 (c) StringRef NumClobbers // FIXME Avoid Copyright (c) 1996-1998 John D. Polstra. Copyright (c) 2002-2008, 2012 Kaz Kojima Copyright (c) 1997-2019 Intel Corporation Copyright (c) 2005 Axis Communications AB Copyright (c) 2010-2015 Benjamin Peterson Copyright 1992, 1993, 1994 Henry Spencer. coproc_option_imm Operand let PrintMethod (c) CXXCtorInitializer NumIvarInitializers Copyright (c) 2000 Hewlett Packard Company Copyright (c) 2002 Bo Thorsen Copyright (c) 1996-2003, 2010 Red Hat, Inc. Copyright (c) 2004 eXtensible Systems, Inc. Copyright (c) 2009-2014 by the contributors Copyright (c) 2009-2015 by the contributors Copyright (c) 2009-2016 by the contributors Copyright (c) 2009-2019 by the contributors Copyright (c) 2011 Free Software Foundation Copyright (c) 2011-2014 by the contributors Copyright (c) 2011-2019 by the contributors Copyright (c) 2013 Imagination Technologies Copyright (c) 2017-2019 by the contributors (c) CHECK-NEXT Preds (1) B4 CHECK-NEXT Succs (c) CHECK-NEXT Preds (1) B5 CHECK-NEXT Succs (c) CHECK-NEXT Preds (1) B7 CHECK-NEXT Succs CoprocNumAsmOperand AsmOperandClass let Name CoprocRegAsmOperand AsmOperandClass let Name Copyright (c) 1993 by Sun Microsystems, Inc. Copyright (c) 1996, 1998, 2005 Red Hat, Inc. Copyright (c) 1996, 1998, 2007 Red Hat, Inc. Copyright (c) 1998, 2008, 2011 Red Hat, Inc. Copyright (c) 1999, 2007, 2008 Red Hat, Inc. Copyright (c) 2004 by Sun Microsystems, Inc. Copyright (c) 2007, 2009, 2010 Red Hat, Inc. Copyright (c) 2011, 2012, 2013 Anthony Green Copyright 2012,2014 Ecole Normale Superieure Copyright 2012-2013 Ecole Normale Superieure Copyright 2012-2014 Ecole Normale Superieure Copyright 2013-2014 Ecole Normale Superieure Copyright (c) 1992, 1993, 1994 Henry Spencer. Copyright (c) 2002-2007 Michael J. Fromberger Copyright (c) 2009, 2010, 2011, 2012 ARM Ltd. Copyright (c) 2012, 2013 Anthony Green Target Copyright 2000 Free Software Foundation, Inc. Copyright 2004 Free Software Foundation, Inc. Copyright (c) 2008 Ryan McCabe (c) 2003-2004 Randolph Chung CoprocOptionAsmOperand AsmOperandClass let Name Copyright (c) 2003, 2004, 2006, 2008 Kaz Kojima Copyright (c) 2014 Advanced Micro Devices, Inc. Copyright (c) 2015 Advanced Micro Devices, Inc. Copyright (c) 1994-1999 Lucent Technologies Inc. Copyright (c) 2002, 2007 Bo Thorsen Copyright (c) 2013 Imagination Technologies Ltd. (c) Designator NumDesigs NumDesignators NumDesigs Copyright (c) 1992, 1993 UNIX International, Inc. Copyright (c) 1996-2003, 2007, 2008 Red Hat, Inc. Copyright (c) 2004 Free Software Foundation, Inc. Copyright (c) 2006 Free Software Foundation, Inc. Copyright (c) 2007 Free Software Foundation, Inc. Copyright (c) 2008 Free Software Foundation, Inc. Copyright (c) 2009 Free Software Foundation, Inc. Copyright (c) 2011 Free Software Foundation, Inc. Copyright (c) 2012 Free Software Foundation, Inc. Copyright (c) 2012, Noah Spurrier Copyright (c) 2013-2014, Pexpect development team Copyright (c) 2013-2016, Pexpect development team Copyright (c) 2014 Free Software Foundation, Inc. Copyright (c) 2015 Paul Norman Copyright (c) 2016 Aaron Watry Copyright extcopyright~ he year the LLVM Project. (c) CHECK-NEXT Preds (3) B3 B4 B2 CHECK-NEXT Succs (c) CHECK-NEXT Preds (3) B3 B5 B6 CHECK-NEXT Succs Copyright (c) 1996, 2007, 2008, 2011 Red Hat, Inc. Copyright (c) 1998, 2001, 2007, 2008 Red Hat, Inc. Copyright (c) 1998, 2007, 2008, 2012 Red Hat, Inc. Copyright (c) 2000, 2003, 2004, 2008 Red Hat, Inc. Copyright (c) 2003-2010 Python Software Foundation Copyright (c) 2012 Zack Weinberg Copyright 1992-2018 Free Software Foundation, Inc. Copyright 2008-2009 Katholieke Universiteit Leuven (c) Stmt NumExprs std::copy Exprs, Exprs + NumExprs Copyright (c) 1996, MPEG Software Simulation Group. Copyright (c) 2003 Jakub Jelinek Copyright (c) 2008 Guido U. Draheim Copyright (c) 2008 Stepan Kasal Copyright (c) 2011 Plausible Labs Cooperative, Inc. Copyright (c) 2012 Qualcomm Innovation Center, Inc. Copyright (c) 2008 Benjamin Kosnik Copyright (c) 2013 Synopsys, Inc. (www.synopsys.com) Copyright (c) 2013 Synposys, Inc. (www.synopsys.com) Copyright (c) 2014,2015 Advanced Micro Devices, Inc. Copyright (c) 2002, 2003, 2004, 2006, 2008 Kaz Kojima Copyright (c) 2003, 2004, 2006, 2007, 2012 Kaz Kojima Copyright (c) 2013 Miodrag Vallat. Copyright (c) 2014, 2015 Advanced Micro Devices, Inc. Copyright (c) 2016 Krzesimir Nowak Copyright (c) 1994-2014 Free Software Foundation, Inc. Copyright (c) 1994-2017 Free Software Foundation, Inc. Copyright (c) 1996, 2003-2004, 2007-2008 Red Hat, Inc. Copyright (c) 1996-2014 Free Software Foundation, Inc. Copyright (c) 1996-2015 Free Software Foundation, Inc. Copyright (c) 1996-2017 Free Software Foundation, Inc. Copyright (c) 1997-2014 Free Software Foundation, Inc. Copyright (c) 1997-2017 Free Software Foundation, Inc. Copyright (c) 1999-2013 Free Software Foundation, Inc. Copyright (c) 1999-2014 Free Software Foundation, Inc. Copyright (c) 1999-2017 Free Software Foundation, Inc. Copyright (c) 2001-2014 Free Software Foundation, Inc. Copyright (c) 2001-2017 Free Software Foundation, Inc. Copyright (c) 2002-2014 Free Software Foundation, Inc. Copyright (c) 2002-2017 Free Software Foundation, Inc. Copyright (c) 2003-2014 Free Software Foundation, Inc. Copyright (c) 2003-2017 Free Software Foundation, Inc. Copyright (c) 2004-2014 Free Software Foundation, Inc. Copyright (c) 2004-2015 Free Software Foundation, Inc. Copyright (c) 2004-2017 Free Software Foundation, Inc. Copyright (c) 2006-2014 Free Software Foundation, Inc. Copyright (c) 2006-2017 Free Software Foundation, Inc. Copyright (c) 2007, 2008 Free Software Foundation, Inc Copyright (c) 2008 Sven Verdoolaege Copyright (c) 2009-2014 Free Software Foundation, Inc. Copyright (c) 2009-2017 Free Software Foundation, Inc. Copyright (c) 2010-2015 Free Software Foundation, Inc. Copyright (c) 2010-2017 Free Software Foundation, Inc. Copyright (c) 2011-2013 Free Software Foundation, Inc. Copyright (c) 2011-2014 Free Software Foundation, Inc. Copyright (c) 2012-2014 Free Software Foundation, Inc. Copyright (c) 2012-2015 Free Software Foundation, Inc. Copyright (c) 2013-2014 Free Software Foundation, Inc. Copyright (c) 2013-2015 Free Software Foundation, Inc. Copyright (c) 2002, 2009 Free Software Foundation, Inc. Copyright (c) 2004, 2005 Free Software Foundation, Inc. Copyright (c) 2004, 2010 Free Software Foundation, Inc. Copyright (c) 2006, 2008 Free Software Foundation, Inc. Copyright (c) 2008, 2010 Free Software Foundation, Inc. Copyright (c) 2014 Sebastian Macke Copyright (c) 2015 Moritz Klammler Copyright (c) 1996, 1997, 2003, 2004, 2008 Red Hat, Inc. Copyright (c) 1998, 2001, 2007, 2008, 2011, 2014 Red Hat Copyright (c) 2009 Bradley Smith Copyright (c) 2013 Jesse Towner Copyright (c) 2013 Roy Stogner (c) Type AtExitFuncArgs VoidStar FunctionType AtExitFuncTy copyright (c) 1991-2011, Thomas G. Lane, Guido Vollbeding. (c) GlobalVariable Handle new GlobalVariable M, DsoHandleTy (c) Type ArgTys Int32Ty, Int32Ty, Int32Ty FunctionType FnTy Copyright (c) 2004 Scott James Remnant Copyright (c) 2008 Steven G. Johnson Copyright (c) 2009 Steven G. Johnson Copyright (c) 2004, 2011-2015 Free Software Foundation, Inc. Copyright (c) 2007, 2008, 2010 Free Software Foundation, Inc Copyright (c) 2007, 2009, 2010 Free Software Foundation, Inc Copyright (c) 2013 Victor Oliveira Copyright 1984, 1987, 1989, 1992, 2000 by Stephen L. Moshier (c) DeclRefExpr DR M.makeDeclRefExpr(PV) ImplicitCastExpr ICE (c) IdentifierInfo NumExprs std::copy Names, Names + NumExprs Copyright (c) 1998 Todd C. Miller Copyright (c) 2001, 2003, 2005 Free Software Foundation, Inc. Copyright (c) 2002, 2003, 2009 Free Software Foundation, Inc. Copyright (c) 2004, 2005, 2012 Free Software Foundation, Inc. Copyright (c) 2006, 2008, 2010 Free Software Foundation, Inc. (c) BranchInst BI BranchInst::Create(Exit, Exit, False, Entry) Copyright (c) 1996, 1998, 1999, 2001, 2007, 2008 Red Hat, Inc. Copyright (c) 1996, 1998, 2001, 2002, 2003, 2005 Red Hat, Inc. Copyright (c) 1996, 1998, 2005, 2007, 2009, 2010 Red Hat, Inc. Copyright (c) 1996,1998,2001-2003,2005,2008,2010 Red Hat, Inc. Copyright (c) 1994 The Regents of the University of California. Copyright (c) 1996-2014 Anthony Green, Red Hat, Inc and others. Copyright (c) 1992-1996, 1998-2012 Free Software Foundation, Inc. Copyright (c) 1996-2001, 2003-2015 Free Software Foundation, Inc. Copyright (c) 2001, 2003, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 2001, 2003, 2005, 2011 Free Software Foundation, Inc. Copyright (c) 2003, 2004, 2005, 2006 Free Software Foundation, Inc. Copyright (c) 2003-2019 University of Illinois at Urbana-Champaign. Copyright (c) 2004, 2005, 2007, 2008 Free Software Foundation, Inc. Copyright (c) 2004, 2005, 2007, 2009 Free Software Foundation, Inc. Copyright (c) 2007-2018 University of Illinois at Urbana-Champaign. Copyright (c) 2007-2019 University of Illinois at Urbana-Champaign. Copyright (c) 2002, 2003, 2004, 2010, Free Software Foundation, Inc. Copyright (c) 2006-2009 Steven J. Bethard Copyright (c) 1992, 1993 The Regents of the University of California. (c) StringLiteral NumClobbers std::copy Clobbers, Clobbers + NumClobbers Copyright (c) 2000-2007 Vita Nuova Holdings Limited (www.vitanuova.com). Copyright (c) 2001, 2002, 2003, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 2001, 2002, 2003, 2005, 2009 Free Software Foundation, Inc. Copyright (c) 2001, 2003, 2004, 2005, 2006 Free Software Foundation, Inc. Copyright (c) 2001, 2003, 2005, 2008, 2011 Free Software Foundation, Inc. Copyright (c) 2002, 2006, 2007, 2009, 2010 Free Software Foundation, Inc. Copyright (c) 2003, 2004, 2005, 2006, 2011 Free Software Foundation, Inc. Copyright (c) 2004, 2005, 2007, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1992, 1993, 1994 The Regents of the University of California. Copyright (c) 2004-2005, 2007-2008, 2011-2015 Free Software Foundation, Inc. Copyright (c) 2004-2005, 2007-2009, 2011-2015 Free Software Foundation, Inc. Copyright (c) 2004-2005, 2007, 2009, 2011-2015 Free Software Foundation, Inc. Copyright (c) 2012 Alexandre K. I. de Mendonca Copyright (c) 2001, 2002, 2003, 2005, 2008, 2010 Free Software Foundation, Inc. Copyright (c) 2002, 2003, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. (c) StringLiteral NumConstraints std::copy Constraints, Constraints + NumConstraints Copyright (c) 1996, 1997, 2000, 2001, 2003, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 1999, 2000, 2001, 2003, 2004, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 2002, 2003, 2005, 2006, 2007, 2008, 2011 Free Software Foundation, Inc. Copyright (c) 1995, 1996, 1997, 2003, 2004, 2005, 2007, 2009 Free Software Foundation, Inc. Copyright (c) 1997, 1999, 2000, 2001, 2003, 2004, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 1997, 2000, 2001, 2003, 2004, 2005, 2006, 2008 Free Software Foundation, Inc. Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 1996, 1998, 2000, 2001, 2002, 2003, 2004, 2005, 2008 Free Software Foundation, Inc. Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2009 Free Software Foundation, Inc. Copyright (c) 1996, 1998, 2000, 2001, 2002, 2003, 2004, 2005, 2008, 2011 Free Software Foundation, Inc. Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2009, 2010, 2011 Free Software Foundation, Inc. Copyright (c) 1999, 2000, 2003, 2004, 2005, 2006, 2007, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. Copyright (c) 2012 Alexandre K. I. de Mendonca , Paulo Pizarro Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1996, 1997, 1999, 2000, 2002, 2003, 2004, 2005, 2006, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc. Copyright (c) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1995, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2011, 2014 Free Software Foundation, Inc. Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc. Copyright (c) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Copyright (c) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc. Copyright (c) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc. Copyright (c) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc. Apache-2.0 WITH LLVM-exception --------------------------------------------------------- --------------------------------------------------------- CommunityToolkit.Mvvm 8.4.0 - MIT Copyright (c) 2021 Sergio Pedri Copyright (c) 2020 Michael Dietrich Copyright (c) Microsoft Corporation (c) .NET Foundation and Contributors Copyright (c) 2009 - 2018 Laurent Bugnion Copyright (c) .NET Foundation and Contributors Copyright (c) 2017 Pedro Lamas, http://www.pedrolamas.com # .NET Community Toolkit Copyright © .NET Foundation and Contributors All rights reserved. ## MIT License (MIT) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- CommunityToolkit.WinUI.Animations 8.2.250402 - MIT (c) .NET Foundation and Contributors Copyright (c) .NET Foundation and Contributors # Windows Community Toolkit Copyright © .NET Foundation and Contributors All rights reserved. ## MIT License (MIT) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- CommunityToolkit.WinUI.Controls.SettingsControls 8.2.250402 - MIT (c) .NET Foundation and Contributors Copyright (c) .NET Foundation and Contributors # Windows Community Toolkit Copyright © .NET Foundation and Contributors All rights reserved. ## MIT License (MIT) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- Microsoft.Extensions.Hosting 10.0.0 - MIT Copyright (c) 2021 Copyright (c) Six Labors (c) Microsoft Corporation Copyright (c) 2022 FormatJS Copyright (c) Andrew Arnott Copyright 2019 LLVM Project Copyright (c) 1998 Microsoft Copyright 2018 Daniel Lemire Copyright (c) .NET Foundation Copyright (c) 2011, Google Inc. Copyright (c) 2020 Dan Shechter (c) 1997-2005 Sean Eron Anderson Copyright (c) 2015 Andrew Gallant Copyright (c) 2022, Wojciech Mula Copyright (c) 2017 Yoshifumi Kawai Copyright (c) 2022, Geoff Langdale Copyright (c) 2005-2020 Rich Felker Copyright (c) 2012-2021 Yann Collet Copyright (c) Microsoft Corporation Copyright (c) 2007 James Newton-King Copyright (c) 1991-2024 Unicode, Inc. Copyright (c) 2013-2017, Alfred Klomp Copyright (c) 2018 Nemanja Mijailovic Copyright 2012 the V8 project authors Copyright (c) 1999 Lucent Technologies Copyright (c) 2008-2016, Wojciech Mula Copyright (c) 2011-2020 Microsoft Corp Copyright (c) 2015-2017, Wojciech Mula Copyright (c) 2015-2018, Wojciech Mula Copyright (c) 2005-2007, Nick Galbreath Copyright (c) 2015 The Chromium Authors Copyright (c) 2018 Alexander Chermyanin Copyright (c) The Internet Society 1997 Copyright (c) 2004-2006 Intel Corporation Copyright (c) 2011-2015 Intel Corporation Copyright (c) 2013-2017, Milosz Krajewski Copyright (c) 2016-2017, Matthieu Darbois Copyright (c) The Internet Society (2003) Copyright (c) .NET Foundation Contributors (c) 1995-2024 Jean-loup Gailly and Mark Adler Copyright (c) 2020 Mara Bos Copyright (c) 2012 - present, Victor Zverovich Copyright (c) 2006 Jb Evain (jbevain@gmail.com) Copyright (c) 2008-2020 Advanced Micro Devices, Inc. Copyright (c) 2019 Microsoft Corporation, Daan Leijen Copyright (c) 2011 Novell, Inc (http://www.novell.com) Copyright (c) 2015 Xamarin, Inc (http://www.xamarin.com) Copyright (c) 2009, 2010, 2013-2016 by the Brotli Authors Copyright (c) 2014 Ryan Juckett http://www.ryanjuckett.com Copyright (c) 1990- 1993, 1996 Open Software Foundation, Inc. Portions (c) International Organization for Standardization 1986 Copyright (c) YEAR W3C(r) (MIT, ERCIM, Keio, Beihang) Disclaimers Copyright (c) 2015 THL A29 Limited, a Tencent company, and Milo Yip Copyright (c) 1980, 1986, 1993 The Regents of the University of California Copyright 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 The Regents of the University of California Copyright (c) 1989 by Hewlett-Packard Company, Palo Alto, Ca. & Digital Equipment Corporation, Maynard, Mass MIT License Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- Microsoft.Xaml.Behaviors.WinUI.Managed 3.0.0 - MIT (c) Microsoft Corporation MIT License Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- microsoft/gsl 0f6dbc9e2915ef5c16830f3fa3565738de2a9230 - MIT Copyright 2008, Google Inc. Copyright (c) 2015 Microsoft Corporation. Copyright (c) 2015 Microsoft Corporation. All rights reserved. This code is licensed under the MIT License (MIT). Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- vswhere 3.1.7 - MIT (c) 2023 GitHub, Inc. (c) Microsoft Corporation Copyright (c) by P.J. Plauger Copyright (c) Microsoft Corporation MIT License Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- WinUIEx 2.9.0 - MIT Copyright (c) Microsoft Corporation Copyright 2021-2025 - Morten Nielsen Copyright 2021-2025 - Morten Nielsen A Copyright (c) 2021-2025 - Morten Nielsen MIT License Copyright (c) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --------------------------------------------------------- --------------------------------------------------------- wix 5.0.2 - MS-RL Copyright James Newton-King 2008 Copyright UpdateUrl DisableModify Copyright (c) Microsoft Corporation (c) .NET Foundation and contributors Copyright James Newton-King 2008 Json.NET Copyright AssemblyDescription AssemblyProduct Copyright (c) .NET Foundation and contributors Microsoft Reciprocal License (Ms-RL) This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software. 1. Definitions The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law. A "contribution" is the original software, or any additions or changes to the software. A "contributor" is any person that distributes its contribution under this license. "Licensed patents" are a contributor's patent claims that read directly on its contribution. 2. Grant of Rights (A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create. (B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software. 3. Conditions and Limitations (A) Reciprocal Grants- For any file you distribute that contains code from the software (in source code or binary format), you must provide recipients the source code to that file along with a copy of this license, which license will govern that file. You may license other files that are entirely your own work and do not contain code from the software under any terms you choose. (B) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks. (C) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically. (D) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software. (E) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license. (F) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees, or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement. --------------------------------------------------------- ================================================ FILE: README.md ================================================ # Welcome to the Windows Subsystem for Linux (WSL) repository

WSL logo

[Learn more about WSL](https://aka.ms/wsldocs) | [Downloads & Release notes](https://github.com/microsoft/WSL/releases) | [Contributing to WSL](./CONTRIBUTING.md) ## About Windows Subsystem for Linux (WSL) is a powerful way for you to run your Linux command-line tools, utilities and applications, all unmodified and directly on Windows without the overhead of a traditional virtual machine or dual boot setup. You can install WSL right away by running this command inside of your Windows command line: ```powershell wsl --install ``` You can learn more about [best practices for setup](https://learn.microsoft.com/windows/wsl/setup/environment), [overviews of WSL](https://learn.microsoft.com/windows/wsl/about) and more at our [WSL documentation page](https://learn.microsoft.com/windows/wsl/). ## Related repositories WSL also has related open source repositories: - [microsoft/WSL2-Linux-Kernel](https://github.com/microsoft/WSL2-Linux-Kernel) - The Linux kernel shipped with WSL - [microsoft/WSLg](https://github.com/microsoft/wslg) - Support for Linux GUI apps in WSL - [microsoftdocs/wsl](https://github.com/microsoftdocs/wsl) - WSL documentation at aka.ms/wsldocs ## Contributing This project welcomes contributions of all types, including coding features / bug fixes, documentation fixes, design proposals and more. We ask that before you start working on a contribution, please read our [Contributor's Guide](./CONTRIBUTING.md). For guidance on developing for WSL, please read the [developer docs](./doc/docs/dev-loop.md) for instructions on how to build WSL from source and details on its architecture. ## Code of Conduct This project has adopted the [Microsoft Open Source Code of Conduct](./CODE_OF_CONDUCT.md) ## Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies. ## Privacy and telemetry The application logs basic diagnostic data (telemetry). For more information on privacy and what we collect, see our [data and privacy documentation](DATA_AND_PRIVACY.md). The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices. ================================================ FILE: SECURITY.md ================================================ ## Security Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below. ## Reporting Security Issues **Please do not report security vulnerabilities through public GitHub issues.** Instead, please [report them to the Microsoft Security Response Center (MSRC)](https://aka.ms/opensource/security/create-report). If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey). You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [Microsoft Security Response Center](https://aka.ms/opensource/security/msrc). Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue: * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) * Full paths of source file(s) related to the manifestation of the issue * The location of the affected source code (tag/branch/commit or direct URL) * Any special configuration required to reproduce the issue * Step-by-step instructions to reproduce the issue * Proof-of-concept or exploit code (if possible) * Impact of the issue, including how an attacker might exploit the issue This information will help us triage your report more quickly. If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs. ## Preferred Languages We prefer all communications to be in English. ## Policy Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd). ================================================ FILE: SUPPORT.md ================================================ # Support ## How to file issues and get help This project uses [GitHub Issues][gh-issue] to [track bugs][gh-bug] and [feature requests][gh-feature]. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug or feature request as a new Issue. For general information on the Windows Subsystem for Linux, including help, tutorials, how-tos and reference guides, please view our [WSL documentation](https://docs.microsoft.com/windows/wsl/). ## Microsoft Support Policy Technical Support for the use of WSL may also be available from Microsoft’s Customer Support Services (CSS). If you are a Premier or Unified Support customer, you may reach out to your account manager for further assistance. Otherwise, you may visit Microsoft’s [Support For Business site](https://support.serviceshub.microsoft.com/supportforbusiness/create) to [open a new support case for WSL](https://support.serviceshub.microsoft.com/supportforbusiness/create?sapid=9d5af292-506b-63ca-cb2c-7f4eaa380c56). [gh-issue]: https://github.com/microsoft/WSL/issues/new/choose [gh-bug]: https://github.com/microsoft/WSL/issues/new?assignees=&labels=&template=bug_report.md&title= [gh-feature]: https://github.com/microsoft/WSL/issues/new?assignees=&labels=feature&template=feature_request.md&title= ================================================ FILE: UserConfig.cmake.sample ================================================ # Sample user configuration message(STATUS "Loading user configuration") # Uncomment to enable development packages (smaller, faster to install) # # Note: .vhd files fail to mount via symlink / hardlink, so COPY is needed. # set(WSL_DEV_BINARY_PATH "C:/wsldev") if(WSL_DEV_BINARY_PATH) file(MAKE_DIRECTORY ${WSL_DEV_BINARY_PATH}) file(CREATE_LINK "${KERNEL_SOURCE_DIR}/bin/${TARGET_PLATFORM}/kernel" "${WSL_DEV_BINARY_PATH}/kernel" SYMBOLIC) file(COPY_FILE "${WSLG_SOURCE_DIR}/${TARGET_PLATFORM}/system.vhd" "${WSL_DEV_BINARY_PATH}/system.vhd" ONLY_IF_DIFFERENT) file(COPY_FILE "${KERNEL_SOURCE_DIR}/bin/${TARGET_PLATFORM}/modules.vhd" "${WSL_DEV_BINARY_PATH}/modules.vhd" ONLY_IF_DIFFERENT) # read-only VHDs need to be world readable to mount successfully. execute_process( COMMAND icacls.exe "${WSL_DEV_BINARY_PATH}/system.vhd" "/grant:r" "Everyone:(R)" /Q COMMAND icacls.exe "${WSL_DEV_BINARY_PATH}/modules.vhd" "/grant:r" "Everyone:(R)" /Q WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR} COMMAND_ERROR_IS_FATAL ANY) file(CREATE_LINK "${MSRDC_SOURCE_DIR}/${TARGET_PLATFORM}/msrdc.exe" "${WSL_DEV_BINARY_PATH}/msrdc.exe" SYMBOLIC) file(CREATE_LINK "${WSLG_SOURCE_DIR}/wslg.rdp" "${WSL_DEV_BINARY_PATH}/wslg.rdp" SYMBOLIC) file(CREATE_LINK "${WSLG_SOURCE_DIR}/wslg_desktop.rdp" "${WSL_DEV_BINARY_PATH}/wslg_desktop.rdp" SYMBOLIC) file(CREATE_LINK "${MSRDC_SOURCE_DIR}/${TARGET_PLATFORM}/rdclientax.dll" "${WSL_DEV_BINARY_PATH}/rdclientax.dll" SYMBOLIC) file(CREATE_LINK "${MSRDC_SOURCE_DIR}/${TARGET_PLATFORM}/rdpnanoTransport.dll" "${WSL_DEV_BINARY_PATH}/rdpnanoTransport.dll" SYMBOLIC) file(CREATE_LINK "${MSRDC_SOURCE_DIR}/${TARGET_PLATFORM}/RdpWinStlHelper.dll" "${WSL_DEV_BINARY_PATH}/RdpWinStlHelper.dll" SYMBOLIC) file(CREATE_LINK "${MSAL_SOURCE_DIR}/${TARGET_PLATFORM}/msal.wsl.proxy.exe" "${WSL_DEV_BINARY_PATH}/msal.wsl.proxy.exe" SYMBOLIC) file(CREATE_LINK "${DIRECT3D_SOURCE_DIR}/lib/${TARGET_PLATFORM}" "${WSL_DEV_BINARY_PATH}/lib" SYMBOLIC) foreach(LANG ${SUPPORTED_LANGS}) file(CREATE_LINK "${MSRDC_SOURCE_DIR}/${TARGET_PLATFORM}/${LANG}" "${WSL_DEV_BINARY_PATH}/${LANG}" SYMBOLIC) endforeach() endif() # # Uncomment to skip building, packaging and installing wslsettings # set(WSL_BUILD_WSL_SETTINGS false) # # Uncomment to generate a "thin" MSI package which builds and installs faster # set(WSL_BUILD_THIN_PACKAGE true) # # Uncomment to install the package as part of the build # set(WSL_POST_BUILD_COMMAND "powershell;-ExecutionPolicy;Bypass;-NoProfile;-NonInteractive;./tools/deploy/deploy-to-host.ps1") # # Uncomment to reduce the verbosity of the appx package build # set(WSL_SILENT_APPX_BUILD true) ================================================ FILE: cgmanifest.json ================================================ { "version": 1, "$schema": "https://json.schemastore.org/component-detection-manifest.json", "registrations": [ { "component": { "type": "git", "git": { "repositoryUrl": "https://github.com/microsoft/GSL", "commitHash": "0f6dbc9e2915ef5c16830f3fa3565738de2a9230" } } }, { "component": { "type": "git", "git": { "repositoryUrl": "https://github.com/llvm/llvm-project", "commitHash": "d32170dbd5b0d54436537b6b75beaf44324e0c28" } } }, { "component": { "type": "other", "other": { "name": "libarchive", "version": "3.7.7", "downloadUrl": "https://github.com/libarchive/libarchive/releases/download/v3.7.7/libarchive-3.7.7.tar.gz", "hash": "sha1:918692098b11db61aff23684ab04f375e4a68f69" } } } ] } ================================================ FILE: cloudtest/CMakeLists.txt ================================================ set(OUT ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/cloudtest) file(MAKE_DIRECTORY ${OUT}) if (${TARGET_PLATFORM} STREQUAL x64) set(CLOUDTEST_IMAGES "wsl-test-image-rs_prerelease-2025-01-30" "wsl-test-image-win11-23h2-ent-2024-11-18" "wsl-test-image-2022-datacenter-g2-2024-09-10" "wsl-test-image-win10-22h2-ent-g2-2024-09-10") set(CLOUDTEST_TEST_PACKAGES "Test_Packages_2025_07_28") set(DUMPTOOL_DROP "DumpTool_X64_2025-01-27") elseif (${TARGET_PLATFORM} STREQUAL arm64) set(CLOUDTEST_IMAGES) else() message(FATAL_ERROR "Unsupported target platform: ${TARGET_PLATFORM}") endif() # Passed down to test-setup.ps1 to determine if -AllowUnsigned should be passed to Add-AppxPackage if (OFFICIAL_BUILD) set(ALLOW_UNSIGNED_PACKAGE "0") else() set(ALLOW_UNSIGNED_PACKAGE "1") endif() function(add_test_group image version) set(DIR ${OUT}/${image}-wsl${version}) file(MAKE_DIRECTORY ${DIR}) configure_file(${CMAKE_CURRENT_SOURCE_DIR}/TestMap.xml.in ${DIR}/TestMap.xml) configure_file(${CMAKE_CURRENT_SOURCE_DIR}/TestGroup.xml.in ${DIR}/TestGroup.xml) endfunction() foreach(image ${CLOUDTEST_IMAGES}) add_test_group("${image}" "1") add_test_group("${image}" "2") endforeach() ================================================ FILE: cloudtest/TestGroup.xml.in ================================================