Rethink the Accept() logic to differentiate between errors and cancellation (#14156)

* Bring relay changes

* Redesign Accept() logic to differenciate between cancellation and errors

* Prepare for PR

* Apply PR feedback

.clang-format

@@ -0,0 +1,150 @@
+---
+# 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
+...
+

.gdnsuppress

@@ -0,0 +1,326 @@
+{
+  "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"
+    }
+  }
+}

.github/CODEOWNERS

@@ -0,0 +1,4 @@
+# File containing policy for file ownership
+
+# Reviewers for all files in the repository
+* @microsoft/wsl-maintainers

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,6 +1,6 @@
 ---
-name: Feature request
-about: Suggest a feature for Windows Subsystem for Linux
+name: Feature request / Contribution idea
+about: Suggest a feature or improvement for the Windows Subsystem for Linux
 title: ''
 labels: 'feature'
 assignees: ''

.github/actions/triage/action.yml

@@ -5,33 +5,25 @@ inputs:
     issue:
       required: false
       type: string
-    similar_issues_text:
-      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'
-        if: ${{ !contains(inputs.similar_issues_text, '''@') }} # Skip this step if the description contains a string that will break the here document
         shell: pwsh
+        env: 
+            previous_body: "${{ inputs.previous_body }}"
         run: |
             $ErrorActionPreference = [System.Management.Automation.ActionPreference]::Stop
-            $message = @'
-            ${{ inputs.similar_issues_text }}
-            '@
-            
-            $maybe_message = @()
-            if (![string]::IsNullOrEmpty($message))
-            {
-                $maybe_message = @("--default-message-stdin")
-            }
             
             $maybe_comment = @()
             if (![string]::IsNullOrEmpty("${{ inputs.comment }}"))
@@ -39,6 +31,13 @@ runs:
                 $maybe_comment = @("--comment", "${{ inputs.comment }}")
             }
             
-            curl.exe -L https://github.com/OneBlue/wti/releases/download/v0.1.6/wti.exe -o triage/wti.exe
+            $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")
+            }
             
-            cd triage && echo -n $message | .\wti.exe --issue ${{ inputs.issue }} --config config.yml --github-token "${{ inputs.token }}" --ignore-tags @maybe_message @maybe_comment 
+            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

.github/copilot-instructions.md

@@ -0,0 +1,243 @@
+# 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\<platform>\<target>\wsl.msi`
+- OR use script: `powershell tools\deploy\deploy-to-host.ps1`
+- For Hyper-V VM: `powershell tools\deploy\deploy-to-vm.ps1 -VmName <vm> -Username <user> -Password <pass>`
+
+## 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 <files>`
+- Apply formatting: `clang-format -i --style=file <files>`
+- 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\<platform>\<target>\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\<platform>\<target>\test.bat`
+- **NEVER CANCEL: Full test suite takes 30-60 minutes. Set timeout to 90+ minutes.**
+- Run subset: `bin\<platform>\<target>\test.bat /name:*UnitTest*`
+- Run specific test: `bin\<platform>\<target>\test.bat /name:<class>::<test>`
+- 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.

.github/policies/resourceManagement.yml

@@ -181,16 +181,16 @@ configuration:
 
             ```
 
-            The scipt will output the path of the log file once done. 
+            The script will output the path of the log file once done. 
 
 
-            Once completed please upload the output files to this Github issue.
+            Once completed please upload the output files to this GitHub issue.
 
 
-            [Click here](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#8-collect-wsl-logs-recommended-method) for more info on logging
+            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 to the bug, please send them to wsl-gh-logs@microsoft.com with the number of the github issue in the subject, and in the message a link to your comment in the github issue.
+            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!
@@ -226,18 +226,38 @@ configuration:
 
             ```
 
-            The scipt will output the path of the log file once done. 
+            The script will output the path of the log file once done. 
 
 
-            Once completed please upload the output files to this Github issue.
+            Once completed please upload the output files to this GitHub issue.
 
 
-            [Click here](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#8-collect-wsl-logs-recommended-method) for more info on logging
+            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: 

.github/pull_request_template.md

@@ -0,0 +1,18 @@
+<!-- Enter a brief description/summary of your PR here. What does it fix/what does it change/how was it tested (even manually, if necessary)? -->
+## Summary of the Pull Request
+
+<!-- Please review the items on the PR checklist before submitting-->
+## 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
+
+<!-- Provide a more detailed description of the PR, other things fixed or any additional comments/features here -->
+## Detailed Description of the Pull Request / Additional comments
+
+<!-- Describe how you validated the behavior. Add automated tests wherever possible, but list manual validation steps taken as well -->
+## Validation Steps Performed

.github/workflows/distributions.yml

@@ -0,0 +1,17 @@
+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

.github/workflows/documentation.yml

@@ -0,0 +1,35 @@
+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

.github/workflows/gh-sync.yml

@@ -1,57 +0,0 @@
-name: Sync GitHub with ADO
-
-on: 
-  issues:
-    types: [closed, edited, deleted, reopened, assigned, unassigned, labeled, unlabeled]
-  issue_comment:
-
-jobs:
-  build:
-    name: GH-Sync tracked issue
-    if: ${{ github.event.label.name == 'tracking' || contains(github.event.issue.labels.*.name, 'tracking') }} # Filters out issues/events without the 'tracking' label
-    runs-on: ubuntu-latest
-    steps:
-      - name: 'Trigger gh-sync'
-        uses: craigloewen-msft/gh-sync@main
-        with:
-          ado-organization-url: ${{ secrets.AZURE_DEVOPS_URL }}
-          ado-project: ${{ secrets.AZURE_DEVOPS_PROJECT }}
-          ado-area-path: ${{ secrets.AZURE_DEVOPS_PATH }}
-          github-repo: 'microsoft/WSL'
-          issue-number: ${{github.event.issue.number}} # Auto-generated from GitHub action
-          ado-token: ${{ secrets.AZURE_DEVOPS_TOKEN }} # Your Personal Access Token (PAT)
-          github-token: ${{ secrets.GITHUB_TOKEN }}    # Auto-generated from GitHub action
-  
-  network-sync:
-    name: GH-Sync networking issue
-    if: ${{ github.event.label.name == 'network' || contains(github.event.issue.labels.*.name, 'network') }} 
-    runs-on: ubuntu-latest
-    steps:
-      - name: 'Trigger gh-sync'
-        uses: craigloewen-msft/gh-sync@main
-        with:
-          ado-organization-url: ${{ secrets.AZURE_DEVOPS_URL }}
-          ado-project: ${{ secrets.AZURE_DEVOPS_PROJECT }}
-          ado-area-path: ${{ secrets.AZURE_DEVOPS_NETWORKING_PATH }}
-          github-repo: 'microsoft/WSL'
-          issue-number: ${{github.event.issue.number}} # Auto-generated from GitHub action
-          ado-token: ${{ secrets.AZURE_DEVOPS_TOKEN }} # Your Personal Access Token (PAT)
-          github-token: ${{ secrets.GITHUB_TOKEN }}    # Auto-generated from GitHub action
-
-  gpu-sync:
-    name: GH-Sync GPU issue
-    if: ${{ github.event.label.name == 'GPU' || contains(github.event.issue.labels.*.name, 'GPU') }} 
-    runs-on: ubuntu-latest
-    steps:
-      - name: 'Trigger gh-sync'
-        uses: craigloewen-msft/gh-sync@main
-        with:
-          ado-organization-url: ${{ secrets.AZURE_DEVOPS_URL }}
-          ado-project: ${{ secrets.AZURE_DEVOPS_PROJECT }}
-          ado-area-path: ${{ secrets.AZURE_DEVOPS_GPU_PATH }}
-          github-repo: 'microsoft/WSL'
-          issue-number: ${{github.event.issue.number}} # Auto-generated from GitHub action
-          ado-token: ${{ secrets.AZURE_DEVOPS_TOKEN }} # Your Personal Access Token (PAT)
-          github-token: ${{ secrets.GITHUB_TOKEN }}    # Auto-generated from GitHub action
-          ado-assigned-to: ${{ secrets.AZURE_DEVOPS_GPU_ASSIGNED_TO }}
-          

.github/workflows/issue_edited.yml

@@ -0,0 +1,22 @@
+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 }}

.github/workflows/modern-distributions.yml

@@ -0,0 +1,28 @@
+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

.github/workflows/new_issue.yml

@@ -1,29 +1,13 @@
 name: Process new issue
 
 on:
+  workflow_dispatch :
   issues:
     types: [opened]
 
 jobs:
-  getSimilarIssues:
-    runs-on: ubuntu-latest
-    outputs:
-      message: ${{ steps.getBody.outputs.message }}
-    steps:
-      - uses: actions/checkout@v2
-      - id: getBody
-        uses: craigloewen-msft/GitGudSimilarIssues@main
-        with:
-          issueTitle: ${{ github.event.issue.title }}
-          issueBody: ${{ github.event.issue.body }}
-          repository: ${{ github.repository }}
-          similarityTolerance: "0.7"
-          commentBody: |
-            # View similar issues
-            Please view the issues below to see if they solve your problem, and if the issue describes your problem please consider closing this one and thumbs upping the other issue to help us prioritize it!
   wti:
     name: Run wti
-    needs: getSimilarIssues
     runs-on: windows-2022
     permissions:
       issues: write
@@ -33,6 +17,5 @@ jobs:
     
     - uses: ./.github/actions/triage
       with: 
-        similar_issues_text: "${{ needs.getSimilarIssues.outputs.message }}"
         issue: "${{ github.event.issue.number }}"
         token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/new_issue_comment.yml

@@ -1,6 +1,7 @@
 name: Process new comment on issue
 
 on: 
+  workflow_dispatch :
   issue_comment:
     types: [created]
 

.github/workflows/winget.yml

@@ -0,0 +1,30 @@
+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 }}"

.gitignore

@@ -0,0 +1,68 @@
+.vscode/*
+.vs/
+!vendor/.preserve
+out
+tmp
+/.vs/
+/.vscode/
+*.sln
+*.slnx
+*.user
+*.csproj
+*.vcxproj
+*.targets
+*.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
+build/
+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/

.pipelines/build-stage.yml

@@ -0,0 +1,426 @@
+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'))}}
+

.pipelines/flight-stage.yml

@@ -0,0 +1,120 @@
+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)

.pipelines/nuget-stage.yml

@@ -0,0 +1,48 @@
+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 }}

.pipelines/test-job.yml

@@ -0,0 +1,49 @@
+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"

.pipelines/test-stage.yml

@@ -0,0 +1,42 @@
+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 }}"

.pipelines/wsl-build-nightly-localization.yml

@@ -0,0 +1,53 @@
+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)

.pipelines/wsl-build-nightly-onebranch.yml

@@ -0,0 +1,52 @@
+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

.pipelines/wsl-build-notice.yml

@@ -0,0 +1,33 @@
+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)

.pipelines/wsl-build-pr-onebranch.yml

@@ -0,0 +1,52 @@
+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

.pipelines/wsl-build-pr.yml

@@ -0,0 +1,18 @@
+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

.pipelines/wsl-build-release-onebranch.yml

@@ -0,0 +1,71 @@
+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

CMakeLists.txt

@@ -0,0 +1,441 @@
+cmake_minimum_required(VERSION 3.25)
+set(CMAKE_SYSTEM_VERSION 10.0.26100.0)
+
+project(wsl)
+
+# Rationalize TARGET_PLATFORM
+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(StrawberryPerl PERL /)
+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(BIN2CPIO ${CMAKE_CURRENT_LIST_DIR}/tools/bin2cpio/bin2cpio.pl)
+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
+    Iphlpapi.lib
+    icu.lib
+    computecore.lib
+    computenetwork.lib
+    MI.lib
+    Wintrust.lib
+    msi.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
+# N.B. The version is set to VS2022 to ensure local runs match pipeline behavior
+execute_process(
+    COMMAND "${VSWHERE_SOURCE_DIR}/vswhere.exe" -version "[17.0,18.0)" -products * -property installationPath
+    OUTPUT_VARIABLE VS_INSTALL_DIR
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+    COMMAND_ERROR_IS_FATAL ANY
+)
+
+if (NOT VS_INSTALL_DIR)
+    message(FATAL_ERROR "Could not determine Visual Studio 2022 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. 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)
+
+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 ()

CONTRIBUTING.md

@@ -1,123 +1,44 @@
-Please provide as much information as possible when reporting a bug or filing an issue on the Windows Subsystem for Linux.
+# WSL contributing guide
 
-## Important: Reporting BSODs and Security issues
+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
+### 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)*.
 
-## Reporting issues in WSL
-A well written bug report will follow the following template:
-
-### 1) Issue Title
-A title succinctly describing the issue.
-
-#### Example:
-`Traceroute not working.`
-
-### 2) Windows version / build number
-Your Windows build number.  This can be gathered from the CMD prompt using the `cmd.exe --version` command.
-
-```cmd.exe
-C:\ cmd.exe --version
-Microsoft Windows [Version 10.0.21354.1]
-```
-
-Note: The Windows Insider builds contain many updates and fixes. If you are running on the Creators Update (10.0.15063) please check to see if your issue has been resolved in a later build.  If you are running on a Version below (10.0.14393), please try to update your Version.
-
-#### Example:
-
-`Microsoft Windows [Version 10.0.21354.1]`
-
-### 3) Steps required to reproduce
-
-Should include all packages and environmental variables as well as other required configuration.
-
-#### Example: On linux 
-
-`$ sudo apt-get install traceroute && traceroute www.microsoft.com`
-
-#### Example: On Windows
-
-``
-`$ cmd.exe` 
-`CD C:\Windows\System32\`
-`tracert.exe`
-``
-
-### 4) Copy of the terminal output
-
-#### Example:
-
-```
-$ traceroute www.microsoft.com
-traceroute to www.microsoft.com (23.75.239.28), 30 hops max, 60 byte packets
-setsockopt IP_MTU_DISCOVER: Invalid argument
-```
-
-### 5) Expected Behavior
-
-What was the expected result of the command?  Include examples / documentation if possible.
-
-### 6) Strace of the failing command
-
-Run the failing command under [strace](http://manpages.ubuntu.com/manpages/wily/man1/strace.1.html).  Normal command structure is:
-
-```
-$ strace -ff <command>
-```
-
-> Note: `strace` can produce lengthy output. If the generated trace is more than about 20 lines please paste this into a [Gist](https://gist.github.com/) or another paste service and link in the bug.
-
-#### Example:
-
-```
-$ strace traceroute www.microsoft.com
-execve("/usr/bin/traceroute", ["traceroute", "www.microsoft.com"], [/* 22 vars */]) = 0
-brk(0)                                  = 0x7fffdd3bc000
-access("/etc/ld.so.nohwcap", F_OK)      = -1 ENOENT (No such file or directory)
-mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f1f4e820000
-access("/etc/ld.so.preload", R_OK)      = -1 ENOENT (No such file or directory)
-...
-...
-...
-```
-
-### 7) Additional information
-
-Some bugs require additional information such as scripts to reproduce.  Please add to this section.
-
-If there are files required, email the files to InsiderSupport@microsoft.com with:
-
-* **Subject**:  Forward to WSL Team - RE: github issue <issue #>
-* **Body**:  "Please forward to WSL Team" and include your attachment.
-
-Common files are:
-
-* Memory dumps found under C:\Windows\MEMORY.DMP
-* Additional strace logs if the error occurs within a fork. The following
-  command generates an output file for every fork created:
-
-```
-$ strace -ff -o <outputfile> <command>
-```
-
-#### wsl --mount
-
-If the issue is about wsl --mount, please include the output of running `wmic diskdrive get Availability,Capabilities,CapabilityDescriptions,DeviceID,InterfaceType,MediaLoaded,MediaType,Model,Name,Partitions` in an elevated command prompt.
-
-Example:
-
-```
-C:\WINDOWS\system32>wmic diskdrive get Availability,Capabilities,CapabilityDescriptions,DeviceID,InterfaceType,MediaLoaded,MediaType,Model,Name,Partitions
-Availability  Capabilities  CapabilityDescriptions                                       DeviceID            InterfaceType  MediaLoaded  MediaType              Model                       Name                Partitions
-              {3, 4}        {"Random Access", "Supports Writing"}                        \\.\PHYSICALDRIVE0  SCSI           TRUE         Fixed hard disk media  SAMSUNG MZVLB512HAJQ-000H2  \\.\PHYSICALDRIVE0  3
-              {3, 4}        {"Random Access", "Supports Writing"}                        \\.\PHYSICALDRIVE1  SCSI           TRUE         Fixed hard disk media  SAMSUNG MZVLB1T0HALR-000H2  \\.\PHYSICALDRIVE1  1
-              {3, 4, 10}    {"Random Access", "Supports Writing", "SMART Notification"}  \\.\PHYSICALDRIVE2  SCSI           TRUE         Fixed hard disk media  ST2000DM001-1ER164          \\.\PHYSICALDRIVE2  1
-```
-
-#### Collect WSL logs for networking issues
+### Collect WSL logs for networking issues
 
 Install tcpdump in your WSL distribution using the following commands.
 Note: This will not work if WSL has Internet connectivity issues.
@@ -127,26 +48,32 @@ Note: This will not work if WSL has Internet connectivity issues.
 # sudo apt-get -y install tcpdump
 ```
 
-Install [WPR](https://learn.microsoft.com/en-us/windows-hardware/test/wpt/windows-performance-recorder)
+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-networking-logs.ps1" -OutFile collect-networking-logs.ps1
+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-networking-logs.ps1
+.\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
+```
+
 <!-- Preserving anchors -->
 <div id="8-detailed-logs"></div>
 <div id="9-networking-logs"></div>
+<div id="8-collect-wsl-logs-recommended-method"></div>
 
 
-### 8) Collect WSL logs (recommended method)
+### Collect WSL logs (recommended method)
 
-If you choose to email these logs instead of attaching to the bug, please send them to wsl-gh-logs@microsoft.com with the number of the github issue in the subject, and in the message a link to your comment in the github issue.
+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:
 
@@ -157,44 +84,11 @@ Set-ExecutionPolicy Bypass -Scope Process -Force
 ```
 The script will output the path of the log file once done.
 
-### 9) Collect WSL logs with Feedback hub
-To collect WSL logs follow these steps: 
-
-#### Open Feedback Hub and enter the title and description of your issue
-
-- Open Feedback hub and create a new issue by pressing `Windows Key + F` on your keyboard. 
-- Enter in the details of your issue:
-   - In `Summarize your feedback` copy and paste in the title of your Github Issue
-   - In `Explain in more detail` copy and paste a link to your Github Issue
-
-![GIF Of networking instructions](img/networkinglog1.gif)
-
-#### Choose the WSL category 
-
-- Select that your issue is a `Problem`
-- Choose the `Developer Platform` category and the `Windows Subsystem for Linux` subcategory
-
-![GIF Of networking instructions](img/networkinglog2.gif)
-
-#### Recreate your problem in the 'Additional Details' section
-
-- Select 'Other' under 'Which of the following best describes your problem'
-- Click 'Recreate My Problem' under 'Attachments
-- Ensure that `Include Data About:` is checked to 'Windows Subsystem for Linux' 
-- 'Click Start Recording' to start collecting logs
-- Recreate your problem
-- Click 'Stop Recording'
-
-![GIF Of networking instructions](img/networkinglog3.gif)
-
-#### Check your attachments and submit
-
-- Verify your recording is attached and whether you would like to send the screenshot that is automatically attached
-- Hit Submit
-- Get a link to your feedback item by clicking on 'Share my Feedback' and post that link to the Github thread so we can easily get to your feedback!
-
-![GIF Of networking instructions](img/networkinglog4.gif)
-
+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)
 
@@ -206,19 +100,19 @@ reg.exe add HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\CrashControl /v
 
 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 overriden in the advanced system settings).
+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 destinated to the WSL team
+- 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/en-us/windows/win32/wer/collecting-user-mode-dumps).
+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 processe, 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: 
+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
@@ -251,9 +145,9 @@ reg.exe delete "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Repo
 
 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)
+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
+2) Open WinDbg preview as administrator by running `windbgx` in an elevated command prompt
 
 3) Navigate to `file` -> `Attach to process`
 
@@ -267,10 +161,10 @@ To collect time travel debugging traces:
 
 7) Reproduce the issue
 
-8) Go back to windbg and click `Stop and Debug`
+8) Go back to WinDbg and click `Stop and Debug`
 
-9) Once the trace is done collecting, click `Stop Debugging` and close Windbg
+9) Once the trace is done collecting, click `Stop Debugging` and close WinDbg
 
-10) Go to the folder where the trace was colleced, and locate the .run file. It should look like: `wslservice*.run`
+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

DATA_AND_PRIVACY.md

@@ -0,0 +1,18 @@
+# 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.

Directory.Build.Props

@@ -0,0 +1,11 @@
+<Project>
+   <PropertyGroup>
+      <UseMultiToolTask>true</UseMultiToolTask>
+      <EnforceProcessCountAcrossBuilds>true</EnforceProcessCountAcrossBuilds>
+   </PropertyGroup>
+   <ItemDefinitionGroup>
+      <CustomBuild>
+         <BuildInParallel>true</BuildInParallel>
+      </CustomBuild>
+   </ItemDefinitionGroup>
+</Project>

NOTICE.txt

@@ -0,0 +1,971 @@
+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 <bo@suse.de>
+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 <ryan@numb.org>
+(c) 2003-2004 Randolph Chung <tausq@debian.org>
+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 <bo@suse.de>
+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 <noah@noah.org>
+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 <penorman@mac.com>
+Copyright (c) 2016 Aaron Watry <awatry@gmail.com>
+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 <zackw@panix.com>
+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 <jakub@redhat.com>
+Copyright (c) 2008 Guido U. Draheim <guidod@gmx.de>
+Copyright (c) 2008 Stepan Kasal <skasal@redhat.com>
+Copyright (c) 2011 Plausible Labs Cooperative, Inc.
+Copyright (c) 2012 Qualcomm Innovation Center, Inc.
+Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
+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. <miod@openbsd.org>
+Copyright (c) 2014, 2015 Advanced Micro Devices, Inc.
+Copyright (c) 2016 Krzesimir Nowak <qdlacz@gmail.com>
+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 <skimo@kotnet.org>
+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 <sebastian@macke.de>
+Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
+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 <brad@brad-smith.co.uk>
+Copyright (c) 2013 Jesse Towner <jessetowner@lavabit.com>
+Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
+(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 <scott@netsplit.com>
+Copyright (c) 2008 Steven G. Johnson <stevenj@alum.mit.edu>
+Copyright (c) 2009 Steven G. Johnson <stevenj@alum.mit.edu>
+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 <victormatheus@gmail.com>
+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 <Todd.Miller@courtesan.com>
+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 <steven.bethard@gmail.com>
+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 <alexandre.keunecke@gmail.com>
+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 <alexandre.keunecke@gmail.com> , Paulo Pizarro <paulo.pizarro@gmail.com>
+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 <m-ou.se@m-ou.se>
+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) <year> <copyright holders>
+
+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.NETCore.App.Runtime.win-arm64 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 1995-2022 Mark Adler
+Copyright 1995-2024 Mark Adler
+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 <m-ou.se@m-ou.se>
+Copyright (c) .NET Foundation and Contributors
+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 1995-2024 Jean-loup Gailly and Mark Adler Qkkbal
+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
+
+The MIT License (MIT)
+
+Copyright (c) .NET Foundation and Contributors
+
+All rights reserved.
+
+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.NETCore.App.Runtime.win-x64 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 1995-2022 Mark Adler
+Copyright 1995-2024 Mark Adler
+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 <m-ou.se@m-ou.se>
+Copyright (c) .NET Foundation and Contributors
+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 1995-2024 Jean-loup Gailly and Mark Adler Qkkbal
+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
+
+The MIT License (MIT)
+
+Copyright (c) .NET Foundation and Contributors
+
+All rights reserved.
+
+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) <year> <copyright holders>
+
+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) <year> <copyright holders>
+
+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) <year> <copyright holders>
+
+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.
+
+---------------------------------------------------------
+

README.md

@@ -1,73 +1,49 @@
-This repo is for:
+# Welcome to the Windows Subsystem for Linux (WSL) repository
 
-- Reporting of issues found within and when using Windows Subsystem for Linux.
-  Please read [CONTRIBUTING.md](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md) before making an issue submission
+<p align="center">
+  <img src="./Images/Square44x44Logo.targetsize-256.png" alt="WSL logo"/>
+</p>
 
-  > Do not open Github issues for Windows crashes (BSODs) or security issues. Please direct all Windows crashes and security issues to secure@microsoft.com. Issues with security vulnerabilities may be edited to hide the vulnerability details.
+[Learn more about WSL](https://aka.ms/wsldocs) | [Downloads & Release notes](https://github.com/microsoft/WSL/releases) | [Contributing to WSL](./CONTRIBUTING.md)
 
-- Surrounding discussions about the Windows Subsystem for Linux.
+## About
 
-## Reporting issues in Windows Console or WSL text rendering/user experience
+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.
 
-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)*. 
+You can install WSL right away by running this command inside of your Windows command line:
 
-## Labels:
+```powershell
+wsl --install
+```
 
-This is your best way to interact directly with the Windows Subsystem for Linux teams. We will be monitoring and responding to issues as best we can. Please attempt to avoid filing duplicates of open or closed items when possible. Issues may be tagged with with the following labels:
+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/).
 
-- **bug** – The issue considered to be a bug internally by the dev team. This tag is generally for gaps in implemented (read: intended to be working) WSL behavior. Things marked with **bug** have a corresponding bug in on Microsoft’s internal bug tracking system. Example: "du -h reports wrong file size on DrvFs" [(#1894)](https://github.com/microsoft/WSL/issues/1894)
+## Related repositories
 
-- **feature** – Denotes something understood as not working and is not yet implemented. Example: "Cuda can not be installed" [(#327)](https://github.com/microsoft/WSL/issues/327)
+WSL also has related open source repositories:
 
-- **fixinbound** / **fixedinNNNN** – The 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.
+- [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
 
-- **duplicate** – The submission is substantially duplicative of an existing issue, and/or has the same underlying cause.
+## Contributing
 
-- **need-repro** – The issue submission is missing fields from the issue [template](https://github.com/microsoft/WSL/tree/master/.github/ISSUE_TEMPLATE), cannot be reproduced with the information provided, or is not actionable.
+This project welcomes contributions of all types, including coding features / bug fixes, documentation fixes, design proposals and more. 
 
-- **discussion** / **question** – Submissions which are not a bug report or feature request. Example: Windows Subsystem for Linux is not open source [(#178)](https://github.com/Microsoft/WSL/issues/178)
+We ask that before you start working on a contribution, please read our [Contributor's Guide](./CONTRIBUTING.md).
 
-- **bydesign** / **linux-behavior** – Denotes that an issue that is considered working as intended or would behave analogously on a native Linux kernel.
+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.
 
-- **console** – The submission should be directed to the [console issue tracker](https://github.com/microsoft/console/issues).
+## Code of Conduct
 
-- **documentation** – The submission should be directed to the [WSL documentation issue tracker](https://github.com/MicrosoftDocs/WSL).
+This project has adopted the [Microsoft Open Source Code of Conduct](./CODE_OF_CONDUCT.md)
 
-- **wsl2** - The issue relates specifically to WSL 2.
+## Trademarks
 
-- **fixed-in-wsl2** - The issue could be resolved by switching the distro to use the WSL 2 architecture.
+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.
 
-Additional tags may be used to denote specific types of issues.
+## Privacy and telemetry
 
-- **9p-linux-file-access** - The issue is related to accessing Linux files from Windows.
+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).
 
-## Closing:
-
-Issues may be closed by the original poster at any time.  We will close issues if:
-- The issue is not a bug or feature request
-- The issue has been addressed
-- The issue is a duplicate of another issue
-- Discussions or questions that have ran their course
-
-### Microsoft Links:
-
-- [Microsoft Docs](https://docs.microsoft.com/en-us/windows/wsl/about)
-- [Release Notes](https://docs.microsoft.com/en-us/windows/wsl/release-notes)
-- [WSL Blog](https://blogs.msdn.microsoft.com/wsl) (Historical)
-- [Command Line Blog](https://blogs.msdn.microsoft.com/commandline/) (Active)
-
-### Community Links:
-
-- Stack Overflow: https://stackoverflow.com/questions/tagged/wsl
-- Ask Ubuntu: https://askubuntu.com/questions/tagged/wsl
-- reddit: https://www.reddit.com/r/bashonubuntuonwindows
-- List of programs that work and don't work
-    - https://github.com/ethanhs/WSL-Programs
-    - https://github.com/davatron5000/can-i-subsystem-it
-- Awesome WSL: https://github.com/sirredbeard/Awesome-WSL
-- Tips and guides for new bash users: https://github.com/abergs/ubuntuonwindows
-- WSL Utilities (WSLU): https://github.com/wslutilities/wslu
-
-### Troubleshooting:
-
-Common troubleshooting issues and solutions are available on our [MSDN documentation](https://msdn.microsoft.com/en-us/commandline/wsl/troubleshooting).
+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.

SECURITY.md

@@ -10,11 +10,11 @@ If you believe you have found a security vulnerability in any Microsoft-owned re
 
 **Please do not report security vulnerabilities through public GitHub issues.**
 
-Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+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.com/msrc](https://aka.ms/opensource/security/msrc). 
+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:
 
@@ -38,4 +38,4 @@ We prefer all communications to be in English.
 
 Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
 
-<!-- END MICROSOFT SECURITY.MD BLOCK -->
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

UserConfig.cmake.sample

@@ -0,0 +1,46 @@
+# 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)

cgmanifest.json

@@ -0,0 +1,35 @@
+{
+    "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"
+                }
+            }
+        }
+    ]
+}

cloudtest/CMakeLists.txt

@@ -0,0 +1,39 @@
+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()

cloudtest/TestGroup.xml.in

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TestJobGroup EnableProcessJobObjectBreakaway="true">
+  <ResourceSpec>
+    <Resource SKU="Standard_D4_v3" Image="${image}"/>
+  </ResourceSpec>
+  <Setup TimeoutMins="30">
+    <BuildFiles>
+      <Copy Src="[drop]\bundle\Microsoft.WSL_${PACKAGE_VERSION}_x64_ARM64.msixbundle" Dest="[WorkingDirectory]" IsRecursive="false"/>
+      <Copy Src="[drop]\testbin\${TARGET_PLATFORM}\release\*" Dest="[WorkingDirectory]\" IsRecursive="true" Writable="true"/>
+      <Copy Src="[drop]\testbin\${TARGET_PLATFORM}\test_distro.tar.xz" Dest="[WorkingDirectory]" IsRecursive="false" Writable="true"/>
+      <Copy Src="[drop]\testbin\test-setup.ps1" Dest="[WorkingDirectory]\" IsRecursive="false" />
+      <Copy Src="[drop]\testbin\CloudTest-Setup.bat" Dest="[WorkingDirectory]\" IsRecursive="false" />
+      <Copy Src="[drop]\testbin\wsl.wprp" Dest="[WorkingDirectory]\" IsRecursive="false" />
+      <Copy Src="[drop]\testbin\unit_tests\*" Dest="[WorkingDirectory]\unit_tests" IsRecursive="true" Writable="true"/>
+      <Copy Src="[test_packages]\*" Dest="[WorkingDirectory]" IsRecursive="false" />
+      <Copy Src="[dump_tool]\DumpTool.exe" Dest="[WorkingDirectory]" IsRecursive="false" />
+    </BuildFiles>
+    <Scripts>
+      <Script Path="[WorkingDirectory]\CloudTest-Setup.bat" Args="[WorkingDirectory] [LoggingDirectory]" />
+    </Scripts>
+  </Setup>
+
+  <TestJob Name="CloudTest.Taef" TimeoutMins="240">
+    <Execution Type="TAEF" Path="[WorkingDirectory]\wsltests.dll" Args="/p:bugReportDirectory=[LoggingDirectory]\BugReportOutput /errorOnCrash /testmode:etwlogger /EtwLogger:WPRProfileFile=[WorkingDirectory]\wsl.wprp /EtwLogger:WPRProfile=WSL /EtwLogger:SavePoint=ExecutionComplete /EtwLogger:RecordingScope=Execution /p:SetupScript=.\test-setup.ps1 /p:Package=[WorkingDirectory]\Microsoft.WSL_${PACKAGE_VERSION}_x64_ARM64.msixbundle /p:Version=${version} /p:AllowUnsigned=${ALLOW_UNSIGNED_PACKAGE} /p:UnitTestsPath=[WorkingDirectory]\unit_tests /p:DistroPath=[WorkingDirectory]\test_distro.tar.xz /p:DistroName=test_distro /logOutput:High /p:RedirectStdout=[LoggingDirectory]\stdout.txt /p:RedirectStderr=[LoggingDirectory]\stderr.txt  /p:KernelLogs=[LoggingDirectory]\dmesg.txt /p:DumpFolder=[LoggingDirectory] /p:WerReport /p:LogDmesg /p:PipelineBuildId=${PIPELINE_BUILD_ID} /p:DumpTool=DumpTool.exe" />
+  </TestJob>
+</TestJobGroup>

cloudtest/TestMap.xml.in

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TestMap>
+  <TestJobGroup Name="TaefTestsGroup" TestSystem="Default" ConfigPath="[BuildRoot]\testbin\${TARGET_PLATFORM}\cloudtest\${image}-wsl${version}\TestGroup.xml" IsActive="true"/>
+  <Providers>
+    <Provider Type="PipelineArtifacts">
+      <Properties>
+        <Add Name="CloudTest.ProviderCustomName" Value="[drop]" />
+        <Add Name="PipelineArtifactBuildUrl" Value="https://${VSO_ORG}.visualstudio.com/${VSO_PROJECT}/_build/results?buildId=${PIPELINE_BUILD_ID}"/>
+        <Add Name="PipelineArtifactName" Value="drop_wsl_build"/>
+      </Properties>
+    </Provider>
+    <Provider Type="VSODrop">
+      <Properties>
+        <Add Name="CloudTest.ProviderCustomName" Value="[test_distro]" />
+        <!-- When updating the drops for this make sure the retention is set to never expire -->
+        <Add Name="DropURL" Value="https://${VSO_ORG}.artifacts.visualstudio.com/_apis/drop/drops/WSL/${CLOUDTEST_TEST_DISTRO_DROP}"/>
+      </Properties>
+    </Provider>
+    <Provider Type="VSODrop">
+      <Properties>
+        <Add Name="CloudTest.ProviderCustomName" Value="[test_packages]" />
+        <!-- When updating the drops for this make sure the retention is set to never expire -->
+        <Add Name="DropURL" Value="https://${VSO_ORG}.artifacts.visualstudio.com/_apis/drop/drops/WSL/${CLOUDTEST_TEST_PACKAGES}"/>
+      </Properties>
+    </Provider>
+    <Provider Type="VSODrop">
+      <Properties>
+        <Add Name="CloudTest.ProviderCustomName" Value="[dump_tool]" />
+        <!-- When updating the drops for this make sure the retention is set to never expire -->
+        <Add Name="DropURL" Value="https://${VSO_ORG}.artifacts.visualstudio.com/_apis/drop/drops/WSL/${DUMPTOOL_DROP}"/>
+      </Properties>
+    </Provider>
+  </Providers>
+</TestMap>

cmake/FindIDL.cmake

@@ -0,0 +1,67 @@
+function(add_idl target idl_files_with_proxy idl_files_no_proxy)
+    set(OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR}/${TARGET_PLATFORM}/${CMAKE_BUILD_TYPE})
+    file(MAKE_DIRECTORY ${OUTPUT_DIR})
+    set(TARGET_OUTPUTS)
+
+    set(IDL_DEFINITIONS "")
+
+    get_directory_property(IDL_DEFS COMPILE_DEFINITIONS )
+    foreach(e ${IDL_DEFS})
+        set(IDL_DEFINITIONS ${IDL_DEFINITIONS} /D${e})
+    endforeach()
+
+    string(TOLOWER ${TARGET_PLATFORM} IDL_ENV)
+
+    foreach(idl_file ${idl_files_with_proxy})
+
+        cmake_path(GET idl_file STEM IDL_NAME)
+
+        set(IDL_HEADER ${OUTPUT_DIR}/${IDL_NAME}.h)
+
+        # Adding a _${TARGET_PLATFORM} to work around object files having
+        # the same paths regardless of TARGET_PLATFORM, which can cause the linker to fail with:
+        # "fatal error LNK1112: module machine type 'x64' conflicts with target machine type 'ARM64'"
+        set(IDL_I ${OUTPUT_DIR}/${IDL_NAME}_i_${TARGET_PLATFORM}.c)
+        set(IDL_P ${OUTPUT_DIR}/${IDL_NAME}_p_${TARGET_PLATFORM}.c)
+        set(IDL_DLLDATA ${OUTPUT_DIR}/dlldata_${TARGET_PLATFORM}.c)
+        set(MIDL_OUTPUT ${IDL_HEADER} ${IDL_I} ${IDL_C} ${IDL_DLLDATA})
+
+        add_custom_command(
+            OUTPUT ${MIDL_OUTPUT} ${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}
+            COMMAND midl /nologo /target NT100 /env "${IDL_ENV}" /Zp8 /char unsigned /ms_ext /c_ext /h ${IDL_HEADER} /iid ${IDL_I} /proxy ${IDL_P} /dlldata ${IDL_DLLDATA} ${idl_file} ${IDL_DEFINITIONS}
+            COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+            WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+            DEPENDS ${idl_file}
+            MAIN_DEPENDENCY ${idl_file}
+            VERBATIM
+        )
+
+        set_source_files_properties(${MIDL_OUTPUT} PROPERTIES GENERATED TRUE)
+        list(APPEND TARGET_OUTPUTS ${MIDL_OUTPUT})
+
+    endforeach()
+
+    foreach(idl_file ${idl_files_no_proxy})
+
+        cmake_path(GET idl_file STEM IDL_NAME)
+
+        set(IDL_HEADER ${OUTPUT_DIR}/${IDL_NAME}.h)
+
+        add_custom_command(
+            OUTPUT ${IDL_HEADER} ${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}
+            COMMAND midl /nologo /target NT100 /env "${IDL_ENV}" /Zp8 /char unsigned /ms_ext /c_ext /h ${IDL_HEADER} ${idl_file} ${IDL_DEFINITIONS}
+            COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+            WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+            DEPENDS ${idl_file}
+            MAIN_DEPENDENCY ${idl_file}
+            VERBATIM
+        )
+
+        set_source_files_properties(${IDL_HEADER} PROPERTIES GENERATED TRUE)
+        list(APPEND TARGET_OUTPUTS ${IDL_HEADER})
+
+    endforeach()
+
+    add_custom_target(${target} DEPENDS ${TARGET_OUTPUTS} SOURCES ${idl_files_with_proxy} ${idl_files_no_proxy})
+
+endfunction()

cmake/FindLINUXBUILD.cmake

@@ -0,0 +1,104 @@
+function(build_linux_objects sources headers)
+    file(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/${TARGET_PLATFORM}/${CMAKE_BUILD_TYPE})
+
+    foreach(e ${sources})
+        cmake_path(GET e FILENAME object_name)
+        set(object "${CMAKE_CURRENT_BINARY_DIR}/${TARGET_PLATFORM}/${CMAKE_BUILD_TYPE}/${object_name}.o")
+        set(objects ${objects} ${object})
+
+        if("${e}" MATCHES "^.*\.c$")
+            set(compiler ${LINUX_CC})
+            set(flags ${LINUX_CFLAGS})
+        else()
+            set(compiler ${LINUX_CXX})
+            set(flags ${LINUX_CXXFLAGS})
+        endif()
+
+        add_custom_command(
+            OUTPUT ${object}
+            COMMAND ${compiler} ${flags} ${LINUX_BUILD_TYPE_FLAGS} ${e} -c -o ${object}
+            WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+            MAIN_DEPENDENCY ${e}
+            DEPENDS ${headers} # Every object depends on all headers to trigger a rebuild if a header is changed
+            VERBATIM
+        )
+    endforeach()
+
+    set(objects ${objects} PARENT_SCOPE)
+endfunction()
+
+function(add_linux_library_impl target sources headers add_sources)
+    set(ar_output "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/${target}.a")
+
+    build_linux_objects("${sources}" "${headers}")
+
+    add_custom_command(
+        OUTPUT ${ar_output} ${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}
+        COMMAND ${LINUX_AR} crus ${ar_output} ${objects}
+        COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+        WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+        DEPENDS ${objects}
+        VERBATIM
+    )
+
+    if (${add_sources})
+        add_custom_target(${target} DEPENDS ${ar_output} SOURCES ${sources} ${headers})
+    else()
+        add_custom_target(${target} DEPENDS ${ar_output})
+    endif()
+
+    set_source_files_properties(${ar_output} PROPERTIES GENERATED TRUE)
+endfunction()
+
+function(add_linux_library target sources headers)
+    add_linux_library_impl(${target} "${sources}" "${headers}" TRUE)
+endfunction()
+
+function(add_linux_library_no_sources target sources headers)
+    add_linux_library_impl(${target} "${sources}" "${headers}" FALSE)
+endfunction()
+
+
+function(add_linux_executable target sources headers libraries)
+    set(output "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/${target}")
+    set(output_unstripped "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/${target}.unstripped")
+
+    build_linux_objects("${sources}" "${headers}")
+
+    set(libs -lunwind -lc++abi -lc++)
+    foreach(e ${libraries})
+        set(libs ${libs} -l${e})
+
+        # Note: This makes the assumption that all libraries are static (.a and not .so).
+        # Executables need to depend on both the target and the underlying library file, so that
+        # the libraries target get analyzed for changes, and the executable gets linked again if the .a files changed.
+        list(APPEND lib_targets "lib${e}")
+        list(APPEND lib_files "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/lib${e}.a")
+    endforeach()
+
+    if (NOT ${CMAKE_BUILD_TYPE} STREQUAL "Debug")
+        set(stripped_output "${output}")
+        set(output "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${CMAKE_BUILD_TYPE}/${target}.debug")
+        add_custom_command(
+            OUTPUT ${stripped_output}
+            COMMAND ${LLVM_INSTALL_DIR}/llvm-strip.exe "${output}" -o "${stripped_output}"
+            COMMAND ${LLVM_INSTALL_DIR}/llvm-objcopy.exe --add-gnu-debuglink "${output}" "${stripped_output}"
+            WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+            DEPENDS ${output}
+            VERBATIM
+        )
+     endif()
+
+    add_custom_command(
+         OUTPUT ${output}
+         COMMAND ${LINUX_CXX} -o ${output} ${LINUXSDK_PATH}/lib/crti.o ${LINUXSDK_PATH}/lib/crt1.o ${objects} ${LINUXSDK_PATH}/lib/crtn.o ${LINUX_LDFLAGS} ${libs}
+         COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+         WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+         DEPENDS ${objects} ${lib_files}
+         VERBATIM
+     )
+
+    add_custom_target(${target} DEPENDS ${output} ${stripped_output} SOURCES ${sources} ${headers})
+    add_dependencies(${target} ${lib_targets})
+
+endfunction()

cmake/FindMC.cmake

@@ -0,0 +1,23 @@
+function(add_mc target mc_file)
+
+    cmake_path(GET mc_file STEM MC_NAME)
+
+    set(OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR}\\${TARGET_PLATFORM}\\${CMAKE_BUILD_TYPE})
+    set(RC_FILE ${OUTPUT_DIR}/${MC_NAME}.rc)
+    set(HEADER_FILE ${OUTPUT_DIR}/${MC_NAME}.h)
+
+    add_custom_command(
+        OUTPUT ${RC_FILE} ${HEADER_FILE} ${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}
+        COMMAND mc.exe -A -b -c -h ${OUTPUT_DIR} -r ${OUTPUT_DIR} ${mc_file}
+        COMMAND rc.exe -nologo -fo${OUTPUT_DIR}\\${MC_NAME}.res ${RC_FILE}
+        COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+        WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+        DEPENDS ${mc_file}
+        MAIN_DEPENDENCY ${mc_file}
+        VERBATIM
+    )
+
+    add_custom_target(${target} DEPENDS ${RC_FILE} SOURCES ${mc_file})
+
+    set_source_files_properties(${RC_FILE} PROPERTIES GENERATED TRUE)
+endfunction()

cmake/findAppx.cmake

@@ -0,0 +1,84 @@
+function(add_appx_target target binaries manifest_in output_package dependencies)
+
+    set(PACKAGE_LAYOUT "${CMAKE_CURRENT_BINARY_DIR}/${TARGET_PLATFORM}/package_layout")
+    set(MANIFEST "${CMAKE_CURRENT_BINARY_DIR}/AppxManifest.xml")
+    set(PRI_CONF "${CMAKE_CURRENT_BINARY_DIR}/priconf.xml")
+    set(OUTPUT_RESOURCES_PRI "${CMAKE_CURRENT_BINARY_DIR}/resources.pri")
+
+    # generate the list of languages for the appxmanifest
+    set(SUPPORTED_LANGS_MANIFEST_ENTRIES "")
+    foreach(LANG ${SUPPORTED_LANGS})
+        string(TOUPPER "${LANG}" LANG)
+        set(SUPPORTED_LANGS_MANIFEST_ENTRIES "${SUPPORTED_LANGS_MANIFEST_ENTRIES}\n    <Resource Language=\"${LANG}\"/>")
+    endforeach()
+
+    configure_file(${manifest_in} ${MANIFEST})
+
+    file(MAKE_DIRECTORY ${PACKAGE_LAYOUT})
+
+    # images
+    file(MAKE_DIRECTORY ${PACKAGE_LAYOUT}/Images)
+    set(RESOURCES_DEPENDENCY)
+    file(GLOB IMAGES RELATIVE ${PROJECT_SOURCE_DIR}/ "${PROJECT_SOURCE_DIR}/images/*.png")
+    foreach(e ${IMAGES})
+        file(CREATE_LINK ${PROJECT_SOURCE_DIR}/${e} ${PACKAGE_LAYOUT}/${e} SYMBOLIC)
+        list(APPEND RESOURCES_DEPENDENCY ${PROJECT_SOURCE_DIR}/${e})
+    endforeach()
+
+    # Localization. Note: these files aren't added to the resource map, so they aren't added to the package,
+    # but they are used by makepri to generate resources.pri
+    file(CREATE_LINK ${PROJECT_SOURCE_DIR}/localization/strings ${PACKAGE_LAYOUT}/Strings SYMBOLIC)
+
+    foreach(binary ${binaries})
+    set(BINARY_SRC "${BIN}/${binary}")
+    set(BINARY_DEST "${PACKAGE_LAYOUT}/${binary}")
+    add_custom_command(
+        OUTPUT ${BINARY_DEST}
+        COMMAND ${CMAKE_COMMAND} -E create_symlink "${BINARY_SRC}" "${BINARY_DEST}"
+        DEPENDS ${BINARY_SRC}
+    )
+    list(APPEND BINARIES_DEPENDENCY ${BINARY_DEST})
+    endforeach()
+
+    # Reduce the output of makeappx unless WSL_APPX_DEBUG is set to make the build output nicer to read
+    if (WSL_SILENT_APPX_BUILD)
+        set(COMMAND_SUFFIX "2>NUL;>;NUL")
+    endif ()
+
+    # generate priconf.xml
+    string(REPLACE ";" "_" SUPPORTED_LANGS_STR "${SUPPORTED_LANGS}")
+    add_custom_command(
+        OUTPUT ${PRI_CONF}
+        COMMAND makepri.exe createconfig /cf ${PRI_CONF} /dq ${SUPPORTED_LANGS_STR} /pv 10.0 /o ${COMMAND_SUFFIX}
+        COMMAND_EXPAND_LISTS
+    )
+
+    # generate resources.pri
+    add_custom_command(
+        OUTPUT ${OUTPUT_RESOURCES_PRI} ${CMAKE_CURRENT_BINARY_DIR}/resources.map.txt
+        COMMAND makepri.exe new /pr ${PACKAGE_LAYOUT} /cf ${PRI_CONF} /of ${OUTPUT_RESOURCES_PRI} /mn ${MANIFEST} /mf AppX /o /IndexOptions +lf ${COMMAND_SUFFIX}
+        COMMAND_EXPAND_LISTS
+        DEPENDS ${PRI_CONF} ${MANIFEST} ${BINARIES_DEPENDENCY} ${RESOURCES_DEPENDENCY} # Make sure the package is rebuilt if any of the resources change
+    )
+
+    # make appx
+    add_custom_command(
+        OUTPUT ${output_package}
+        COMMAND makeappx.exe pack /m ${MANIFEST} /f ${CMAKE_CURRENT_BINARY_DIR}/resources.map.txt /p ${output_package} /o ${COMMAND_SUFFIX}
+        COMMAND ${PACKAGE_SIGN_COMMAND} ${output_package} ${COMMAND_SUFFIX}
+        COMMAND ${CMAKE_COMMAND} -E touch "${CMAKE_CURRENT_BINARY_DIR}/CmakeFiles/${target}"
+        WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+        COMMAND_EXPAND_LISTS
+        DEPENDS ${MANIFEST} ${BINARIES_DEPENDENCY} ${OUTPUT_RESOURCES_PRI} ${CMAKE_CURRENT_BINARY_DIR}/resources.map.txt # Make sure the package is rebuilt if any of the binaries or resources change
+    )
+
+    add_custom_target(${target} DEPENDS ${output_package})
+
+    foreach(e ${dependencies})
+        add_dependencies(${target} ${e})
+    endforeach()
+
+    set_target_properties(${target} PROPERTIES EXCLUDE_FROM_ALL FALSE SOURCES ${manifest_in})
+
+    set_source_files_properties(${output_package} PROPERTIES GENERATED TRUE)
+endfunction()

cmake/findNuget.cmake

@@ -0,0 +1,42 @@
+function(find_nuget_package name var_name path)
+
+    string(JSON "${var_name}_VERSION" GET ${NUGET_PACKAGES_JSON} "${name}")
+
+    set(${var_name}_SOURCE_DIR "${CMAKE_BINARY_DIR}/packages/${name}.${${var_name}_VERSION}${path}" PARENT_SCOPE)
+    set(${var_name}_VERSION "${${var_name}_VERSION}" PARENT_SCOPE)
+endfunction()
+
+function (restore_nuget_packages)
+
+    # Fetch nuget.exe
+    FILE(DOWNLOAD
+        https://dist.nuget.org/win-x86-commandline/v5.10.0/nuget.exe
+        ${CMAKE_BINARY_DIR}/_deps/nuget.exe
+        EXPECTED_HASH SHA256=852b71cc8c8c2d40d09ea49d321ff56fd2397b9d6ea9f96e532530307bbbafd3)
+
+    set_property(
+        DIRECTORY
+        APPEND
+        PROPERTY CMAKE_CONFIGURE_DEPENDS
+        ${CMAKE_CURRENT_LIST_DIR}/packages.config
+        ${CMAKE_CURRENT_LIST_DIR}/nuget.config)
+
+    # Restore nuget packages
+    execute_process(COMMAND
+        ${CMAKE_BINARY_DIR}/_deps/nuget.exe restore packages.config -SolutionDirectory ${CMAKE_BINARY_DIR}
+        WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+        COMMAND_ERROR_IS_FATAL ANY)
+endfunction()
+
+function (parse_nuget_packages_versions)
+
+    # Parse the list of available packages
+    set(CMD "$packages=@{}; (Select-Xml -path ${CMAKE_SOURCE_DIR}/packages.config /packages).Node.ChildNodes | Where-Object { $_.name -ne '#whitespace'} | % {$packages.add($_.id, $_.Attributes['version'].Value) }; $packages | ConvertTo-Json | Write-Host")
+
+    execute_process(
+        COMMAND powershell.exe -ExecutionPolicy Bypass -NoProfile -NonInteractive -Command "${CMD}"
+        OUTPUT_VARIABLE output
+        COMMAND_ERROR_IS_FATAL ANY)
+
+    set(NUGET_PACKAGES_JSON ${output} PARENT_SCOPE)
+endfunction()

cmake/findVersion.cmake

@@ -0,0 +1,26 @@
+function(get_version_impl command var_name)
+    execute_process(
+        COMMAND powershell.exe
+                -NoProfile
+                -NonInteractive
+                -ExecutionPolicy Bypass
+                -Command "$env:Path += ';${GITVERSION_SOURCE_DIR}' ; . .\\tools\\devops\\version_functions.ps1 ; ${command}"
+        OUTPUT_VARIABLE OUTPUT_VERSION
+        WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+        COMMAND_ERROR_IS_FATAL ANY)
+    string(STRIP "${OUTPUT_VERSION}" OUTPUT_VERSION)
+    SET(${var_name} ${OUTPUT_VERSION} PARENT_SCOPE)
+endfunction()
+
+function(find_commit_hash var_name)
+    get_version_impl("Get-Current-Commit-Hash" "command_output")
+    SET(${var_name} ${command_output} PARENT_SCOPE)
+endfunction()
+
+function(find_version msix_var_name nuget_var_name)
+    get_version_impl("Get-VersionInfo -Nightly $false | ConvertTo-Json" "command_output")
+    string(JSON  "${msix_var_name}" GET "${command_output}" MsixVersion)
+    string(JSON  "${nuget_var_name}" GET "${command_output}" NugetVersion)
+
+    return(PROPAGATE ${msix_var_name} ${nuget_var_name})
+endfunction()

diagnostics/collect-networking-logs.ps1

@@ -1,303 +0,0 @@
-#Requires -RunAsAdministrator
-
-[CmdletBinding()]
-Param (
-    [switch]$RestartWslReproMode = $false
-   )
-
-function Collect-WindowsNetworkState {
-
-    param (
-        $ReproStep
-    )
-
-    # Collect host networking state relevant for WSL
-    # Using a try/catch for commands below, as some of them do not exist on all OS versions
-
-    try
-    {
-        Get-NetAdapter -includeHidden | select Name,ifIndex,NetLuid,InterfaceGuid,Status,MacAddress,MtuSize,InterfaceType,Hidden,HardwareInterface,ConnectorPresent,MediaType,PhysicalMediaType | Out-File -FilePath "$folder/Get-NetAdapter_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        & netsh nlm query all $folder/nlmquery_"$ReproStep".log
-    }
-    catch {}
-
-    try
-    {
-        Get-NetIPConfiguration -All -Detailed | Out-File -FilePath "$folder/Get-NetIPConfiguration_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetRoute | Out-File -FilePath "$folder/Get-NetRoute_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallHyperVVMCreator | Out-File -FilePath "$folder/Get-NetFirewallHyperVVMCreator_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallHyperVVMSetting -PolicyStore ActiveStore | Out-File -FilePath "$folder/Get-NetFirewallHyperVVMSetting_ActiveStore_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallHyperVProfile -PolicyStore ActiveStore | Out-File -FilePath "$folder/Get-NetFirewallHyperVProfile_ActiveStore_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallHyperVRule -PolicyStore ActiveStore | Out-File -FilePath "$folder/Get-NetFirewallHyperVRule_ActiveStore_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallRule -PolicyStore ActiveStore | Out-File -FilePath "$folder/Get-NetFirewallRule_ActiveStore_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallProfile -PolicyStore ActiveStore | Out-File -FilePath "$folder/Get-NetFirewallProfile_ActiveStore_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        Get-NetFirewallHyperVPort | Out-File -FilePath "$folder/Get-NetFirewallHyperVPort_$ReproStep.log" -Append
-    }
-    catch {}
-
-    try
-    {
-        & hnsdiag.exe list all 2>&1 > $folder/hnsdiag_list_all_"$ReproStep".log
-    }
-    catch {}
-
-    try
-    {
-        & hnsdiag.exe list endpoints -df 2>&1 > $folder/hnsdiag_list_endpoints_"$ReproStep".log
-    }
-    catch {}
-
-    try
-    {
-        foreach ($port in Get-NetFirewallHyperVPort)
-        {
-            & vfpctrl.exe /port $port.PortName /get-port-state 2>&1 > "$folder/vfp-port-$($port.PortName)-get-port-state_$ReproStep.log"
-            & vfpctrl.exe /port $port.PortName /list-rule 2>&1 > "$folder/vfp-port-$($port.PortName)-list-rule_$ReproStep.log"
-        }
-    }
-    catch {}
-
-    try
-    {
-        & vfpctrl.exe /list-vmswitch-port 2>&1 > $folder/vfpctrl_list_vmswitch_port_"$ReproStep".log
-    }
-    catch {}
-}
-
-$folder = "WslNetworkingLogs-" + (Get-Date -Format "yyyy-MM-dd_HH-mm-ss")
-mkdir -p $folder
-
-$logProfile = "$folder/wsl_networking.wprp"
-$networkingBashScript = "$folder/networking.sh"
-
-# Copy/Download supporting files
-if (Test-Path "$PSScriptRoot/wsl_networking.wprp")
-{
-    Copy-Item "$PSScriptRoot/wsl_networking.wprp" $logProfile
-}
-else
-{
-    Write-Host -ForegroundColor Yellow "wsl_networking.wprp not found in the current directory. Downloading it from GitHub."
-    Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl_networking.wprp" -OutFile $logProfile
-}
-
-if (Test-Path "$PSScriptRoot/networking.sh")
-{
-    Copy-Item "$PSScriptRoot/networking.sh" $networkingBashScript
-}
-else
-{
-    Write-Host -ForegroundColor Yellow "networking.sh not found in the current directory. Downloading it from GitHub."
-    Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/networking.sh" -OutFile $networkingBashScript
-}
-
-# Retrieve WSL version and wslconfig file
-get-appxpackage MicrosoftCorporationII.WindowsSubsystemforLinux > $folder/appxpackage.txt
-
-$wslconfig = "$env:USERPROFILE/.wslconfig"
-if (Test-Path $wslconfig)
-{
-    Copy-Item $wslconfig $folder
-}
-
-# Collect Linux & Windows network state before the repro
-& wsl.exe -u root -e $networkingBashScript 2>&1 > $folder/linux_network_configuration_before.log
-
-Collect-WindowsNetworkState "before_repro"
-
-if ($RestartWslReproMode)
-{
-    # The WSL HNS network is created once per boot. Resetting it to collect network creation logs.
-    # Note: The below HNS command applies only to WSL in NAT mode
-    Get-HnsNetwork | Where-Object {$_.Name -eq 'WSL' -Or $_.Name -eq 'WSL (Hyper-V firewall)'} | Remove-HnsNetwork
-
-    # Stop WSL.
-    net.exe stop WslService
-    if(-not $?)
-    {
-        net.exe stop LxssManager
-    }
-}
-
-# Start logging.
-$wprOutputLog = "$folder/wpr.txt"
-
-wpr.exe -start $logProfile -filemode 2>&1 >> $wprOutputLog
-if ($LastExitCode -Ne 0)
-{
-    Write-Host -ForegroundColor Yellow "Log collection failed to start (exit code: $LastExitCode), trying to reset it."
-    wpr.exe -cancel 2>&1 >> $wprOutputLog
-
-    wpr.exe -start $logProfile -filemode 2>&1 >> $wprOutputLog
-    if ($LastExitCode -Ne 0)
-    {
-        Write-Host -ForegroundColor Red "Couldn't start log collection (exitCode: $LastExitCode)"
-    }
-}
-
-# Start packet capture using pktmon
-pktmon start -c --flags 0x1A --file-name "$folder/pktmon.etl" | out-null
-
-# Start WFP capture
-netsh wfp capture start file="$folder/wfpdiag.cab"
-
-# Start tcpdump. Using a try/catch as tcpdump might not be installed
-$tcpdumpProcess = $null
-try
-{
-    $tcpdumpProcess = Start-Process wsl.exe -ArgumentList "-u root tcpdump -n -i any -e -vvv > $folder/tcpdump.log" -PassThru
-}
-catch {}
-
-try
-{
-    Write-Host -NoNewLine -ForegroundColor Green "Log collection is running. Please reproduce the problem and press any key to save the logs."
-
-    $KeysToIgnore =
-          16,  # Shift (left or right)
-          17,  # Ctrl (left or right)
-          18,  # Alt (left or right)
-          20,  # Caps lock
-          91,  # Windows key (left)
-          92,  # Windows key (right)
-          93,  # Menu key
-          144, # Num lock
-          145, # Scroll lock
-          166, # Back
-          167, # Forward
-          168, # Refresh
-          169, # Stop
-          170, # Search
-          171, # Favorites
-          172, # Start/Home
-          173, # Mute
-          174, # Volume Down
-          175, # Volume Up
-          176, # Next Track
-          177, # Previous Track
-          178, # Stop Media
-          179, # Play
-          180, # Mail
-          181, # Select Media
-          182, # Application 1
-          183  # Application 2
-
-    $Key = $null
-    while (($Key -Eq $null -Or $Key.VirtualKeyCode -Eq $null -Or $KeysToIgnore -Contains $Key.VirtualKeyCode) -and ($null -eq $tcpdumpProcess -or $tcpdumpProcess.HasExited -eq $false))
-    {
-        if ([console]::KeyAvailable)
-        {
-            $Key = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
-        }
-        else
-        {
-            Start-Sleep -Seconds 1
-        }
-    }
-
-    Write-Host "`nSaving logs..."
-}
-finally
-{
-    try
-    {
-        wsl.exe -u root killall tcpdump
-        if ($tcpdumpProcess -ne $null)
-        {
-            Wait-Process -InputObject $tcpdumpProcess -Timeout 10
-        }
-    }
-    catch {}
-
-    netsh wfp capture stop
-    pktmon stop | out-null
-    wpr.exe -stop $folder/logs.etl 2>&1 >> $wprOutputLog
-}
-
-# Collect Linux & Windows network state after the repro
-& wsl.exe -u root -e $networkingBashScript 2>&1 > $folder/linux_network_configuration_after.log
-
-Collect-WindowsNetworkState "after_repro"
-
-try
-{
-    # Collect HNS events from past 24 hours
-    $events = Get-WinEvent -ProviderName Microsoft-Windows-Host-Network-Service | Where-Object { $_.TimeCreated -ge ((Get-Date) - (New-TimeSpan -Day 1)) }
-    ($events | ForEach-Object { '{0},{1},{2},{3}' -f $_.TimeCreated, $_.Id, $_.LevelDisplayName, $_.Message }) -join [environment]::NewLine | Out-File -FilePath "$folder/hns_events.log" -Append
-}
-catch {}
-
-# Collect the old Tcpip6 registry values - as they can break WSL if DisabledComponents is set to 0xff
-# see https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/configure-ipv6-in-windows
-try
-{
-    Get-Item HKLM:SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters | Out-File -FilePath "$folder/tcpip6_parameters.log" -Append
-}
-catch {}
-
-# Collect the setup and NetSetup log files
-$netSetupPath = "$env:WINDIR/logs/netsetup"
-if (Test-Path $netSetupPath)
-{
-    Copy-Item $netSetupPath/* $folder
-}
-
-$setupApiPath = "$env:WINDIR/inf/setupapi.dev.log"
-if (Test-Path $setupApiPath)
-{
-    Copy-Item $setupApiPath $folder
-}
-
-Remove-Item $logProfile
-Remove-Item $networkingBashScript
-
-$logArchive = "$(Resolve-Path $folder).zip"
-Compress-Archive -Path $folder -DestinationPath $logArchive
-Remove-Item $folder -Recurse
-
-Write-Host -ForegroundColor Green "Logs saved in: $logArchive. Please attach that file to the GitHub issue."

diagnostics/collect-wsl-logs.ps1

@@ -3,36 +3,120 @@
 [CmdletBinding()]
 Param (
     $LogProfile = $null,
-    [switch]$Dump = $false
+    [switch]$Dump = $false,
+    [switch]$RestartWslReproMode = $false
    )
 
 Set-StrictMode -Version Latest
 
+function Collect-WindowsNetworkState {
+    param (
+        $Folder,
+        $ReproStep
+    )
+
+    # Collect host networking state relevant for WSL
+    # Using a try/catch for commands below, as some of them do not exist on all OS versions
+
+    try { Get-NetAdapter -includeHidden | select Name,ifIndex,NetLuid,InterfaceGuid,Status,MacAddress,MtuSize,InterfaceType,Hidden,HardwareInterface,ConnectorPresent,MediaType,PhysicalMediaType | Out-File -FilePath "$Folder/Get-NetAdapter_$ReproStep.log" -Append } catch {}
+    try { & netsh nlm query all $Folder/nlmquery_"$ReproStep".log } catch {}
+    try { Get-NetIPConfiguration -All -Detailed | Out-File -FilePath "$Folder/Get-NetIPConfiguration_$ReproStep.log" -Append } catch {}
+    try { Get-NetRoute | Out-File -FilePath "$Folder/Get-NetRoute_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallHyperVVMCreator | Out-File -FilePath "$Folder/Get-NetFirewallHyperVVMCreator_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallHyperVVMSetting -PolicyStore ActiveStore | Out-File -FilePath "$Folder/Get-NetFirewallHyperVVMSetting_ActiveStore_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallHyperVProfile -PolicyStore ActiveStore | Out-File -FilePath "$Folder/Get-NetFirewallHyperVProfile_ActiveStore_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallHyperVRule -PolicyStore ActiveStore | Out-File -FilePath "$Folder/Get-NetFirewallHyperVRule_ActiveStore_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallRule -PolicyStore ActiveStore | Out-File -FilePath "$Folder/Get-NetFirewallRule_ActiveStore_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallProfile -PolicyStore ActiveStore | Out-File -FilePath "$Folder/Get-NetFirewallProfile_ActiveStore_$ReproStep.log" -Append } catch {}
+    try { Get-NetFirewallHyperVPort | Out-File -FilePath "$Folder/Get-NetFirewallHyperVPort_$ReproStep.log" -Append } catch {}
+    try { & hnsdiag.exe list all 2>&1 > $Folder/hnsdiag_list_all_"$ReproStep".log } catch {}
+    try { & hnsdiag.exe list endpoints -df 2>&1 > $Folder/hnsdiag_list_endpoints_"$ReproStep".log } catch {}
+    try {
+        foreach ($port in Get-NetFirewallHyperVPort) {
+            & vfpctrl.exe /port $port.PortName /get-port-state 2>&1 > "$Folder/vfp-port-$($port.PortName)-get-port-state_$ReproStep.log"
+            & vfpctrl.exe /port $port.PortName /list-rule 2>&1 > "$Folder/vfp-port-$($port.PortName)-list-rule_$ReproStep.log"
+        }
+    } catch {}
+    try { & vfpctrl.exe /list-vmswitch-port 2>&1 > $Folder/vfpctrl_list_vmswitch_port_"$ReproStep".log } catch {}
+    try { Get-VMSwitch | select Name,Id,SwitchType | Out-File -FilePath "$Folder/Get-VMSwitch_$ReproStep.log" -Append } catch {}
+    try { Get-NetUdpEndpoint | Out-File -FilePath "$Folder/Get-NetUdpEndpoint_$ReproStep.log" -Append } catch {}
+}
+
 $folder = "WslLogs-" + (Get-Date -Format "yyyy-MM-dd_HH-mm-ss")
 mkdir -p $folder | Out-Null
 
-if ($LogProfile -eq $null -Or ![System.IO.File]::Exists($LogProfile))
+# Check if LogProfile is a custom file path or a profile name
+if ($LogProfile -ne $null -And [System.IO.File]::Exists($LogProfile))
 {
-    if ($LogProfile -eq $null)
+    # User provided a custom .wprp file path - use it directly
+    $wprpFile = $LogProfile
+    $wprpProfile = $null  # Use default profile in the file
+}
+else
+{
+    # Map log profile names to WPRP profile names
+    $wprpProfile = "WSL"
+    if ($LogProfile -eq "storage")
     {
-        $url = "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl.wprp"
+        $wprpProfile = "WSL-Storage"
     }
-    elseif ($LogProfile -eq "storage")
+    elseif ($LogProfile -eq "networking")
     {
-         $url = "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl_storage.wprp"
+        $wprpProfile = "WSL-Networking"
     }
-    else
+    elseif ($LogProfile -eq "hvsocket")
     {
-        Write-Error "Unknown log profile: $LogProfile"
+        $wprpProfile = "WSL-HvSocket"
+    }
+    elseif ($LogProfile -ne $null)
+    {
+        Write-Error "Unknown log profile: $LogProfile. Valid options are: storage, networking, hvsocket, or a path to a custom .wprp file"
         exit 1
     }
 
-    $LogProfile = "$folder/wsl.wprp"
-    try {
-        Invoke-WebRequest -UseBasicParsing $url -OutFile $LogProfile
+    # Use the consolidated wsl.wprp file, attempt to use local copy first.
+    $wprpFile = "$folder/wsl.wprp"
+    if (Test-Path "$PSScriptRoot/wsl.wprp")
+    {
+        Copy-Item "$PSScriptRoot/wsl.wprp" $wprpFile
     }
-    catch {
-        throw
+    else
+    {
+        Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/wsl.wprp" -OutFile $wprpFile
+    }
+}
+
+# Networking-specific setup
+if ($LogProfile -eq "networking")
+{
+    # Copy/download networking.sh script
+    $networkingBashScript = "$folder/networking.sh"
+    if (Test-Path "$PSScriptRoot/networking.sh")
+    {
+        Copy-Item "$PSScriptRoot/networking.sh" $networkingBashScript
+    }
+    else
+    {
+        Write-Host -ForegroundColor Yellow "networking.sh not found in the current directory. Downloading it from GitHub."
+        Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/networking.sh" -OutFile $networkingBashScript
+    }
+
+    # Detect the super user (uid=0, not necessarily named "root" - see #11693)
+    $superUser = & wsl.exe -- id -nu 0
+
+    # Collect Linux & Windows network state before the repro
+    & wsl.exe -u $superUser -e $networkingBashScript 2>&1 > $folder/linux_network_configuration_before.log
+    Collect-WindowsNetworkState -Folder $folder -ReproStep "before_repro"
+
+    if ($RestartWslReproMode)
+    {
+        # The WSL HNS network is created once per boot. Resetting it to collect network creation logs.
+        # Note: The below HNS command applies only to WSL in NAT mode
+        Get-HnsNetwork | Where-Object {$_.Name -eq 'WSL' -Or $_.Name -eq 'WSL (Hyper-V firewall)'} | Remove-HnsNetwork
+
+        # Stop WSL
+        net.exe stop WslService
+        if(-not $?) { net.exe stop LxssManager }
     }
 }
 
@@ -42,6 +126,7 @@ reg.exe export HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\P9NP $folder
 reg.exe export HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WinSock2 $folder/Winsock2.txt 2>&1 | Out-Null
 reg.exe export "HKEY_CLASSES_ROOT\CLSID\{e66b0f30-e7b4-4f8c-acfd-d100c46c6278}" $folder/wslsupport-proxy.txt 2>&1 | Out-Null
 reg.exe export "HKEY_CLASSES_ROOT\CLSID\{a9b7a1b9-0671-405c-95f1-e0612cb4ce7e}" $folder/wslsupport-impl.txt 2>&1 | Out-Null
+Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion" > $folder/windows-version.txt
 
 Get-Service wslservice -ErrorAction Ignore | Format-list * -Force  > $folder/wslservice.txt
 
@@ -51,26 +136,62 @@ if (Test-Path $wslconfig)
     Copy-Item $wslconfig $folder | Out-Null
 }
 
+Copy-Item "C:\Windows\temp\wsl-install-log.txt" $folder -ErrorAction ignore
+
 get-appxpackage MicrosoftCorporationII.WindowsSubsystemforLinux -ErrorAction Ignore > $folder/appxpackage.txt
 get-acl "C:\ProgramData\Microsoft\Windows\WindowsApps" -ErrorAction Ignore | Format-List > $folder/acl.txt
 Get-WindowsOptionalFeature -Online > $folder/optional-components.txt
 bcdedit.exe > $folder/bcdedit.txt
 
+$uninstallLogs = "$env:TEMP/wsl-uninstall-logs.txt"
+if (Test-Path $uninstallLogs)
+{
+    Copy-Item $uninstallLogs $folder | Out-Null
+}
+
 $wprOutputLog = "$folder/wpr.txt"
 
-wpr.exe -start $LogProfile -filemode 2>&1 >> $wprOutputLog
+# Build wpr command - if wprpProfile is set, use profile syntax, otherwise use file only
+if ($wprpProfile -ne $null)
+{
+    $wprCommand = "$wprpFile!$wprpProfile"
+}
+else
+{
+    $wprCommand = $wprpFile
+}
+
+wpr.exe -start $wprCommand -filemode 2>&1 >> $wprOutputLog
 if ($LastExitCode -Ne 0)
 {
     Write-Host -ForegroundColor Yellow "Log collection failed to start (exit code: $LastExitCode), trying to reset it."
     wpr.exe -cancel 2>&1 >> $wprOutputLog
 
-    wpr.exe -start $LogProfile -filemode 2>&1 >> $wprOutputLog
+    wpr.exe -start $wprCommand -filemode 2>&1 >> $wprOutputLog
     if ($LastExitCode -Ne 0)
     {
         Write-Host -ForegroundColor Red "Couldn't start log collection (exitCode: $LastExitCode)"
     }
 }
 
+# Start networking-specific captures
+$tcpdumpProcess = $null
+if ($LogProfile -eq "networking")
+{
+    pktmon start -c --flags 0x1A --file-name "$folder/pktmon.etl" | out-null
+    netsh wfp capture start file="$folder/wfpdiag.cab"
+
+    # Ensure WSL is running before collecting network state
+    & wsl.exe -- true 2>&1 | Out-Null
+
+    # Start tcpdump (may not be installed)
+    try
+    {
+        $tcpdumpProcess = Start-Process wsl.exe -ArgumentList "-u $superUser tcpdump -n -i any -e -vvv > $folder/tcpdump.log" -WindowStyle Hidden -PassThru
+    }
+    catch {}
+}
+
 try
 {
     Write-Host -NoNewLine "Log collection is running. Please "
@@ -116,9 +237,65 @@ try
 }
 finally
 {
+    # Stop networking-specific captures
+    if ($LogProfile -eq "networking")
+    {
+        try
+        {
+            wsl.exe -u $superUser killall tcpdump
+            if ($tcpdumpProcess -ne $null)
+            {
+                Wait-Process -InputObject $tcpdumpProcess -Timeout 10
+            }
+        }
+        catch {}
+
+        netsh wfp capture stop
+        pktmon stop | out-null
+    }
+
     wpr.exe -stop $folder/logs.etl 2>&1 >> $wprOutputLog
 }
 
+# Networking-specific post-repro collection
+if ($LogProfile -eq "networking")
+{
+    # Collect Linux & Windows network state after the repro
+    & wsl.exe -u $superUser -e $networkingBashScript 2>&1 > $folder/linux_network_configuration_after.log
+    Collect-WindowsNetworkState -Folder $folder -ReproStep "after_repro"
+
+    try
+    {
+        # Collect HNS events from past 24 hours
+        $events = Get-WinEvent -ProviderName Microsoft-Windows-Host-Network-Service | Where-Object { $_.TimeCreated -ge ((Get-Date) - (New-TimeSpan -Day 1)) }
+        ($events | ForEach-Object { '{0},{1},{2},{3}' -f $_.TimeCreated, $_.Id, $_.LevelDisplayName, $_.Message }) -join [environment]::NewLine | Out-File -FilePath "$folder/hns_events.log" -Append
+    }
+    catch {}
+
+    # Collect the old Tcpip6 registry values - as they can break WSL if DisabledComponents is set to 0xff
+    # see https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/configure-ipv6-in-windows
+    try
+    {
+        Get-Item HKLM:SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters | Out-File -FilePath "$folder/tcpip6_parameters.log" -Append
+    }
+    catch {}
+
+    # Collect the setup and NetSetup log files
+    $netSetupPath = "$env:WINDIR/logs/netsetup"
+    if (Test-Path $netSetupPath)
+    {
+        Copy-Item $netSetupPath/* $folder
+    }
+
+    $setupApiPath = "$env:WINDIR/inf/setupapi.dev.log"
+    if (Test-Path $setupApiPath)
+    {
+        Copy-Item $setupApiPath $folder
+    }
+
+    Remove-Item $networkingBashScript
+}
+
 if ($Dump)
 {
     $Assembly = [PSObject].Assembly.GetType('System.Management.Automation.WindowsErrorReporting')
@@ -127,7 +304,7 @@ if ($Dump)
     $dumpFolder = Join-Path (Resolve-Path "$folder") dumps
     New-Item -ItemType "directory" -Path "$dumpFolder"
 
-    $executables = "wsl", "wslservice", "wslhost", "msrdc"
+    $executables = "wsl", "wslservice", "wslhost", "msrdc", "dllhost"
     foreach($process in Get-Process | Where-Object { $executables -contains $_.ProcessName})
     {
         $dumpFile =  "$dumpFolder/$($process.ProcessName).$($process.Id).dmp"

diagnostics/dump-init.sh

@@ -3,35 +3,71 @@
 set -ue
 
 if [ $(whoami) != "root" ]; then
-  echo "This script must be run as root in the system distro (via wsl.exe -u root --system)"
+  echo "This script must be run as root in the debug shell (via wsl.exe -u root --debug-shell)"
   exit 1
 fi
 
-ts=$(date +%F_%H-%M-%S)
-target="/mnt/c/wsl-init-dump-$ts"
+dmesg
 
-mkdir -p "$target"
+# Try to install gdb
 
-tdnf install -y gdb
+if [ "${dump:-0}" == 1 ]; then
+    tdnf install -y gdb || true
+fi
 
-bash -c "cd $target && gcore -a \$(pgrep init)"
+declare -a pids_to_dump
+
+for proc in /proc/[0-9]*; do
+  read -a stats < "$proc/stat" # Skip kernel threads to make the output easier to read
+  flags=${stats[8]}
+
+  if (( ("$flags" & 0x00200000) == 0x00200000 )); then
+    continue
+  fi
+
+  pid=$(basename "$proc")
+
+  if [ "${dump:-0}" == 1 ]; then
+    pids_to_dump+=("$pid")
+  fi
+
+  parent=$(ps -o ppid= -p "$pid")
+
+  echo -e "\nProcess: $pid (parent: $parent) "
+  echo -en "cmd: "
+  cat "/proc/$pid/cmdline" || true
+  echo -e "\nstat: "
+  cat "/proc/$pid/stat" || true
 
-stack_log="$target/stacks.txt"
-fd_log="$target/fd.txt"
-for pid in $(pgrep init); do
-  echo -e "\nProcess: $pid" >> "$stack_log"
-  echo -e "\nProcess: $pid" >> "$fd_log"
   for tid in $(ls "/proc/$pid/task" || true); do
-    echo "tid: $tid" >> "$stack_log"
-    cat "/proc/$pid/task/$tid/stack" >> "$stack_log" || true
+    echo -n "tid: $tid - "
+    cat "/proc/$pid/task/$tid/comm" || true
+    cat "/proc/$pid/task/$tid/stack" || true
   done
 
-  ls -la "/proc/$pid/fd" >> "$fd_log" || true
+  echo "fds: "
+  ls -la "/proc/$pid/fd" || true
 done
 
+for pid in "${pids_to_dump[@]}" ; do
+   name=$(ps -p "$pid" -o comm=)
+   if [[ "$name" =~ ^(bash|login)$ ]]; then
+     echo "Skipping dump for process: $name"
+     continue
+   fi
 
-ss -lap --vsock > "/$target/sockets.txt"
-dmesg > "/$target/dmesg.txt"
-cat /proc/meminfo > "/$target/meminfo.txt"
+   echo "Dumping process: $name ($pid) "
+   if gcore -a -o core "$pid" ; then
+     if ! /wsl-capture-crash 0 "$name" "$pid" 0 < "core.$pid" ; then
+         echo "Failed to dump process $pid"
+     fi
 
-echo "Logs and dumps written in $target"
+     rm "core.$pid"
+   fi
+done
+
+echo "hvsockets: "
+ss -lap --vsock
+
+echo "meminfo: "
+cat /proc/meminfo

diagnostics/networking.sh

@@ -5,6 +5,9 @@ set -xu
 lsb_release -a || cat /etc/issue /etc/os-release
 uname -a
 
+echo "Printing per-distro configuration"
+cat /etc/wsl.conf
+
 echo "Printing adapter & routing configuration"
 ip a
 ip route show table all
@@ -23,8 +26,38 @@ if [ -z ${WSL_PAC_URL+x} ]; then echo "WSL_PAC_URL is unset"; else echo "WSL_PAC
 
 echo "Printing DNS configuration"
 cat /etc/resolv.conf
+cat /etc/nsswitch.conf
 
 echo "Printing iptables and nftables rules"
-iptables -S
-ip6tables -S
+# iptables can be configured using both "iptables" and the legacy version "iptables-legacy". It's possible they can be used together
+# (although not recommended). Collect both to make sure no rules are missed.
+# We list the contents of the most common tables (filter, nat, mangle, raw, security)
+iptables -vL -t filter
+iptables -vL -t nat
+iptables -vL -t mangle
+iptables -vL -t raw
+iptables -vL -t security
+
+ip6tables -vL -t filter
+ip6tables -vL -t nat
+ip6tables -vL -t mangle
+ip6tables -vL -t raw
+ip6tables -vL -t security
+
+iptables-legacy -vL -t filter
+iptables-legacy -vL -t nat
+iptables-legacy -vL -t mangle
+iptables-legacy -vL -t raw
+iptables-legacy -vL -t security
+
+ip6tables-legacy -vL -t filter
+ip6tables-legacy -vL -t nat
+ip6tables-legacy -vL -t mangle
+ip6tables-legacy -vL -t raw
+ip6tables-legacy -vL -t security
+
 nft list ruleset
+
+# This will print configurations such as net.ipv4.conf.all.route_localnet or net.ipv4.ip_local_port_range
+echo "Printing networking configurations"
+sysctl -a | grep net

diagnostics/wsl.wprp

@@ -1,35 +1,51 @@
 <?xml version="1.0"?>
+<!--
+  Available Profiles (use profile name with wpr -start):
+  - WSL: General WSL tracing (default)
+  - WSL-Storage: WSL with enhanced storage tracing
+  - WSL-Networking: WSL with comprehensive networking tracing
+  - WSL-HvSocket: WSL with HvSocket-specific tracing
+  
+  Example: wpr -start wsl.wprp!WSL-Networking -filemode
+-->
 <WindowsPerformanceRecorder Version="1">
   <Profiles>
+    <!-- Event Collectors -->
     <EventCollector Id="Collector" Name="Collector">
-      <BufferSize Value="256"/>
-      <Buffers Value="1024"/>
+      <BufferSize Value="512"/>
+      <Buffers Value="4096"/>
     </EventCollector>
    
-    <EventProvider Id="lxcore_kernel" Name="0CD1C309-0878-4515-83DB-749843B3F5C9"/>
-    <EventProvider Id="lxcore_user" Name="D90B9468-67F0-5B3B-42CC-82AC81FFD960"/>
-    <EventProvider Id="lxcore_service" Name="B99CDB5A-039C-5046-E672-1A0DE0A40211"/>
-    <EventProvider Id="wsl_devicehost" Name="9d6c7b9e-2581-4d8a-b8c5-b90b4a17094a"/>
-    <EventProvider Id="wslclient" Name="8cbb7724-7223-5d6f-8137-564dac45104d"/>
-    <EventProvider Id="wslapi" Name="beb94edf-1a7b-5058-0696-ff9e6b1798d1"/>
-    <EventProvider Id="vm_chipset" Name="de9ba731-7f33-4f44-98c9-6cac856b9f83"/>
-    <EventProvider Id="vmcompute_dll" Name="AF7FD3A7-B248-460C-A9F5-FEC39EF8468C"/>
-    <EventProvider Id="vmcompute" Name="17103E3F-3C6E-4677-BB17-3B267EB5BE57"/>
-    <EventProvider Id="vmmm" Name="6066F867-7CA1-4418-85FD-36E3F9C0600C"/>
-    <EventProvider Id="vmwp" Name="51DDFA29-D5C8-4803-BE4B-2ECB715570FE"/>
+    <!-- Event Providers -->
     <EventProvider Id="9p" Name="e13c8d52-b153-571f-78c5-1d4098af2a1e"/>
     <EventProvider Id="9p_errors" Name="06C601B3-6957-4F8C-A15F-74875B24429D" />
-    <EventProvider Id="p9rdr" Name="bb1d36f0-e0e0-48cc-9493-fef0e3d0b28c" />
-    <EventProvider Id="mup" Name="20c46239-d059-4214-a11e-7d6769cbe020" />
-    <EventProvider Id="rfsmon" Name="51734B23-5B7E-4892-BA8E-45BC110B735C" />
-    <EventProvider Id="hyperv_storage" Name="c7ad62c6-5c99-5a1b-bbc4-0821ae5b765e" />
-    <EventProvider Id="hns" Name="0c885e0d-6eb6-476c-a048-2457eed3a5c1" />
-    <EventProvider Id="netmgmt" Name="93f693dc-9163-4dee-af64-d855218af242" />
+    <EventProvider Id="aad_WPP" Name="4DE9BC9C-B27A-43C9-8994-0915F1A5E24F" />
+    <EventProvider Id="basecsp_WPP" Name="133A980D-035D-4E2D-B250-94577AD8FCED" />
+    <EventProvider Id="BCRYPT_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473302" />
+    <EventProvider Id="BFE_WPP" Name="106B464A-8043-46B1-8CB8-E92A0CD7A560" />
+    <EventProvider Id="CAPI1_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473305" />
+    <EventProvider Id="CHAT_WPP" Name="9B52E09F-0C58-4EAF-877F-70F9B54A7946" />
+    <EventProvider Id="cloudap_WPP" Name="EC3CA551-21E9-47D0-9742-1195429831BB" />
+    <EventProvider Id="CNG_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473303" />
+    <EventProvider Id="credssp_WPP" Name="6165F3E2-AE38-45D4-9B23-6B4818758BD9" />
+    <EventProvider Id="CRYPTOWINRT_WPP" Name="786396CD-2FF3-53D3-D1CA-43E41D9FB73B" />
+    <EventProvider Id="dclocator_WPP" Name="CA030134-54CD-4130-9177-DAE76A3C5791" />
+    <EventProvider Id="digest_WPP" Name="FB6A424F-B5D6-4329-B9B5-A975B3A93EAD" />
+    <EventProvider Id="DNS_WPP" Name="609151DD-04F5-4DA7-974C-FC6947EAA323" />
+    <EventProvider Id="dpapis_WPP" Name="EA3F84FC-03BB-540E-B6AA-9664F81A31FB" />
+    <EventProvider Id="EventProvider_HvSocketTraceProvider" Name="B2ED3BDB-CD74-5B2C-F660-85079CA074B3" NonPagedMemory="true">
+      <Keywords>
+        <Keyword Value="0x0"/>
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="EventProvider_Microsoft.Windows.EMPS.Enrollment" Name="E74EFD1A-B62D-4B83-AB00-66F4A166A2D3" />
+    <EventProvider Id="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment" Name="F9E3B648-9AF1-4DC3-9A8E-BF42C0FBCE9A" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.AppDownload" Name="0BBE6221-EF09-4A3F-82EE-BE00DBB6A98A" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.Datastore" Name="42C60CEA-0FE7-4541-A86B-9E11F95BD9BF" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.PhoneProvisioner" Name="B876B1FC-C7F1-443E-9012-86677F7DE580" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.PPOEM" Name="7EDBED09-1FF7-4FEE-B8C3-5DB694420830" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.API" Name="82ADD491-01D7-4B85-9EAD-192C3CAACA23" />
+    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.CommandCsp" Name="00BB69FC-60BC-4502-9438-25608F375CCB" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.CSP" Name="16E12400-A2D8-44B7-9479-004568EC7819" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Engine" Name="A6A847B7-4429-49AA-BBA6-2AD8C191AC8C" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Handlers" Name="0383D92C-2337-4F25-A0B5-A51767F04746" />
@@ -38,123 +54,481 @@
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Platform" Name="B1F30020-8BC3-4888-BB1B-4DD681F24209" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Plugin.Engine" Name="55239D60-0EB6-495B-874E-15DE5D5F9A70" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Plugin.RemovableMedia" Name="B55883E6-6C45-45C2-AB9D-800BB7B66B13" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.ProvTool" Name="2BF4B6BA-556E-4D05-8534-CAFEDF19FED8" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.CommandCsp" Name="00BB69FC-60BC-4502-9438-25608F375CCB" />
     <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.ProvLaunch" Name="08FACCFA-125D-4ED6-B0B7-B4A1A912E693" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.EMPS.Enrollment" Name="E74EFD1A-B62D-4B83-AB00-66F4A166A2D3" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment" Name="F9E3B648-9AF1-4DC3-9A8E-BF42C0FBCE9A" />
-    <EventProvider Id="virtdisk_wpp" Name="e14dcdd9-d1ec-4dc3-8395-a606df8ef115" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="virtdisk" Name="4D20DF22-E177-4514-A369-F1759FEEDEB3" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-     <EventProvider Id="vhdmp" Name="E2816346-87F4-4F85-95C3-0C79409AA89D" NonPagedMemory="true" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFD" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="vhdmp_wpp" Name="3c70c3b0-2fae-41d3-b68d-8f7fcaf79adb" NonPagedMemory="true" Level="5">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="storvsp" Name="10b3d268-9782-49a4-aacc-a93c5482cb6f" NonPagedMemory="true" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="HyperV_SyntheticStorage" Name="EDACD782-2564-4497-ADE6-7199377850F2" Level="6">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="HyperV_EmulatedStorage" Name="86E15E01-EDF1-4AC7-89CF-B19563FD6894" Level="6">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
+    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.ProvTool" Name="2BF4B6BA-556E-4D05-8534-CAFEDF19FED8" />
     <EventProvider Id="EventProvider_Telemetry_StorVSP" Name="544d0787-9f6d-432e-8414-e035a8b0541d">
       <Keywords>
         <Keyword Value="0xFFFFFFFFFFFFFFFF" />
       </Keywords>
     </EventProvider>
-
     <EventProvider Id="EventProvider_Trace_Vhdmp" Name="dc284fb3-1eab-4854-828a-b25417280280" Level="3">
       <Keywords>
         <Keyword Value="0xFFFFFFFFFFFFFFFF" />
       </Keywords>
     </EventProvider>
+    <EventProvider Id="gMSAClient_WPP" Name="2D45EC97-EF01-4D4F-B9ED-EE3F4D3C11F3" />
+    <EventProvider Id="hns" Name="0c885e0d-6eb6-476c-a048-2457eed3a5c1" />
+    <EventProvider Id="HTTP_sys_WPP" Name="20F61733-57F1-4127-9F48-4AB7A9308AE2" />
+    <EventProvider Id="HyperV_EmulatedStorage" Name="86E15E01-EDF1-4AC7-89CF-B19563FD6894" Level="6">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="hyperv_storage" Name="c7ad62c6-5c99-5a1b-bbc4-0821ae5b765e" />
+    <EventProvider Id="HyperV_SyntheticStorage" Name="EDACD782-2564-4497-ADE6-7199377850F2" Level="6">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="idcommon_WPP" Name="B1108F75-3252-4B66-9239-80FD47E06494" />
+    <EventProvider Id="idlisten_WPP" Name="D93FE84A-795E-4608-80EC-CE29A96C8658" />
+    <EventProvider Id="idstore_WPP" Name="82C7D3DF-434D-44FC-A7CC-453A8075144E" />
+    <EventProvider Id="IPNat" Name="AE3F6C6D-BF2A-4291-9D07-59E661274EE3" />
+    <EventProvider Id="kdc_WPP" Name="1BBA8B19-7F31-43C0-9643-6E911F79A06B" />
+    <EventProvider Id="kerb_WPP" Name="6B510852-3583-4E2D-AFFE-A67F9F223438" />
+    <EventProvider Id="KerbClientShared_WPP" Name="FACB33C4-4513-4C38-AD1E-57C1F6828FC0" />
+    <EventProvider Id="KerbComm_WPP" Name="60A7AB7A-BC57-43E9-B78A-A1D516577AE3" />
+    <EventProvider Id="kps_WPP" Name="97A38277-13C0-4394-A0B2-2A70B465D64F" />
+    <EventProvider Id="livessp_WPP" Name="C10B942D-AE1B-4786-BC66-052E5B4BE40E" />
+    <EventProvider Id="LsaAudit_WPP" Name="DAA76F6A-2D11-4399-A646-1D62B7380F15" />
+    <EventProvider Id="LsaDs_WPP" Name="169EC169-5B77-4A3E-9DB6-441799D5CACB" />
+    <EventProvider Id="LsaIso_WPP" Name="366B218A-A5AA-4096-8131-0BDAFCC90E93" />
+    <EventProvider Id="LsaTrace_WPP" Name="D0B639E0-E650-4D1D-8F39-1580ADE72784" />
+    <EventProvider Id="lxcore_kernel" Name="0CD1C309-0878-4515-83DB-749843B3F5C9"/>
+    <EventProvider Id="lxcore_service" Name="B99CDB5A-039C-5046-E672-1A0DE0A40211"/>
+    <EventProvider Id="lxcore_user" Name="D90B9468-67F0-5B3B-42CC-82AC81FFD960"/>
+    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_GetConnected" Name="60523747-6516-48B7-84B1-3264FA2CB359" />
+    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_OnDemand" Name="ABB1FC61-49BA-4CC3-809F-7ABE1F8BA315" />
+    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_RoutePolicyManagement" Name="923C0FFD-7933-4B52-8A49-121ABF2DC357" />
+    <EventProvider Id="Microsoft_OSG_OSS_CredProvFramework_ReportResultStop_WPP" Name="8DB3086D-116F-5BED-CFD5-9AFDA80D28EA" />
+    <EventProvider Id="Microsoft_OSG_Wininet_WPP" Name="1A211EE8-52DB-4AF0-BB66-FB8C9F20B0E2" />
+    <EventProvider Id="Microsoft_Quic_ETW" Name="ff15e657-4f26-570e-88ab-0796b258d11c" />
+    <EventProvider Id="Microsoft_Web_Platform_WPP" Name="FF32ADA1-5A4B-583C-889E-A3C027B201F5" />
+    <EventProvider Id="Microsoft_Windows_AppModel_Exec_WPP" Name="EB65A492-86C0-406A-BACE-9912D595BD69" />
+    <EventProvider Id="Microsoft_Windows_BranchCacheClientEventProvider" Name="e837619c-a2a8-4689-833f-47b48ebd2442" />
+    <EventProvider Id="Microsoft_Windows_BranchCacheEventProvider" Name="dd85457f-4e2d-44a5-a7a7-6253362e34dc" />
+    <EventProvider Id="Microsoft_Windows_BrokerInfrastructure_WPP" Name="63B6C2D2-0440-44DE-A674-AA51A251B123" />
+    <EventProvider Id="Microsoft_Windows_CAPI2_WPP" Name="5BBCA4A8-B209-48DC-A8C7-B23D3E5216FB" />
+    <EventProvider Id="Microsoft_Windows_CertificateServices_Deployment_WPP" Name="B2D1F576-2E85-4489-B504-1861C40544B3" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_AutoEnrollment_WPP" Name="F0DB7EF8-B6F3-4005-9937-FEB77B9E1B43" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_CertEnroll_WPP" Name="54164045-7C50-4905-963F-E5BC1EEF0CCA" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_CredentialRoaming_WPP" Name="89A2278B-C662-4AFF-A06C-46AD3F220BCA" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_Lifecycle_System_WPP" Name="BC0669E1-A10D-4A78-834E-1CA3C806C93B" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_Lifecycle_User_WPP" Name="BEA18B89-126F-4155-9EE4-D36038B02680" />
+    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_WPP" Name="73370BD6-85E5-430B-B60A-FEA1285808A7" />
+    <EventProvider Id="Microsoft_Windows_CertificationAuthorityClient_CertCli_WPP" Name="98BF1CD3-583E-4926-95EE-A61BF3F46470" />
+    <EventProvider Id="Microsoft_Windows_CertPolEng_WPP" Name="AF9CC194-E9A8-42BD-B0D1-834E9CFAB799" />
+    <EventProvider Id="Microsoft_Windows_DeviceManagement_Enterprise_Diagnostics_Provider_WPP" Name="3DA494E4-0FE2-415C-B895-FB5265C5C83B" />
+    <EventProvider Id="Microsoft_Windows_DeviceManagement_SCEP_WPP" Name="D5A5B540-C580-4DEE-8BB4-185E34AA00C5" />
+    <EventProvider Id="Microsoft_Windows_DM_Enrollment_Provider_WPP" Name="9FBF7B95-0697-4935-ADA2-887BE9DF12BC" />
+    <EventProvider Id="Microsoft_Windows_DNS_Client" Name="1c95126e-7eea-49a9-a3fe-a378b03ddb4d" />
+    <EventProvider Id="Microsoft_Windows_DNS_Client_Configuration_PowerShell" Name="563a50d8-3536-4c8a-a361-b37af04094ec" />
+    <EventProvider Id="Microsoft_Windows_DNS_Client_WinRNR" Name="b923f87a-b069-42b5-bd32-35623aba1c48" />
+    <EventProvider Id="Microsoft_Windows_HttpService" Name="dd5ef90a-6398-47a4-ad34-4dcecdef795f" />
+    <EventProvider Id="Microsoft_Windows_LiveId_WPP" Name="05F02597-FE85-4E67-8542-69567AB8FD4F" />
+    <EventProvider Id="Microsoft_Windows_MicrosoftAccount_TBProvider_WPP" Name="5836994D-A677-53E7-1389-588AD1420CC5" />
+    <EventProvider Id="Microsoft_Windows_ProcessStateManager_WPP" Name="D49918CF-9489-4BF1-9D7B-014D864CF71F" />
+    <EventProvider Id="Microsoft_Windows_ResourceManager_WPP" Name="4180C4F7-E238-5519-338F-EC214F0B49AA" />
+    <EventProvider Id="Microsoft_Windows_Runtime_Web_Http" Name="41877cb4-11fc-4188-b590-712c143c881d" />
+    <EventProvider Id="Microsoft_Windows_Security_AADAuthHelper_WPP" Name="9EBB3B15-B094-41B1-A3B8-0F141B06BADD" />
+    <EventProvider Id="Microsoft_Windows_Security_AADCloudAPPlugin_WPP" Name="556045FD-58C5-4A97-9881-B121F68B79C5" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_BioCredProv_WPP" Name="9DADD79B-D556-53F2-67C4-129FA62B7512" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Client_WPP" Name="1B5106B1-7622-4740-AD81-D9C6EE74F124" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_CredentialProvider_Face_WPP" Name="1D480C11-3870-4B19-9144-47A53CD973BD" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_FingerprintCredential_WPP" Name="225B3FED-0356-59D1-1F82-EED163299FA8" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Service_WPP" Name="39A5AA08-031D-4777-A32D-ED386BF03470" />
+    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Trustlet_WPP" Name="9DF19CFA-E122-5343-284B-F3945CCD65B2" />
+    <EventProvider Id="Microsoft_Windows_Security_Credentials_UserConsentVerifier_WPP" Name="507C53AE-AF42-5938-AEDE-4A9D908640ED" />
+    <EventProvider Id="Microsoft_Windows_Security_DevCredClient_WPP" Name="78983C7D-917F-58DA-E8D4-F393DECF4EC0" />
+    <EventProvider Id="Microsoft_Windows_Security_DevCredProv_WPP" Name="7955D36A-450B-5E2A-A079-95876BCA450A" />
+    <EventProvider Id="Microsoft_Windows_Security_DevCredSvc_WPP" Name="C3FEB5BF-1A8D-53F3-AAA8-44496392BF69" />
+    <EventProvider Id="Microsoft_Windows_Security_DevCredTask_WPP" Name="86D5FE65-0564-4618-B90B-E146049DEBF4" />
+    <EventProvider Id="Microsoft_Windows_Security_DevCredWinRt_WPP" Name="36FF4C84-82A2-4B23-8BA5-A25CBDFF3410" />
+    <EventProvider Id="Microsoft_Windows_Security_DeviceLock_WPP" Name="2056054C-97A6-5AE4-B181-38BC6B58007E" />
+    <EventProvider Id="Microsoft_Windows_Security_Fido_WPP" Name="08B15CE7-C9FF-5E64-0D16-66589573C50F" />
+    <EventProvider Id="Microsoft_Windows_Security_LsaSrv_WPP" Name="4D9DFB91-4337-465A-A8B5-05A27D930D48" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_CredProv_WPP" Name="CAC8D861-7B16-5B6B-5FC0-85014776BDAC" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_CryptNgc_WPP" Name="6D7051A0-9C83-5E52-CF8F-0ECAF5D5F6FD" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_CSP_WPP" Name="89F392FF-EE7C-56A3-3F61-2D5B31A36935" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_KeyCredMgr_WPP" Name="34646397-1635-5D14-4D2C-2FEBDCCCF5E9" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_KeyStaging_WPP" Name="9B223F67-67A1-5B53-9126-4593FE81DF25" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_KspSvc_WPP" Name="B66B577F-AE49-5CCF-D2D7-8EB96BFD440C" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_Local_WPP" Name="3B9DBF69-E9F0-5389-D054-A94BC30E33F7" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_LocalAccountMigPlugin_WPP" Name="CDD94AC7-CD2F-5189-E126-2DEB1B2FACBF" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcCtnr_WPP" Name="0ABA6892-455B-551D-7DA8-3A8F85225E1A" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcCtnrSvc_WPP" Name="9DF6A82D-5174-5EBF-842A-39947C48BF2A" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcIsoCtnr_WPP" Name="CDC6BEB9-6D78-5138-D232-D951916AB98F" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_PopKeySrv_WPP" Name="1D6540CE-A81B-4E74-AD35-EEF8463F97F5" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_Recovery_WPP" Name="9D4CA978-8A14-545E-C047-A45991F0E92F" />
+    <EventProvider Id="Microsoft_Windows_Security_NGC_Trustlet_WPP" Name="C0B2937D-E634-56A2-1451-7D678AA3BC53" />
+    <EventProvider Id="Microsoft_Windows_Security_TokenBroker_WPP" Name="077B8C4A-E425-578D-F1AC-6FDF1220FF68" />
+    <EventProvider Id="Microsoft_Windows_Shell_CloudDomainJoin_Client_WPP" Name="AA02D1A4-72D8-5F50-D425-7402EA09253A" />
+    <EventProvider Id="Microsoft_Windows_Shell_CloudExperienceHost_WPP" Name="D0034F5E-3686-5A74-DC48-5A22DD4F3D5B" />
+    <EventProvider Id="Microsoft_Windows_WBioSrvc_WPP" Name="34BEC984-F11F-4F1F-BB9B-3BA33C8D0132" />
+    <EventProvider Id="Microsoft_Windows_WebIO" Name="50b3e73c-9370-461d-bb9f-26f32d68887d" />
+    <EventProvider Id="Microsoft_Windows_WinHttp" Name="7d44233d-3055-4b9c-ba64-0d47ca40a232" />
+    <EventProvider Id="Microsoft_Windows_WinINet" Name="43d1a55c-76d6-4f7e-995c-64c711e5cafe" />
+    <EventProvider Id="Microsoft_Windows_Winsock_NameResolution" Name="55404E71-4DB9-4DEB-A5F5-8F86E46DDE56" />
+    <EventProvider Id="Microsoft-Windows-DHCP-Client" Name="15A7A4F8-0072-4EAB-ABAD-F98A4D666AED" />
+    <EventProvider Id="Microsoft-Windows-DHCPv6-Client" Name="6A1F2B00-6A90-4C38-95A5-5CAB3B056778" />
+    <EventProvider Id="Microsoft-Windows-Host-Network-Management" Name="93f693dc-9163-4dee-af64-d855218af242" />
+    <EventProvider Id="Microsoft-Windows-Hyper-V-VfpExt" Name="9F2660EA-CFE7-428F-9850-AECA612619B0"/>
+    <EventProvider Id="Microsoft-Windows-Hyper-V-VmSwitch" Name="67DC0D66-3695-47C0-9642-33F76F7BD7AD"/>
+    <EventProvider Id="Microsoft-Windows-HyperV-Vid" Name="5931D877-4860-4ee7-A95C-610A5F0D1407" NonPagedMemory="true" />
+    <EventProvider Id="Microsoft-Windows-Overlay-HNSPlugin" Name="564368D6-577B-4af5-AD84-1C54464848E6" />
+    <EventProvider Id="Microsoft-Windows-SharedAccess_NAT" Name="A6F32731-9A38-4159-A220-3D9B7FC5FE5D" />
+    <EventProvider Id="Microsoft-Windows-TCPIP" Name="2f07e2ee-15db-40f1-90ef-9d7ba282188a" NonPagedMemory="true" EventKey="true" Strict="true"/>
+    <EventProvider Id="Microsoft-Windows-WinNat" Name="66C07ECD-6667-43FC-93F8-05CF07F446EC" />
+    <EventProvider Id="Microsoft.Windows.HostNetworkingService.PrivateCloudPlugin" Name="D0E4BC17-34C7-43fc-9A72-D89A59D6979A" />
+    <EventProvider Id="Microsoft.Windows.Hyper.V.NetSetupHelper" Name="94DEB9D1-0A52-449B-B368-41E4426B4F36"/>
+    <EventProvider Id="Microsoft.Windows.Hyper.V.VmsIf" Name="6C28C7E5-331B-4437-9C69-5352A2F7F296" />
+    <EventProvider Id="Microsoft.Windows.HyperV.Compute" Name="80CE50DE-D264-4581-950D-ABADEEE0D340" />
+    <EventProvider Id="Microsoft.Windows.HyperV.Socket" Name="b2ed3bdb-cd74-5b2c-f660-85079ca074b3"/>
+    <EventProvider Id="Microsoft.Windows.HyperV.Vid" Name="1111450B-DACC-40A3-84AB-F7DBA4A6E63A" NonPagedMemory="true"/>
+    <EventProvider Id="Microsoft.Windows.Networking.FlowSteering" Name="662abf07-6dda-5b25-c2c5-345236dbb2d2"/>
+    <EventProvider Id="mpssvcService" Name="5EEFEBDB-E90C-423a-8ABF-0241E7C5B87D" />
+    <EventProvider Id="MsQuic_WPP" Name="620FD025-BE51-42EF-A5C0-50F13F183AD9" />
+    <EventProvider Id="msxml_WPP" Name="927821F8-D9E6-42E2-84F2-949E18256F3A" />
+    <EventProvider Id="mup" Name="20c46239-d059-4214-a11e-7d6769cbe020" />
+    <EventProvider Id="NCRYPT_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473301" />
+    <EventProvider Id="NCRYPTSSLP_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473304" />
+    <EventProvider Id="ndis_wpp" Name="DD7A21E6-A651-46D4-B7C2-66543067B869"/>
+    <EventProvider Id="negoexts_WPP" Name="5AF52B0D-E633-4EAD-828A-4B85B8DAAC2B" />
+    <EventProvider Id="Netio_WPP" Name="EB004A05-9B1A-11D4-9123-0050047759BC" />
+    <EventProvider Id="netmgmt" Name="93f693dc-9163-4dee-af64-d855218af242" />
+    <EventProvider Id="ntlm_WPP" Name="5BBB6C18-AA45-49B1-A15F-085F7ED0AA90" />
+    <EventProvider Id="NtlmShared_WPP" Name="AC69AE5B-5B21-405F-8266-4424944A43E9" />
+    <EventProvider Id="p9rdr" Name="bb1d36f0-e0e0-48cc-9493-fef0e3d0b28c" NonPagedMemory="true" Strict="true"/>
+    <EventProvider Id="pku2u_WPP" Name="2A6FAF47-5449-4805-89A3-A504F3E221A6" />
+    <EventProvider Id="PortTrackerServer_WPP" Name="090bf343-4490-42d3-b273-8af174d314fb" />
+    <EventProvider Id="rfsmon" Name="51734B23-5B7E-4892-BA8E-45BC110B735C" />
+    <EventProvider Id="SharedAccessWPP" Name="9B322459-4AD9-4F81-8EEA-DC77CDD18CA6" />
+    <EventProvider Id="storvsp" Name="10b3d268-9782-49a4-aacc-a93c5482cb6f" NonPagedMemory="true" Level="4">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="storvsp_io" Name="10b3d268-9782-49a4-aacc-a93c5482cb6f" NonPagedMemory="true">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="storvsp_wpp" Name="f96abc17-6a5e-4a49-a3f4-a2a86fa03846" NonPagedMemory="true" Level="4">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="TLS_WPP" Name="37D2C3CD-C5D4-4587-8531-4696C44244C8" />
+    <EventProvider Id="TokenBinding_WPP" Name="AEF66A73-A765-4421-B348-B7E0FC8C9898" />
+    <EventProvider Id="TPM_WPP" Name="3A8D6942-B034-48E2-B314-F69C2B4655A3" />
+    <EventProvider Id="UrlMon_WPP" Name="3FAB3162-24CE-4ED5-B23D-63501544E11D" />
+    <EventProvider Id="vault_WPP" Name="7FDD167C-79E5-4403-8C84-B7C0BB9923A1" />
+    <EventProvider Id="vfpext" Name="9F2660EA-CFE7-428F-9850-AECA612619B0" />
+    <EventProvider Id="vhdmp" Name="E2816346-87F4-4F85-95C3-0C79409AA89D" NonPagedMemory="true" Level="4">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFD" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="vhdmp_wpp" Name="3c70c3b0-2fae-41d3-b68d-8f7fcaf79adb" NonPagedMemory="true" Level="5">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="virtdisk" Name="4D20DF22-E177-4514-A369-F1759FEEDEB3" Level="4">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="virtdisk_wpp" Name="e14dcdd9-d1ec-4dc3-8395-a606df8ef115" Level="4">
+      <Keywords>
+        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
+      </Keywords>
+    </EventProvider>
+    <EventProvider Id="vm_chipset" Name="de9ba731-7f33-4f44-98c9-6cac856b9f83"/>
+    <EventProvider Id="vmcompute" Name="17103E3F-3C6E-4677-BB17-3B267EB5BE57"/>
+    <EventProvider Id="vmcompute_dll" Name="AF7FD3A7-B248-460C-A9F5-FEC39EF8468C"/>
+    <EventProvider Id="vmmm" Name="6066F867-7CA1-4418-85FD-36E3F9C0600C"/>
+    <EventProvider Id="VmSwitch_wpp" Name="1F387CBC-6818-4530-9DB6-5F1058CD7E86"/>
+    <EventProvider Id="vmwp" Name="51DDFA29-D5C8-4803-BE4B-2ECB715570FE"/>
+    <EventProvider Id="webauth_WPP" Name="EF98103D-8D3A-4BEF-9DF2-2156563E64FA" />
+    <EventProvider Id="Webio_WPP" Name="08F93B14-1608-4A72-9CFA-457EECEDBBA7" />
+    <EventProvider Id="webplatform_WPP" Name="2A3C6602-411E-4DC6-B138-EA19D64F5BBA" />
+    <EventProvider Id="WinHttp_WPP" Name="B3A7698A-0C45-44DA-B73D-E181C9B5C8E6" />
+    <EventProvider Id="Wininet_WPP" Name="4E749B6A-667D-4C72-80EF-373EE3246B08" />
+    <EventProvider Id="WinNatSys" Name="aa7387cf-3639-496a-b3bf-dc1e79a6fc5a" />
+    <EventProvider Id="Winsock_WPP" Name="1D44957B-7181-4835-B70A-D0B16112A4DE" />
+    <EventProvider Id="wlidsvc_WPP" Name="3F8B9EF5-BBD2-4C81-B6C9-DA3CDB72D3C5" />
+    <EventProvider Id="wsl_devicehost" Name="9d6c7b9e-2581-4d8a-b8c5-b90b4a17094a"/>
+    <EventProvider Id="wslapi" Name="beb94edf-1a7b-5058-0696-ff9e6b1798d1"/>
+    <EventProvider Id="wslaservice" Name="0383CE62-8F86-4766-AFB2-9D66A7FB1E90"/>
+    <EventProvider Id="wslclient" Name="8cbb7724-7223-5d6f-8137-564dac45104d"/>
 
+    <!-- PROFILE: General WSL Tracing (Default, also serves as base for other profiles) -->
     <Profile
       Id="WSL.Verbose.File"
       Name="WSL"
-      Description="Traces for all WSL components"
+      Description="General traces for WSL components"
       LoggingMode="File"
       DetailLevel="Verbose"
       >
       <Collectors>
         <EventCollectorId Value="Collector">
           <EventProviders>
-            <EventProviderId Value="lxcore_kernel"/>
-            <EventProviderId Value="lxcore_user"/>
-            <EventProviderId Value="lxcore_service"/>
-            <EventProviderId Value="wsl_devicehost"/>
-            <EventProviderId Value="wslclient"/>
-            <EventProviderId Value="wslapi"/>
-            <EventProviderId Value="vm_chipset"/>
-            <EventProviderId Value="vmcompute_dll"/>
-            <EventProviderId Value="vmcompute"/>
-            <EventProviderId Value="vmmm"/>
-            <EventProviderId Value="vmwp"/>
             <EventProviderId Value="9p"/>
             <EventProviderId Value="9p_errors"/>
-            <EventProviderId Value="p9rdr"/>
-            <EventProviderId Value="mup"/>
-            <EventProviderId Value="rfsmon"/>
-            <EventProviderId Value="hyperv_storage"/>
-            <EventProviderId Value="hns"/>
-            <EventProviderId Value="netmgmt"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.EMPS.Enrollment"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.AppDownload"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.Datastore"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.PhoneProvisioner"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.PPOEM"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.API"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.CommandCsp"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.CSP"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Engine"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Handlers"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Migration"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Platform"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Operations"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Platform"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Plugin.Engine"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Plugin.RemovableMedia"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.ProvTool"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Operations"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.CommandCsp"/>
             <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.ProvLaunch"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.EMPS.Enrollment"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment"/>
-            <EventProviderId Value="virtdisk"/>
-            <EventProviderId Value="virtdisk_wpp"/>
-            <EventProviderId Value="vhdmp"/>
-            <EventProviderId Value="vhdmp_wpp"/>
-            <EventProviderId Value="storvsp"/>
-            <EventProviderId Value="HyperV_SyntheticStorage"/>
-            <EventProviderId Value="HyperV_EmulatedStorage"/>
+            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.ProvTool"/>
             <EventProviderId Value="EventProvider_Telemetry_StorVSP"/>
             <EventProviderId Value="EventProvider_Trace_Vhdmp"/>
+            <EventProviderId Value="hns"/>
+            <EventProviderId Value="HyperV_EmulatedStorage"/>
+            <EventProviderId Value="hyperv_storage"/>
+            <EventProviderId Value="HyperV_SyntheticStorage"/>
+            <EventProviderId Value="lxcore_kernel"/>
+            <EventProviderId Value="lxcore_service"/>
+            <EventProviderId Value="lxcore_user"/>
+            <EventProviderId Value="Microsoft-Windows-HyperV-Vid"/>
+            <EventProviderId Value="Microsoft.Windows.HyperV.Vid"/>
+            <EventProviderId Value="mup"/>
+            <EventProviderId Value="netmgmt"/>
+            <EventProviderId Value="p9rdr"/>
+            <EventProviderId Value="rfsmon"/>
+            <EventProviderId Value="storvsp"/>
+            <EventProviderId Value="vfpext"/>
+            <EventProviderId Value="vhdmp"/>
+            <EventProviderId Value="vhdmp_wpp"/>
+            <EventProviderId Value="virtdisk"/>
+            <EventProviderId Value="virtdisk_wpp"/>
+            <EventProviderId Value="vm_chipset"/>
+            <EventProviderId Value="vmcompute"/>
+            <EventProviderId Value="vmcompute_dll"/>
+            <EventProviderId Value="vmmm"/>
+            <EventProviderId Value="vmwp"/>
+            <EventProviderId Value="wsl_devicehost"/>
+            <EventProviderId Value="wslapi"/>
+            <EventProviderId Value="wslaservice"/>
+            <EventProviderId Value="wslclient"/>
           </EventProviders>
         </EventCollectorId>
       </Collectors>
     </Profile>
+
+    <!-- PROFILE: Storage-focused WSL Tracing -->
+    <Profile
+      Id="WSL-Storage.Verbose.File"
+      Name="WSL-Storage"
+      Description="WSL traces with enhanced storage providers"
+      LoggingMode="File"
+      DetailLevel="Verbose"
+      Base="WSL.Verbose.File"
+      >
+      <Collectors>
+        <EventCollectorId Value="Collector">
+          <EventProviders>
+            <!-- Additional storage-specific providers -->
+            <EventProviderId Value="storvsp_io"/>
+            <EventProviderId Value="storvsp_wpp"/>
+          </EventProviders>
+        </EventCollectorId>
+      </Collectors>
+    </Profile>
+
+    <!-- PROFILE: Networking-focused WSL Tracing -->
+    <Profile
+      Id="WSL-Networking.Verbose.File"
+      Name="WSL-Networking"
+      Description="WSL traces with comprehensive networking providers"
+      LoggingMode="File"
+      DetailLevel="Verbose"
+      Base="WSL.Verbose.File"
+      >
+      <Collectors>
+        <EventCollectorId Value="Collector">
+          <EventProviders>
+            <!-- Additional networking-specific providers -->
+            <EventProviderId Value="aad_WPP"/>
+            <EventProviderId Value="basecsp_WPP"/>
+            <EventProviderId Value="BCRYPT_WPP"/>
+            <EventProviderId Value="BFE_WPP"/>
+            <EventProviderId Value="CAPI1_WPP"/>
+            <EventProviderId Value="CHAT_WPP"/>
+            <EventProviderId Value="cloudap_WPP"/>
+            <EventProviderId Value="CNG_WPP"/>
+            <EventProviderId Value="credssp_WPP"/>
+            <EventProviderId Value="CRYPTOWINRT_WPP"/>
+            <EventProviderId Value="dclocator_WPP"/>
+            <EventProviderId Value="digest_WPP"/>
+            <EventProviderId Value="DNS_WPP"/>
+            <EventProviderId Value="dpapis_WPP"/>
+            <EventProviderId Value="gMSAClient_WPP"/>
+            <EventProviderId Value="HTTP_sys_WPP"/>
+            <EventProviderId Value="idcommon_WPP"/>
+            <EventProviderId Value="idlisten_WPP"/>
+            <EventProviderId Value="idstore_WPP"/>
+            <EventProviderId Value="IPNat"/>
+            <EventProviderId Value="kdc_WPP"/>
+            <EventProviderId Value="kerb_WPP"/>
+            <EventProviderId Value="KerbClientShared_WPP"/>
+            <EventProviderId Value="KerbComm_WPP"/>
+            <EventProviderId Value="kps_WPP"/>
+            <EventProviderId Value="livessp_WPP"/>
+            <EventProviderId Value="LsaAudit_WPP"/>
+            <EventProviderId Value="LsaDs_WPP"/>
+            <EventProviderId Value="LsaIso_WPP"/>
+            <EventProviderId Value="LsaTrace_WPP"/>
+            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_GetConnected"/>
+            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_OnDemand"/>
+            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_RoutePolicyManagement"/>
+            <EventProviderId Value="Microsoft_OSG_OSS_CredProvFramework_ReportResultStop_WPP"/>
+            <EventProviderId Value="Microsoft_OSG_Wininet_WPP"/>
+            <EventProviderId Value="Microsoft_Quic_ETW"/>
+            <EventProviderId Value="Microsoft_Web_Platform_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_AppModel_Exec_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_BranchCacheClientEventProvider"/>
+            <EventProviderId Value="Microsoft_Windows_BranchCacheEventProvider"/>
+            <EventProviderId Value="Microsoft_Windows_BrokerInfrastructure_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CAPI2_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServices_Deployment_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_AutoEnrollment_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_CertEnroll_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_CredentialRoaming_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_Lifecycle_System_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_Lifecycle_User_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertificationAuthorityClient_CertCli_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_CertPolEng_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_DeviceManagement_Enterprise_Diagnostics_Provider_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_DeviceManagement_SCEP_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_DM_Enrollment_Provider_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_DNS_Client"/>
+            <EventProviderId Value="Microsoft_Windows_DNS_Client_Configuration_PowerShell"/>
+            <EventProviderId Value="Microsoft_Windows_DNS_Client_WinRNR"/>
+            <EventProviderId Value="Microsoft_Windows_HttpService"/>
+            <EventProviderId Value="Microsoft_Windows_LiveId_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_MicrosoftAccount_TBProvider_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_ProcessStateManager_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_ResourceManager_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Runtime_Web_Http"/>
+            <EventProviderId Value="Microsoft_Windows_Security_AADAuthHelper_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_AADCloudAPPlugin_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_BioCredProv_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Client_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_CredentialProvider_Face_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_FingerprintCredential_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Service_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Trustlet_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Credentials_UserConsentVerifier_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DevCredClient_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DevCredProv_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DevCredSvc_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DevCredTask_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DevCredWinRt_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_DeviceLock_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_Fido_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_LsaSrv_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_CredProv_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_CryptNgc_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_CSP_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_KeyCredMgr_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_KeyStaging_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_KspSvc_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_Local_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_LocalAccountMigPlugin_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcCtnr_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcCtnrSvc_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcIsoCtnr_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_PopKeySrv_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_Recovery_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_NGC_Trustlet_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Security_TokenBroker_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Shell_CloudDomainJoin_Client_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_Shell_CloudExperienceHost_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_WBioSrvc_WPP"/>
+            <EventProviderId Value="Microsoft_Windows_WebIO"/>
+            <EventProviderId Value="Microsoft_Windows_WinHttp"/>
+            <EventProviderId Value="Microsoft_Windows_WinINet"/>
+            <EventProviderId Value="Microsoft_Windows_Winsock_NameResolution"/>
+            <EventProviderId Value="Microsoft-Windows-DHCP-Client"/>
+            <EventProviderId Value="Microsoft-Windows-DHCPv6-Client"/>
+            <EventProviderId Value="Microsoft-Windows-Host-Network-Management"/>
+            <EventProviderId Value="Microsoft-Windows-Hyper-V-VfpExt"/>
+            <EventProviderId Value="Microsoft-Windows-Hyper-V-VmSwitch"/>
+            <EventProviderId Value="Microsoft-Windows-Overlay-HNSPlugin"/>
+            <EventProviderId Value="Microsoft-Windows-SharedAccess_NAT"/>
+            <EventProviderId Value="Microsoft-Windows-TCPIP"/>
+            <EventProviderId Value="Microsoft-Windows-WinNat"/>
+            <EventProviderId Value="Microsoft.Windows.HostNetworkingService.PrivateCloudPlugin"/>
+            <EventProviderId Value="Microsoft.Windows.Hyper.V.NetSetupHelper"/>
+            <EventProviderId Value="Microsoft.Windows.Hyper.V.VmsIf"/>
+            <EventProviderId Value="Microsoft.Windows.HyperV.Compute"/>
+            <EventProviderId Value="Microsoft.Windows.HyperV.Socket"/>
+            <EventProviderId Value="Microsoft.Windows.Networking.FlowSteering"/>
+            <EventProviderId Value="mpssvcService"/>
+            <EventProviderId Value="MsQuic_WPP"/>
+            <EventProviderId Value="msxml_WPP"/>
+            <EventProviderId Value="NCRYPT_WPP"/>
+            <EventProviderId Value="NCRYPTSSLP_WPP"/>
+            <EventProviderId Value="ndis_wpp"/>
+            <EventProviderId Value="negoexts_WPP"/>
+            <EventProviderId Value="Netio_WPP"/>
+            <EventProviderId Value="ntlm_WPP"/>
+            <EventProviderId Value="NtlmShared_WPP"/>
+            <EventProviderId Value="pku2u_WPP"/>
+            <EventProviderId Value="PortTrackerServer_WPP"/>
+            <EventProviderId Value="SharedAccessWPP"/>
+            <EventProviderId Value="TLS_WPP"/>
+            <EventProviderId Value="TokenBinding_WPP"/>
+            <EventProviderId Value="TPM_WPP"/>
+            <EventProviderId Value="UrlMon_WPP"/>
+            <EventProviderId Value="vault_WPP"/>
+            <EventProviderId Value="VmSwitch_wpp"/>
+            <EventProviderId Value="webauth_WPP"/>
+            <EventProviderId Value="Webio_WPP"/>
+            <EventProviderId Value="webplatform_WPP"/>
+            <EventProviderId Value="WinHttp_WPP"/>
+            <EventProviderId Value="Wininet_WPP"/>
+            <EventProviderId Value="WinNatSys"/>
+            <EventProviderId Value="Winsock_WPP"/>
+            <EventProviderId Value="wlidsvc_WPP"/>
+          </EventProviders>
+        </EventCollectorId>
+      </Collectors>
+    </Profile>
+
+    <!-- PROFILE: HvSocket-focused WSL Tracing -->
+    <Profile
+      Id="WSL-HvSocket.Verbose.File"
+      Name="WSL-HvSocket"
+      Description="WSL traces with HvSocket-specific providers"
+      LoggingMode="File"
+      DetailLevel="Verbose"
+      Base="WSL.Verbose.File"
+      >
+      <Collectors>
+        <EventCollectorId Value="Collector">
+          <EventProviders>
+            <!-- Additional providers specific to HvSocket profile -->
+            <EventProviderId Value="EventProvider_HvSocketTraceProvider"/>
+          </EventProviders>
+        </EventCollectorId>
+      </Collectors>
+    </Profile>
+
   </Profiles>
-</WindowsPerformanceRecorder>
+</WindowsPerformanceRecorder>

diagnostics/wsl_networking.wprp

@@ -1,410 +0,0 @@
-<?xml version="1.0"?>
-<WindowsPerformanceRecorder Version="1">
-  <Profiles>
-    <EventCollector Id="Collector" Name="Collector">
-      <BufferSize Value="256"/>
-      <Buffers Value="4096"/>
-    </EventCollector>
-
-    <EventProvider Id="lxcore_kernel" Name="0CD1C309-0878-4515-83DB-749843B3F5C9"/>
-    <EventProvider Id="lxcore_user" Name="D90B9468-67F0-5B3B-42CC-82AC81FFD960"/>
-    <EventProvider Id="lxcore_service" Name="B99CDB5A-039C-5046-E672-1A0DE0A40211"/>
-    <EventProvider Id="wsl_devicehost" Name="9d6c7b9e-2581-4d8a-b8c5-b90b4a17094a"/>
-    <EventProvider Id="wslclient" Name="8cbb7724-7223-5d6f-8137-564dac45104d"/>
-    <EventProvider Id="vm_chipset" Name="de9ba731-7f33-4f44-98c9-6cac856b9f83"/>
-    <EventProvider Id="vmcompute_dll" Name="AF7FD3A7-B248-460C-A9F5-FEC39EF8468C"/>
-    <EventProvider Id="vmcompute" Name="17103E3F-3C6E-4677-BB17-3B267EB5BE57"/>
-    <EventProvider Id="vmmm" Name="6066F867-7CA1-4418-85FD-36E3F9C0600C"/>
-    <EventProvider Id="vmwp" Name="51DDFA29-D5C8-4803-BE4B-2ECB715570FE"/>
-    <EventProvider Id="9p" Name="e13c8d52-b153-571f-78c5-1d4098af2a1e"/>
-    <EventProvider Id="9p_errors" Name="06C601B3-6957-4F8C-A15F-74875B24429D" />
-    <EventProvider Id="p9rdr" Name="bb1d36f0-e0e0-48cc-9493-fef0e3d0b28c" />
-    <EventProvider Id="mup" Name="20c46239-d059-4214-a11e-7d6769cbe020" />
-    <EventProvider Id="rfsmon" Name="51734B23-5B7E-4892-BA8E-45BC110B735C" />
-    <EventProvider Id="hyperv_storage" Name="c7ad62c6-5c99-5a1b-bbc4-0821ae5b765e" />
-    <EventProvider Id="hns" Name="0c885e0d-6eb6-476c-a048-2457eed3a5c1" />
-    <EventProvider Id="netmgmt" Name="93f693dc-9163-4dee-af64-d855218af242" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.AppDownload" Name="0BBE6221-EF09-4A3F-82EE-BE00DBB6A98A" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.Datastore" Name="42C60CEA-0FE7-4541-A86B-9E11F95BD9BF" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.PhoneProvisioner" Name="B876B1FC-C7F1-443E-9012-86677F7DE580" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Mobile.Provisioning.PPOEM" Name="7EDBED09-1FF7-4FEE-B8C3-5DB694420830" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.API" Name="82ADD491-01D7-4B85-9EAD-192C3CAACA23" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.CSP" Name="16E12400-A2D8-44B7-9479-004568EC7819" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Engine" Name="A6A847B7-4429-49AA-BBA6-2AD8C191AC8C" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Handlers" Name="0383D92C-2337-4F25-A0B5-A51767F04746" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Migration" Name="A0AF985E-83F9-4E1A-B658-338DCFE27893" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Operations" Name="7F99598F-B2C1-4371-9911-63DEE13B9EB1" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Platform" Name="B1F30020-8BC3-4888-BB1B-4DD681F24209" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Plugin.Engine" Name="55239D60-0EB6-495B-874E-15DE5D5F9A70" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.Plugin.RemovableMedia" Name="B55883E6-6C45-45C2-AB9D-800BB7B66B13" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.ProvTool" Name="2BF4B6BA-556E-4D05-8534-CAFEDF19FED8" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.CommandCsp" Name="00BB69FC-60BC-4502-9438-25608F375CCB" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.Provisioning.ProvLaunch" Name="08FACCFA-125D-4ED6-B0B7-B4A1A912E693" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.EMPS.Enrollment" Name="E74EFD1A-B62D-4B83-AB00-66F4A166A2D3" />
-    <EventProvider Id="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment" Name="F9E3B648-9AF1-4DC3-9A8E-BF42C0FBCE9A" />
-    <EventProvider Id="virtdisk_wpp" Name="e14dcdd9-d1ec-4dc3-8395-a606df8ef115" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="virtdisk" Name="4D20DF22-E177-4514-A369-F1759FEEDEB3" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-     <EventProvider Id="vhdmp" Name="E2816346-87F4-4F85-95C3-0C79409AA89D" NonPagedMemory="true" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFD" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="vhdmp_wpp" Name="3c70c3b0-2fae-41d3-b68d-8f7fcaf79adb" NonPagedMemory="true" Level="5">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-    <EventProvider Id="LsaAudit_WPP" Name="DAA76F6A-2D11-4399-A646-1D62B7380F15" />
-    <EventProvider Id="Microsoft_Windows_ResourceManager_WPP" Name="4180C4F7-E238-5519-338F-EC214F0B49AA" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_KeyCredMgr_WPP" Name="34646397-1635-5D14-4D2C-2FEBDCCCF5E9" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcIsoCtnr_WPP" Name="CDC6BEB9-6D78-5138-D232-D951916AB98F" />
-    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_OnDemand" Name="ABB1FC61-49BA-4CC3-809F-7ABE1F8BA315" />
-    <EventProvider Id="wlidsvc_WPP" Name="3F8B9EF5-BBD2-4C81-B6C9-DA3CDB72D3C5" />
-    <EventProvider Id="Microsoft_Windows_WebIO" Name="50b3e73c-9370-461d-bb9f-26f32d68887d" />
-    <EventProvider Id="msxml_WPP" Name="927821F8-D9E6-42E2-84F2-949E18256F3A" />
-    <EventProvider Id="Microsoft_Windows_HttpService" Name="dd5ef90a-6398-47a4-ad34-4dcecdef795f" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_Trustlet_WPP" Name="C0B2937D-E634-56A2-1451-7D678AA3BC53" />
-    <EventProvider Id="Microsoft_Web_Platform_WPP" Name="FF32ADA1-5A4B-583C-889E-A3C027B201F5" />
-    <EventProvider Id="Microsoft_Windows_Shell_CloudDomainJoin_Client_WPP" Name="AA02D1A4-72D8-5F50-D425-7402EA09253A" />
-    <EventProvider Id="HTTP_sys_WPP" Name="20F61733-57F1-4127-9F48-4AB7A9308AE2" />
-    <EventProvider Id="CHAT_WPP" Name="9B52E09F-0C58-4EAF-877F-70F9B54A7946" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcCtnrSvc_WPP" Name="9DF6A82D-5174-5EBF-842A-39947C48BF2A" />
-    <EventProvider Id="Microsoft_Windows_BranchCacheEventProvider" Name="dd85457f-4e2d-44a5-a7a7-6253362e34dc" />
-    <EventProvider Id="BFE_WPP" Name="106B464A-8043-46B1-8CB8-E92A0CD7A560" />
-    <EventProvider Id="kerb_WPP" Name="6B510852-3583-4E2D-AFFE-A67F9F223438" />
-    <EventProvider Id="Microsoft_Windows_Runtime_Web_Http" Name="41877cb4-11fc-4188-b590-712c143c881d" />
-    <EventProvider Id="Microsoft_Windows_Shell_CloudExperienceHost_WPP" Name="D0034F5E-3686-5A74-DC48-5A22DD4F3D5B" />
-    <EventProvider Id="NCRYPT_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473301" />
-    <EventProvider Id="pku2u_WPP" Name="2A6FAF47-5449-4805-89A3-A504F3E221A6" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Service_WPP" Name="39A5AA08-031D-4777-A32D-ED386BF03470" />
-    <EventProvider Id="CAPI1_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473305" />
-    <EventProvider Id="Microsoft_Windows_Security_DevCredTask_WPP" Name="86D5FE65-0564-4618-B90B-E146049DEBF4" />
-    <EventProvider Id="MsQuic_WPP" Name="620FD025-BE51-42EF-A5C0-50F13F183AD9" />
-    <EventProvider Id="Microsoft_Windows_Security_DevCredClient_WPP" Name="78983C7D-917F-58DA-E8D4-F393DECF4EC0" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_Local_WPP" Name="3B9DBF69-E9F0-5389-D054-A94BC30E33F7" />
-    <EventProvider Id="Microsoft_Windows_DM_Enrollment_Provider_WPP" Name="9FBF7B95-0697-4935-ADA2-887BE9DF12BC" />
-    <EventProvider Id="TokenBinding_WPP" Name="AEF66A73-A765-4421-B348-B7E0FC8C9898" />
-    <EventProvider Id="KerbClientShared_WPP" Name="FACB33C4-4513-4C38-AD1E-57C1F6828FC0" />
-    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_RoutePolicyManagement" Name="923C0FFD-7933-4B52-8A49-121ABF2DC357" />
-    <EventProvider Id="ntlm_WPP" Name="5BBB6C18-AA45-49B1-A15F-085F7ED0AA90" />
-    <EventProvider Id="NCRYPTSSLP_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473304" />
-    <EventProvider Id="Microsoft_Windows_CAPI2_WPP" Name="5BBCA4A8-B209-48DC-A8C7-B23D3E5216FB" />
-    <EventProvider Id="DNS_WPP" Name="609151DD-04F5-4DA7-974C-FC6947EAA323" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_CertEnroll_WPP" Name="54164045-7C50-4905-963F-E5BC1EEF0CCA" />
-    <EventProvider Id="Webio_WPP" Name="08F93B14-1608-4A72-9CFA-457EECEDBBA7" />
-    <EventProvider Id="TPM_WPP" Name="3A8D6942-B034-48E2-B314-F69C2B4655A3" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_Lifecycle_User_WPP" Name="BEA18B89-126F-4155-9EE4-D36038B02680" />
-    <EventProvider Id="Microsoft_Windows_MicrosoftAccount_TBProvider_WPP" Name="5836994D-A677-53E7-1389-588AD1420CC5" />
-    <EventProvider Id="vault_WPP" Name="7FDD167C-79E5-4403-8C84-B7C0BB9923A1" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Client_WPP" Name="1B5106B1-7622-4740-AD81-D9C6EE74F124" />
-    <EventProvider Id="Microsoft_Windows_BranchCacheClientEventProvider" Name="e837619c-a2a8-4689-833f-47b48ebd2442" />
-    <EventProvider Id="CRYPTOWINRT_WPP" Name="786396CD-2FF3-53D3-D1CA-43E41D9FB73B" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_CryptNgc_WPP" Name="6D7051A0-9C83-5E52-CF8F-0ECAF5D5F6FD" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_AutoEnrollment_WPP" Name="F0DB7EF8-B6F3-4005-9937-FEB77B9E1B43" />
-    <EventProvider Id="Microsoft_Windows_CertPolEng_WPP" Name="AF9CC194-E9A8-42BD-B0D1-834E9CFAB799" />
-    <EventProvider Id="dpapis_WPP" Name="EA3F84FC-03BB-540E-B6AA-9664F81A31FB" />
-    <EventProvider Id="Microsoft_Windows_CertificationAuthorityClient_CertCli_WPP" Name="98BF1CD3-583E-4926-95EE-A61BF3F46470" />
-    <EventProvider Id="KerbComm_WPP" Name="60A7AB7A-BC57-43E9-B78A-A1D516577AE3" />
-    <EventProvider Id="Microsoft_Windows_Security_LsaSrv_WPP" Name="4D9DFB91-4337-465A-A8B5-05A27D930D48" />
-    <EventProvider Id="Microsoft_Windows_Security_AADAuthHelper_WPP" Name="9EBB3B15-B094-41B1-A3B8-0F141B06BADD" />
-    <EventProvider Id="TLS_WPP" Name="37D2C3CD-C5D4-4587-8531-4696C44244C8" />
-    <EventProvider Id="webauth_WPP" Name="EF98103D-8D3A-4BEF-9DF2-2156563E64FA" />
-    <EventProvider Id="idlisten_WPP" Name="D93FE84A-795E-4608-80EC-CE29A96C8658" />
-    <EventProvider Id="Winsock_WPP" Name="1D44957B-7181-4835-B70A-D0B16112A4DE" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_KspSvc_WPP" Name="B66B577F-AE49-5CCF-D2D7-8EB96BFD440C" />
-    <EventProvider Id="aad_WPP" Name="4DE9BC9C-B27A-43C9-8994-0915F1A5E24F" />
-    <EventProvider Id="LsaIso_WPP" Name="366B218A-A5AA-4096-8131-0BDAFCC90E93" />
-    <EventProvider Id="Microsoft_Windows_Security_TokenBroker_WPP" Name="077B8C4A-E425-578D-F1AC-6FDF1220FF68" />
-    <EventProvider Id="CNG_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473303" />
-    <EventProvider Id="NtlmShared_WPP" Name="AC69AE5B-5B21-405F-8266-4424944A43E9" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_Lifecycle_System_WPP" Name="BC0669E1-A10D-4A78-834E-1CA3C806C93B" />
-    <EventProvider Id="Microsoft_Windows_DeviceManagement_SCEP_WPP" Name="D5A5B540-C580-4DEE-8BB4-185E34AA00C5" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_CredentialProvider_Face_WPP" Name="1D480C11-3870-4B19-9144-47A53CD973BD" />
-    <EventProvider Id="credssp_WPP" Name="6165F3E2-AE38-45D4-9B23-6B4818758BD9" />
-    <EventProvider Id="basecsp_WPP" Name="133A980D-035D-4E2D-B250-94577AD8FCED" />
-    <EventProvider Id="gMSAClient_WPP" Name="2D45EC97-EF01-4D4F-B9ED-EE3F4D3C11F3" />
-    <EventProvider Id="Microsoft_Windows_Security_DeviceLock_WPP" Name="2056054C-97A6-5AE4-B181-38BC6B58007E" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_FingerprintCredential_WPP" Name="225B3FED-0356-59D1-1F82-EED163299FA8" />
-    <EventProvider Id="BCRYPT_WPP" Name="A74EFE00-14BE-4EF9-9DA9-1484D5473302" />
-    <EventProvider Id="idstore_WPP" Name="82C7D3DF-434D-44FC-A7CC-453A8075144E" />
-    <EventProvider Id="Wininet_WPP" Name="4E749B6A-667D-4C72-80EF-373EE3246B08" />
-    <EventProvider Id="idcommon_WPP" Name="B1108F75-3252-4B66-9239-80FD47E06494" />
-    <EventProvider Id="Microsoft_Windows_DNS_Client" Name="1c95126e-7eea-49a9-a3fe-a378b03ddb4d" />
-    <EventProvider Id="Microsoft_Windows_DNS_Client_Configuration_PowerShell" Name="563a50d8-3536-4c8a-a361-b37af04094ec" />
-    <EventProvider Id="Microsoft-Windows-DHCP-Client" Name="15A7A4F8-0072-4EAB-ABAD-F98A4D666AED" />
-    <EventProvider Id="Microsoft-Windows-DHCPv6-Client" Name="6A1F2B00-6A90-4C38-95A5-5CAB3B056778" />
-    <EventProvider Id="Microsoft_Windows_AppModel_Exec_WPP" Name="EB65A492-86C0-406A-BACE-9912D595BD69" />
-    <EventProvider Id="Microsoft_Windows_Security_DevCredSvc_WPP" Name="C3FEB5BF-1A8D-53F3-AAA8-44496392BF69" />
-    <EventProvider Id="Microsoft_Quic_ETW" Name="ff15e657-4f26-570e-88ab-0796b258d11c" />
-    <EventProvider Id="LsaDs_WPP" Name="169EC169-5B77-4A3E-9DB6-441799D5CACB" />
-    <EventProvider Id="Microsoft_Windows_WBioSrvc_WPP" Name="34BEC984-F11F-4F1F-BB9B-3BA33C8D0132" />
-    <EventProvider Id="Microsoft_Windows_Security_AADCloudAPPlugin_WPP" Name="556045FD-58C5-4A97-9881-B121F68B79C5" />
-    <EventProvider Id="Microsoft_Windows_CertificateServices_Deployment_WPP" Name="B2D1F576-2E85-4489-B504-1861C40544B3" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_CSP_WPP" Name="89F392FF-EE7C-56A3-3F61-2D5B31A36935" />
-    <EventProvider Id="kps_WPP" Name="97A38277-13C0-4394-A0B2-2A70B465D64F" />
-    <EventProvider Id="WinHttp_WPP" Name="B3A7698A-0C45-44DA-B73D-E181C9B5C8E6" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_NgcCtnr_WPP" Name="0ABA6892-455B-551D-7DA8-3A8F85225E1A" />
-    <EventProvider Id="Microsoft_Windows_Security_DevCredWinRt_WPP" Name="36FF4C84-82A2-4B23-8BA5-A25CBDFF3410" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_KeyStaging_WPP" Name="9B223F67-67A1-5B53-9126-4593FE81DF25" />
-    <EventProvider Id="dclocator_WPP" Name="CA030134-54CD-4130-9177-DAE76A3C5791" />
-    <EventProvider Id="webplatform_WPP" Name="2A3C6602-411E-4DC6-B138-EA19D64F5BBA" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_CredProv_WPP" Name="CAC8D861-7B16-5B6B-5FC0-85014776BDAC" />
-    <EventProvider Id="Microsoft_Windows_ProcessStateManager_WPP" Name="D49918CF-9489-4BF1-9D7B-014D864CF71F" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_CredentialRoaming_WPP" Name="89A2278B-C662-4AFF-A06C-46AD3F220BCA" />
-    <EventProvider Id="Microsoft_Windows_LiveId_WPP" Name="05F02597-FE85-4E67-8542-69567AB8FD4F" />
-    <EventProvider Id="Microsoft_Windows_Security_Fido_WPP" Name="08B15CE7-C9FF-5E64-0D16-66589573C50F" />
-    <EventProvider Id="Microsoft_Windows_Security_DevCredProv_WPP" Name="7955D36A-450B-5E2A-A079-95876BCA450A" />
-    <EventProvider Id="kdc_WPP" Name="1BBA8B19-7F31-43C0-9643-6E911F79A06B" />
-    <EventProvider Id="Microsoft_Windows_Security_Credentials_UserConsentVerifier_WPP" Name="507C53AE-AF42-5938-AEDE-4A9D908640ED" />
-    <EventProvider Id="Microsoft_OSG_OSS_CredProvFramework_ReportResultStop_WPP" Name="8DB3086D-116F-5BED-CFD5-9AFDA80D28EA" />
-    <EventProvider Id="livessp_WPP" Name="C10B942D-AE1B-4786-BC66-052E5B4BE40E" />
-    <EventProvider Id="Netio_WPP" Name="EB004A05-9B1A-11D4-9123-0050047759BC" />
-    <EventProvider Id="PortTrackerServer_WPP" Name="090bf343-4490-42d3-b273-8af174d314fb" />
-    <EventProvider Id="mpssvcService" Name="5EEFEBDB-E90C-423a-8ABF-0241E7C5B87D" />
-    <EventProvider Id="Microsoft_Windows_DNS_Client_WinRNR" Name="b923f87a-b069-42b5-bd32-35623aba1c48" />
-    <EventProvider Id="digest_WPP" Name="FB6A424F-B5D6-4329-B9B5-A975B3A93EAD" />
-    <EventProvider Id="Microsoft_Windows_CertificateServicesClient_WPP" Name="73370BD6-85E5-430B-B60A-FEA1285808A7" />
-    <EventProvider Id="negoexts_WPP" Name="5AF52B0D-E633-4EAD-828A-4B85B8DAAC2B" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_LocalAccountMigPlugin_WPP" Name="CDD94AC7-CD2F-5189-E126-2DEB1B2FACBF" />
-    <EventProvider Id="LsaTrace_WPP" Name="D0B639E0-E650-4D1D-8F39-1580ADE72784" />
-    <EventProvider Id="Microsoft_Windows_DeviceManagement_Enterprise_Diagnostics_Provider_WPP" Name="3DA494E4-0FE2-415C-B895-FB5265C5C83B" />
-    <EventProvider Id="Microsoft_OSG_Wininet_WPP" Name="1A211EE8-52DB-4AF0-BB66-FB8C9F20B0E2" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_PopKeySrv_WPP" Name="1D6540CE-A81B-4E74-AD35-EEF8463F97F5" />
-    <EventProvider Id="UrlMon_WPP" Name="3FAB3162-24CE-4ED5-B23D-63501544E11D" />
-    <EventProvider Id="Microsoft_Windows_WinINet" Name="43d1a55c-76d6-4f7e-995c-64c711e5cafe" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_BioCredProv_WPP" Name="9DADD79B-D556-53F2-67C4-129FA62B7512" />
-    <EventProvider Id="Microsoft_OneCore_NetworkingTriage_GetConnected" Name="60523747-6516-48B7-84B1-3264FA2CB359" />
-    <EventProvider Id="Microsoft_Windows_Security_NGC_Recovery_WPP" Name="9D4CA978-8A14-545E-C047-A45991F0E92F" />
-    <EventProvider Id="Microsoft_Windows_Winsock_NameResolution" Name="55404E71-4DB9-4DEB-A5F5-8F86E46DDE56" />
-    <EventProvider Id="Microsoft_Windows_WinHttp" Name="7d44233d-3055-4b9c-ba64-0d47ca40a232" />
-    <EventProvider Id="Microsoft_Windows_Security_Biometrics_Trustlet_WPP" Name="9DF19CFA-E122-5343-284B-F3945CCD65B2" />
-    <EventProvider Id="cloudap_WPP" Name="EC3CA551-21E9-47D0-9742-1195429831BB" />
-    <EventProvider Id="Microsoft_Windows_BrokerInfrastructure_WPP" Name="63B6C2D2-0440-44DE-A674-AA51A251B123" />
-    <EventProvider Id="IPNat" Name="AE3F6C6D-BF2A-4291-9D07-59E661274EE3" />
-    <EventProvider Id="SharedAccessWPP" Name="9B322459-4AD9-4F81-8EEA-DC77CDD18CA6" />
-    <EventProvider Id="WinNatSys" Name="aa7387cf-3639-496a-b3bf-dc1e79a6fc5a" />
-    <EventProvider Id="Microsoft-Windows-TCPIP" Name="2f07e2ee-15db-40f1-90ef-9d7ba282188a" NonPagedMemory="true" EventKey="true" Strict="true"/>
-    <EventProvider Id="Microsoft-Windows-WinNat" Name="66C07ECD-6667-43FC-93F8-05CF07F446EC" />
-    <EventProvider Id="Microsoft-Windows-Overlay-HNSPlugin" Name="564368D6-577B-4af5-AD84-1C54464848E6" />
-    <EventProvider Id="Microsoft.Windows.HyperV.Compute" Name="80CE50DE-D264-4581-950D-ABADEEE0D340" />
-    <EventProvider Id="Microsoft.Windows.HostNetworkingService.PrivateCloudPlugin" Name="D0E4BC17-34C7-43fc-9A72-D89A59D6979A" />
-    <EventProvider Id="Microsoft-Windows-Host-Network-Management" Name="93f693dc-9163-4dee-af64-d855218af242" />
-    <EventProvider Id="Microsoft-Windows-SharedAccess_NAT" Name="A6F32731-9A38-4159-A220-3D9B7FC5FE5D" />
-    <EventProvider Id="Microsoft.Windows.Hyper.V.VmsIf" Name="6C28C7E5-331B-4437-9C69-5352A2F7F296" />
-    <EventProvider Id="VmSwitch_wpp" Name="1F387CBC-6818-4530-9DB6-5F1058CD7E86"/>
-    <EventProvider Id="ndis_wpp" Name="DD7A21E6-A651-46D4-B7C2-66543067B869"/>
-    <EventProvider Id="Microsoft-Windows-Hyper-V-VmSwitch" Name="67DC0D66-3695-47C0-9642-33F76F7BD7AD"/>
-    <EventProvider Id="Microsoft.Windows.Hyper.V.NetSetupHelper" Name="94DEB9D1-0A52-449B-B368-41E4426B4F36"/>
-    <EventProvider Id="Microsoft-Windows-Hyper-V-VfpExt" Name="9F2660EA-CFE7-428F-9850-AECA612619B0"/>
-    <EventProvider Id="Microsoft.Windows.Networking.FlowSteering" Name="662abf07-6dda-5b25-c2c5-345236dbb2d2"/>
-    <EventProvider Id="Microsoft.Windows.HyperV.Socket" Name="b2ed3bdb-cd74-5b2c-f660-85079ca074b3"/>
-    <Profile
-      Id="WSL.Verbose.File"
-      Name="WSL"
-      Description="Traces for all WSL components"
-      LoggingMode="File"
-      DetailLevel="Verbose"
-      >
-      <Collectors>
-        <EventCollectorId Value="Collector">
-          <EventProviders>
-            <EventProviderId Value="lxcore_kernel"/>
-            <EventProviderId Value="lxcore_user"/>
-            <EventProviderId Value="lxcore_service"/>
-            <EventProviderId Value="wsl_devicehost"/>
-            <EventProviderId Value="wslclient"/>
-            <EventProviderId Value="vm_chipset"/>
-            <EventProviderId Value="vmcompute_dll"/>
-            <EventProviderId Value="vmcompute"/>
-            <EventProviderId Value="vmmm"/>
-            <EventProviderId Value="vmwp"/>
-            <EventProviderId Value="9p"/>
-            <EventProviderId Value="9p_errors"/>
-            <EventProviderId Value="p9rdr"/>
-            <EventProviderId Value="mup"/>
-            <EventProviderId Value="rfsmon"/>
-            <EventProviderId Value="hyperv_storage"/>
-            <EventProviderId Value="hns"/>
-            <EventProviderId Value="netmgmt"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.AppDownload"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.Datastore"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.PhoneProvisioner"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Mobile.Provisioning.PPOEM"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.CSP"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Engine"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Migration"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Platform"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Operations"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Plugin.Engine"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Plugin.RemovableMedia"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.ProvTool"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.Operations"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.CommandCsp"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.Provisioning.ProvLaunch"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.EMPS.Enrollment"/>
-            <EventProviderId Value="EventProvider_Microsoft.Windows.EnterpriseManagement.Enrollment"/>
-            <EventProviderId Value="virtdisk"/>
-            <EventProviderId Value="virtdisk_wpp"/>
-            <EventProviderId Value="vhdmp"/>
-            <EventProviderId Value="vhdmp_wpp"/>
-            <EventProviderId Value="LsaAudit_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_ResourceManager_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_KeyCredMgr_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcIsoCtnr_WPP"/>
-            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_OnDemand"/>
-            <EventProviderId Value="wlidsvc_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_WebIO"/>
-            <EventProviderId Value="msxml_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_HttpService"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_Trustlet_WPP"/>
-            <EventProviderId Value="Microsoft_Web_Platform_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Shell_CloudDomainJoin_Client_WPP"/>
-            <EventProviderId Value="HTTP_sys_WPP"/>
-            <EventProviderId Value="CHAT_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcCtnrSvc_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_BranchCacheEventProvider"/>
-            <EventProviderId Value="BFE_WPP"/>
-            <EventProviderId Value="kerb_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Runtime_Web_Http"/>
-            <EventProviderId Value="Microsoft_Windows_Shell_CloudExperienceHost_WPP"/>
-            <EventProviderId Value="NCRYPT_WPP"/>
-            <EventProviderId Value="pku2u_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Service_WPP"/>
-            <EventProviderId Value="CAPI1_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DevCredTask_WPP"/>
-            <EventProviderId Value="MsQuic_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DevCredClient_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_Local_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_DM_Enrollment_Provider_WPP"/>
-            <EventProviderId Value="TokenBinding_WPP"/>
-            <EventProviderId Value="KerbClientShared_WPP"/>
-            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_RoutePolicyManagement"/>
-            <EventProviderId Value="ntlm_WPP"/>
-            <EventProviderId Value="NCRYPTSSLP_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CAPI2_WPP"/>
-            <EventProviderId Value="DNS_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_CertEnroll_WPP"/>
-            <EventProviderId Value="Webio_WPP"/>
-            <EventProviderId Value="TPM_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_Lifecycle_User_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_MicrosoftAccount_TBProvider_WPP"/>
-            <EventProviderId Value="vault_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Client_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_BranchCacheClientEventProvider"/>
-            <EventProviderId Value="CRYPTOWINRT_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_CryptNgc_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_AutoEnrollment_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertPolEng_WPP"/>
-            <EventProviderId Value="dpapis_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificationAuthorityClient_CertCli_WPP"/>
-            <EventProviderId Value="KerbComm_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_LsaSrv_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_AADAuthHelper_WPP"/>
-            <EventProviderId Value="TLS_WPP"/>
-            <EventProviderId Value="webauth_WPP"/>
-            <EventProviderId Value="idlisten_WPP"/>
-            <EventProviderId Value="Winsock_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_KspSvc_WPP"/>
-            <EventProviderId Value="aad_WPP"/>
-            <EventProviderId Value="LsaIso_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_TokenBroker_WPP"/>
-            <EventProviderId Value="CNG_WPP"/>
-            <EventProviderId Value="NtlmShared_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_Lifecycle_System_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_DeviceManagement_SCEP_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_CredentialProvider_Face_WPP"/>
-            <EventProviderId Value="credssp_WPP"/>
-            <EventProviderId Value="basecsp_WPP"/>
-            <EventProviderId Value="gMSAClient_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DeviceLock_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_FingerprintCredential_WPP"/>
-            <EventProviderId Value="BCRYPT_WPP"/>
-            <EventProviderId Value="idstore_WPP"/>
-            <EventProviderId Value="Wininet_WPP"/>
-            <EventProviderId Value="idcommon_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_DNS_Client"/>
-            <EventProviderId Value="Microsoft_Windows_DNS_Client_Configuration_PowerShell"/>
-            <EventProviderId Value="Microsoft-Windows-DHCP-Client"/>
-            <EventProviderId Value="Microsoft-Windows-DHCPv6-Client"/>
-            <EventProviderId Value="Microsoft_Windows_AppModel_Exec_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DevCredSvc_WPP"/>
-            <EventProviderId Value="Microsoft_Quic_ETW"/>
-            <EventProviderId Value="LsaDs_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_WBioSrvc_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_AADCloudAPPlugin_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServices_Deployment_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_CSP_WPP"/>
-            <EventProviderId Value="kps_WPP"/>
-            <EventProviderId Value="WinHttp_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_NgcCtnr_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DevCredWinRt_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_KeyStaging_WPP"/>
-            <EventProviderId Value="dclocator_WPP"/>
-            <EventProviderId Value="webplatform_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_CredProv_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_ProcessStateManager_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_CredentialRoaming_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_LiveId_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Fido_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_DevCredProv_WPP"/>
-            <EventProviderId Value="kdc_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Credentials_UserConsentVerifier_WPP"/>
-            <EventProviderId Value="Microsoft_OSG_OSS_CredProvFramework_ReportResultStop_WPP"/>
-            <EventProviderId Value="livessp_WPP"/>
-            <EventProviderId Value="Netio_WPP"/>
-            <EventProviderId Value="PortTrackerServer_WPP"/>
-            <EventProviderId Value="mpssvcService"/>
-            <EventProviderId Value="Microsoft_Windows_DNS_Client_WinRNR"/>
-            <EventProviderId Value="digest_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_CertificateServicesClient_WPP"/>
-            <EventProviderId Value="negoexts_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_LocalAccountMigPlugin_WPP"/>
-            <EventProviderId Value="LsaTrace_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_DeviceManagement_Enterprise_Diagnostics_Provider_WPP"/>
-            <EventProviderId Value="Microsoft_OSG_Wininet_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_PopKeySrv_WPP"/>
-            <EventProviderId Value="UrlMon_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_WinINet"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_BioCredProv_WPP"/>
-            <EventProviderId Value="Microsoft_OneCore_NetworkingTriage_GetConnected"/>
-            <EventProviderId Value="Microsoft_Windows_Security_NGC_Recovery_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_Winsock_NameResolution"/>
-            <EventProviderId Value="Microsoft_Windows_WinHttp"/>
-            <EventProviderId Value="Microsoft_Windows_Security_Biometrics_Trustlet_WPP"/>
-            <EventProviderId Value="cloudap_WPP"/>
-            <EventProviderId Value="Microsoft_Windows_BrokerInfrastructure_WPP"/>
-            <EventProviderId Value="IPNat"/>
-            <EventProviderId Value="SharedAccessWPP"/>
-            <EventProviderId Value="WinNatSys"/>
-            <EventProviderId Value="Microsoft-Windows-TCPIP"/>
-            <EventProviderId Value="Microsoft-Windows-WinNat"/>
-            <EventProviderId Value="Microsoft-Windows-Overlay-HNSPlugin"/>
-            <EventProviderId Value="Microsoft.Windows.HyperV.Compute"/>
-            <EventProviderId Value="Microsoft.Windows.HostNetworkingService.PrivateCloudPlugin"/>
-            <EventProviderId Value="Microsoft-Windows-Host-Network-Management"/>
-            <EventProviderId Value="Microsoft-Windows-SharedAccess_NAT"/>
-            <EventProviderId Value="Microsoft.Windows.Hyper.V.VmsIf"/>
-            <EventProviderId Value="VmSwitch_wpp"/>
-            <EventProviderId Value="ndis_wpp"/>
-            <EventProviderId Value="Microsoft-Windows-Hyper-V-VmSwitch"/>
-            <EventProviderId Value="Microsoft.Windows.Hyper.V.NetSetupHelper"/>
-            <EventProviderId Value="Microsoft-Windows-Hyper-V-VfpExt"/>
-            <EventProviderId Value="Microsoft.Windows.Networking.FlowSteering"/>
-            <EventProviderId Value="Microsoft.Windows.HyperV.Socket"/>
-          </EventProviders>
-        </EventCollectorId>
-      </Collectors>
-    </Profile>
-  </Profiles>
-</WindowsPerformanceRecorder>

diagnostics/wsl_storage.wprp

@@ -1,123 +0,0 @@
-<?xml version="1.0"?>
-<WindowsPerformanceRecorder Version="1">
-  <Profiles>
-    <EventCollector Id="Collector" Name="Collector">
-      <BufferSize Value="256"/>
-      <Buffers Value="1024"/>
-    </EventCollector>
-
-    <EventProvider Id="lxcore_kernel" Name="0CD1C309-0878-4515-83DB-749843B3F5C9"/>
-    <EventProvider Id="lxcore_user" Name="D90B9468-67F0-5B3B-42CC-82AC81FFD960"/>
-    <EventProvider Id="lxcore_service" Name="B99CDB5A-039C-5046-E672-1A0DE0A40211"/>
-    <EventProvider Id="vm_chipset" Name="de9ba731-7f33-4f44-98c9-6cac856b9f83"/>
-    <EventProvider Id="vmcompute_dll" Name="AF7FD3A7-B248-460C-A9F5-FEC39EF8468C"/>
-    <EventProvider Id="vmcompute" Name="17103E3F-3C6E-4677-BB17-3B267EB5BE57"/>
-    <EventProvider Id="vmmm" Name="6066F867-7CA1-4418-85FD-36E3F9C0600C"/>
-    <EventProvider Id="vmwp" Name="51DDFA29-D5C8-4803-BE4B-2ECB715570FE"/>
-    <EventProvider Id="9p" Name="e13c8d52-b153-571f-78c5-1d4098af2a1e"/>
-    <EventProvider Id="p9rdr" Name="bb1d36f0-e0e0-48cc-9493-fef0e3d0b28c" />
-    <EventProvider Id="mup" Name="20c46239-d059-4214-a11e-7d6769cbe020" />
-    <EventProvider Id="rfsmon" Name="51734B23-5B7E-4892-BA8E-45BC110B735C" />
-    <EventProvider Id="hyperv_storage" Name="c7ad62c6-5c99-5a1b-bbc4-0821ae5b765e" />
-    <EventProvider Id="hns" Name="0c885e0d-6eb6-476c-a048-2457eed3a5c1" />
-    <EventProvider Id="netmgmt" Name="93f693dc-9163-4dee-af64-d855218af242" />
-    <EventProvider Id="storvsp_io" Name="10b3d268-9782-49a4-aacc-a93c5482cb6f" NonPagedMemory="true">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="virtdisk_wpp" Name="e14dcdd9-d1ec-4dc3-8395-a606df8ef115" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="virtdisk" Name="4D20DF22-E177-4514-A369-F1759FEEDEB3" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-     <EventProvider Id="vhdmp" Name="E2816346-87F4-4F85-95C3-0C79409AA89D" NonPagedMemory="true" Level="5">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="vhdmp_wpp" Name="3c70c3b0-2fae-41d3-b68d-8f7fcaf79adb" NonPagedMemory="true" Level="5">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="HyperV_SyntheticStorage" Name="EDACD782-2564-4497-ADE6-7199377850F2" Level="6">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="HyperV_EmulatedStorage" Name="86E15E01-EDF1-4AC7-89CF-B19563FD6894" Level="6">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="EventProvider_Telemetry_StorVSP" Name="544d0787-9f6d-432e-8414-e035a8b0541d">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="EventProvider_Trace_Vhdmp" Name="dc284fb3-1eab-4854-828a-b25417280280" Level="3">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <EventProvider Id="storvsp_wpp" Name="f96abc17-6a5e-4a49-a3f4-a2a86fa03846" NonPagedMemory="true" Level="4">
-      <Keywords>
-        <Keyword Value="0xFFFFFFFFFFFFFFFF" />
-      </Keywords>
-    </EventProvider>
-
-    <Profile
-      Id="WSL.Verbose.File"
-      Name="WSL"
-      Description="Traces for all WSL components"
-      LoggingMode="File"
-      DetailLevel="Verbose"
-      >
-      <Collectors>
-        <EventCollectorId Value="Collector">
-          <EventProviders>
-            <EventProviderId Value="lxcore_kernel"/>
-            <EventProviderId Value="lxcore_user"/>
-            <EventProviderId Value="lxcore_service"/>
-            <EventProviderId Value="vm_chipset"/>
-            <EventProviderId Value="vmcompute_dll"/>
-            <EventProviderId Value="vmcompute"/>
-            <EventProviderId Value="vmmm"/>
-            <EventProviderId Value="vmwp"/>
-            <EventProviderId Value="9p"/>
-            <EventProviderId Value="p9rdr"/>
-            <EventProviderId Value="mup"/>
-            <EventProviderId Value="rfsmon"/>
-            <EventProviderId Value="hyperv_storage"/>
-            <EventProviderId Value="hns"/>
-            <EventProviderId Value="netmgmt"/>
-            <EventProviderId Value="storvsp_io"/>
-            <EventProviderId Value="virtdisk"/>
-            <EventProviderId Value="virtdisk_wpp"/>
-            <EventProviderId Value="vhdmp"/>
-            <EventProviderId Value="vhdmp_wpp"/>
-            <EventProviderId Value="HyperV_SyntheticStorage"/>
-            <EventProviderId Value="HyperV_EmulatedStorage"/>
-            <EventProviderId Value="EventProvider_Telemetry_StorVSP"/>
-            <EventProviderId Value="EventProvider_Trace_Vhdmp"/>
-            <EventProviderId Value="storvsp_wpp"/>
-          </EventProviders>
-        </EventCollectorId>
-      </Collectors>
-    </Profile>
-  </Profiles>
-</WindowsPerformanceRecorder>

distributions/DistributionInfo.json

@@ -1,4 +1,217 @@
 {
+    "ModernDistributions": {
+        "Ubuntu": [
+            {
+                "Name": "Ubuntu",
+                "FriendlyName": "Ubuntu",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://releases.ubuntu.com/24.04.3/ubuntu-24.04.3-wsl-amd64.wsl",
+                    "Sha256": "c74833a55e525b1e99e1541509c566bb3e32bdb53bf27ea3347174364a57f47c"
+                },
+                "Arm64Url": {
+                    "Url": "https://cdimages.ubuntu.com/releases/24.04.3/release/ubuntu-24.04.3-wsl-arm64.wsl",
+                    "Sha256": "edaf375ea0d1319da08e7154e9bc64cd4eead5af21ea032f2edaa335fadf0970"
+                }
+            },
+            {
+                "Name": "Ubuntu-24.04",
+                "FriendlyName": "Ubuntu 24.04 LTS",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://releases.ubuntu.com/24.04.3/ubuntu-24.04.3-wsl-amd64.wsl",
+                    "Sha256": "c74833a55e525b1e99e1541509c566bb3e32bdb53bf27ea3347174364a57f47c"
+                },
+                "Arm64Url": {
+                    "Url": "https://cdimages.ubuntu.com/releases/24.04.3/release/ubuntu-24.04.3-wsl-arm64.wsl",
+                    "Sha256": "edaf375ea0d1319da08e7154e9bc64cd4eead5af21ea032f2edaa335fadf0970"
+                }
+            }
+        ],
+        "openSUSE": [
+            {
+                "Name": "openSUSE-Tumbleweed",
+                "FriendlyName": "openSUSE Tumbleweed",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://github.com/openSUSE/WSL-instarball/releases/download/v20260106.0/openSUSE-Tumbleweed-20260103.x86_64-1.224-Build1.224.wsl",
+                    "Sha256": "0x394be699da2821b331355f3541e237aa3aa00bc4068f33283d68303d8336d484"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/openSUSE/WSL-instarball/releases/download/v20260106.0/openSUSE-Tumbleweed-20260103.aarch64-2.195-Build2.195.wsl",
+                    "Sha256": "0xbcbb88e957091c425ecb42f3076b8882b5976fd94885e453afaee40de3b79470"
+                }
+            },
+            {
+                "Name": "openSUSE-Leap-16.0",
+                "FriendlyName": "openSUSE Leap 16.0",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://github.com/openSUSE/WSL-instarball/releases/download/v20251001.0/openSUSE-Leap-16.0-16.0.x86_64-22.57-Build22.57.wsl",
+                    "Sha256": "0x0d1faa095153beee0a9b5089b0f9aa3d2aec95e2cdcffdeeff84dd54c48b8393"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/openSUSE/WSL-instarball/releases/download/v20251001.0/openSUSE-Leap-16.0-16.0.aarch64-22.57-Build22.57.wsl",
+                    "Sha256": "0x91bcdc7e9f42d7a60a4464ad867d91243aaaecab7b3a057039f77a989daac51e"
+                }
+            }
+        ],
+        "SUSE": [
+            {
+                "Name": "SUSE-Linux-Enterprise-15-SP7",
+                "FriendlyName": "SUSE Linux Enterprise 15 SP7",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://github.com/SUSE/WSL-instarball/releases/download/v20251201.0/SUSE-Linux-Enterprise-15-SP7-15.7.x86_64-30.1-Build30.1.wsl",
+                    "Sha256": "0x60924e13286ed15bdcf9069e3a24d3394fb858954de3bdfcb1ea576900b81b2e"
+                }
+            },
+            {
+                "Name": "SUSE-Linux-Enterprise-16.0",
+                "FriendlyName": "SUSE Linux Enterprise 16.0",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://github.com/SUSE/WSL-instarball/releases/download/v20251201.0/SUSE-Linux-Enterprise-16.0-16.0.x86_64-1.9-Build1.9.wsl",
+                    "Sha256": "0xf0fc07ed3543d3dc24cfb35b4194bbecf98485cefdd720c521034ac1c54bffd3"
+                }
+            }
+        ],
+        "kali": [
+            {
+                "Name": "kali-linux",
+                "FriendlyName": "Kali Linux Rolling",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://kali.download/wsl-images/kali-2025.4/kali-linux-2025.4-wsl-rootfs-amd64.wsl",
+                    "Sha256": "86aba7bb3d74d313e349f9f50d3f6119ee3b1491072920d063f17ce9b3f706ab"
+                },
+                "Arm64Url": {
+                    "Url": "https://kali.download/wsl-images/kali-2025.4/kali-linux-2025.4-wsl-rootfs-arm64.wsl",
+                    "Sha256": "bd8cdfe340ec596e470b6853ac662382897bc656c0ac3d3096eb399d0780e25e"
+                }
+            }
+        ],
+        "Debian": [
+            {
+                "Name": "Debian",
+                "FriendlyName": "Debian GNU/Linux",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://salsa.debian.org/debian/WSL/-/jobs/7949331/artifacts/raw/Debian_WSL_AMD64_v1.22.0.0.wsl",
+                    "Sha256": "543123ccc5f838e63dac81634fb0223dc8dcaa78fdb981387d625feb1ed168c7"
+                },
+                "Arm64Url": {
+                    "Url": "https://salsa.debian.org/debian/WSL/-/jobs/7949331/artifacts/raw/Debian_WSL_ARM64_v1.22.0.0.wsl",
+                    "Sha256": "5701f1add55f8cf3b56528109a6220ae5c89f2189d7ae97b9a4b5302b80e967c"
+                }
+            }
+        ],
+        "AlmaLinux": [
+            {
+                "Name": "AlmaLinux-8",
+                "FriendlyName": "AlmaLinux OS 8",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v8.10.20250415.0/AlmaLinux-8.10_x64_20250415.0.wsl",
+                    "Sha256": "34c3bc6d3ac693968737c65db52b67f68b8c1a6f8b024450819841a967f59a3d"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v8.10.20250415.0/AlmaLinux-8.10_ARM64_20250415.0.wsl",
+                    "Sha256": "bd34f64b4822f6f115058f79cdbba85a1560360efbec14c3d699695023f8ca19"
+                }
+            },
+            {
+                "Name": "AlmaLinux-9",
+                "FriendlyName": "AlmaLinux OS 9",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v9.7.20251119.0/AlmaLinux-9.7_x64_20251119.0.wsl",
+                    "Sha256": "0a6588f4f723fcb3edbc37dd3e3e13be8ffe0a5027e47513e3d4d2a4451794e7"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v9.7.20251119.0/AlmaLinux-9.7_ARM64_20251119.0.wsl",
+                    "Sha256": "b3e2632efe029a81db1ae7a914ea3b7e9e6e20d8c71c158270c331e6fea39bf8"
+                }
+            },
+            {
+                "Name": "AlmaLinux-Kitten-10",
+                "FriendlyName": "AlmaLinux OS Kitten 10",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v10-kitten.20251030.0/AlmaLinux-Kitten-10_x64_20251030.0.wsl",
+                    "Sha256": "d765d65076b041f3a67ba60edc37d056eeab2a260aed8e077684e05b78ecd9f5"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v10-kitten.20251030.0/AlmaLinux-Kitten-10_ARM64_20251030.0.wsl",
+                    "Sha256": "90c30b0adbf8d414c4b0a02eaeb6a5d8e488a2187a67dbaf11f4a3e843baae53"
+                }
+            },
+            {
+                "Name": "AlmaLinux-10",
+                "FriendlyName": "AlmaLinux OS 10",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v10.1.20251124.0/AlmaLinux-10.1_x64_20251124.0.wsl",
+                    "Sha256": "24e8fa286a4081979d97e83a227fb89f332bcf731fe4b422679a3b455ab0be37"
+                },
+                "Arm64Url": {
+                    "Url": "https://github.com/AlmaLinux/wsl-images/releases/download/v10.1.20251124.0/AlmaLinux-10.1_ARM64_20251124.0.wsl",
+                    "Sha256": "20700a4467214074f8a1a3d4e0e1cad25af36b8127d047ab6d5b4a1355e998b8"
+                }
+            }
+        ],
+        "archlinux": [
+            {
+                "Name": "archlinux",
+                "FriendlyName": "Arch Linux",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://fastly.mirror.pkgbuild.com/wsl/2026.02.01.158360/archlinux-2026.02.01.158360.wsl",
+                    "Sha256": "e3287ab9f0458240fc6a966849dbc69188bdc7ef376dc27d441aef6f13dd45e5"
+                }
+            }
+        ],
+        "Fedora": [
+            {
+                "Name": "FedoraLinux-43",
+                "FriendlyName": "Fedora Linux 43",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://download.fedoraproject.org/pub/fedora/linux/releases/43/Container/x86_64/images/Fedora-WSL-Base-43-1.6.x86_64.wsl",
+                    "Sha256": "220780af9cf225e9645313b4c7b0457a26a38a53285eb203b2ab6188d54d5b82"
+                },
+                "Arm64Url": {
+                    "Url": "https://download.fedoraproject.org/pub/fedora/linux/releases/43/Container/aarch64/images/Fedora-WSL-Base-43-1.6.aarch64.wsl",
+                    "Sha256": "7eef7a83260218d8c878b3c7bbdaf11772103145184d0c65df27557f4cd49548"
+                }
+            },
+            {
+                "Name": "FedoraLinux-42",
+                "FriendlyName": "Fedora Linux 42",
+                "Default": false,
+                "Amd64Url": {
+                    "Url": "https://download.fedoraproject.org/pub/fedora/linux/releases/42/Container/x86_64/images/Fedora-WSL-Base-42-1.1.x86_64.tar.xz",
+                    "Sha256": "99fb3d05d78ca17c6815bb03cf528da8ef82ebc6260407f2b09461e0da8a1b8d"
+                },
+                "Arm64Url": {
+                    "Url": "https://download.fedoraproject.org/pub/fedora/linux/releases/42/Container/aarch64/images/Fedora-WSL-Base-42-1.1.aarch64.tar.xz",
+                    "Sha256": "a5a2ceb8ca56b7245b909d021b0fd620427db349f02b8ef3b82b741bcb5611cd"
+                }
+            }
+        ],
+        "eLxr": [
+            {
+                "Name": "eLxr",
+                "FriendlyName": "eLxr 12.12.0.0 GNU/Linux",
+                "Default": true,
+                "Amd64Url": {
+                    "Url": "https://gitlab.com/api/v4/projects/68007430/packages/generic/wsl/12.12.0.0/eLxr_WSL_AMD64_12.12.0.0.wsl",
+                    "Sha256": "f94e0c44be51550478100ea150b80535f955bf87487d1b964f4636d97478c05d"
+                }
+            }
+        ]
+    },
+    "Default": "Ubuntu",
     "Distributions": [
         {
             "Name": "Ubuntu",
@@ -6,8 +219,8 @@
             "StoreAppId": "9PDXGNCFSCZV",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2204-220117.appx",
-            "Arm64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2204-220117_ARM64.appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204-220117.appx",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204-220117_ARM64.appx",
             "PackageFamilyName": "CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc"
         },
         {
@@ -16,8 +229,8 @@
             "StoreAppId": "9MSVKQC78PK6",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wsldownload.azureedge.net/TheDebianProject.DebianGNULinux_1.12.2.0_neutral___76v4gfsz19hv4.AppxBundle",
-            "Arm64PackageUrl": "https://wsldownload.azureedge.net/TheDebianProject.DebianGNULinux_1.12.2.0_neutral___76v4gfsz19hv4.AppxBundle",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/TheDebianProject.DebianGNULinux_1.12.2.0_neutral___76v4gfsz19hv4.AppxBundle",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/TheDebianProject.DebianGNULinux_1.12.2.0_neutral___76v4gfsz19hv4.AppxBundle",
             "PackageFamilyName": "TheDebianProject.DebianGNULinux_76v4gfsz19hv4"
         },
         {
@@ -25,20 +238,10 @@
             "FriendlyName": "Kali Linux Rolling",
             "StoreAppId": "9PKR34TNCV07",
             "Amd64": true,
-            "Arm64": false,
-            "Amd64PackageUrl": "https://wsldownload.azureedge.net/KaliLinux_1.13.1.0.AppxBundle",
-            "Arm64PackageUrl": null,
-            "PackageFamilyName": "KaliLinux.54290C8133FEE_ey8k8hqnwqnmg"
-        },
-        {
-            "Name": "Ubuntu-18.04",
-            "FriendlyName": "Ubuntu 18.04 LTS",
-            "StoreAppId": "9PNKSF5ZN4SW",
-            "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wsldownload.azureedge.net/Ubuntu1804-230608_x64.appx",
-            "Arm64PackageUrl": "https://wsldownload.azureedge.net/Ubuntu1804-230608_ARM64.appx",
-            "PackageFamilyName": "CanonicalGroupLimited.Ubuntu18.04LTS_79rhkp1fndgsc"
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/KaliLinux_1.13.1.0.AppxBundle",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/KaliLinux_1.13.1.0.AppxBundle",
+            "PackageFamilyName": "KaliLinux.54290C8133FEE_ey8k8hqnwqnmg"
         },
         {
             "Name": "Ubuntu-20.04",
@@ -46,8 +249,8 @@
             "StoreAppId": "9MTTCL66CPXJ",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wsldownload.azureedge.net/Ubuntu2004-230608_x64.appx",
-            "Arm64PackageUrl": "https://wsldownload.azureedge.net/Ubuntu2004-230608_ARM64.appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2004-230608_x64.appx",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2004-230608_ARM64.appx",
             "PackageFamilyName": "CanonicalGroupLimited.Ubuntu20.04LTS_79rhkp1fndgsc"
         },
         {
@@ -56,8 +259,8 @@
             "StoreAppId": "9PN20MSR04DW",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2204LTS-230518_x64.appx",
-            "Arm64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2204LTS-230518_ARM64.appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204LTS-230518_x64.appx",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2204LTS-230518_ARM64.appx",
             "PackageFamilyName": "CanonicalGroupLimited.Ubuntu22.04LTS_79rhkp1fndgsc"
         },
         {
@@ -66,8 +269,8 @@
             "StoreAppId": "9NZ3KLHXDJP5",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2404-240425.AppxBundle",
-            "Arm64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/Ubuntu2404-240425.AppxBundle",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2404-240425.AppxBundle",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/Ubuntu2404-240425.AppxBundle",
             "PackageFamilyName": "CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc"
         },
         {
@@ -76,59 +279,49 @@
             "StoreAppId": "9P7L0QWBSLTK",
             "Amd64": true,
             "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/OracleLinux_7.9-230428.Appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/OracleLinux_7.9-230428.Appx",
             "Arm64PackageUrl": null,
             "PackageFamilyName": "3810OracleAmericaInc.OracleLinux7.9_dm28ctvqnhe9g"
         },
         {
-            "Name": "OracleLinux_8_7",
-            "FriendlyName": "Oracle Linux 8.7",
-            "StoreAppId": "9NGGZVB0BKD9",
+            "Name": "OracleLinux_8_10",
+            "FriendlyName": "Oracle Linux 8.10",
+            "StoreAppId": "9MVFWTCT78ZN",
             "Amd64": true,
             "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/OracleLinux_8.7-230428.Appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/OracleLinux_8.10-250708.Appx",
             "Arm64PackageUrl": null,
-            "PackageFamilyName": "3810OracleAmericaInc.51946E772388_dm28ctvqnhe9g"
+            "PackageFamilyName": "3810OracleAmericaInc.OracleLinux8.10_dm28ctvqnhe9g"
         },
         {
-            "Name": "OracleLinux_9_1",
-            "FriendlyName": "Oracle Linux 9.1",
-            "StoreAppId": "9N6CN5STZRX6",
+            "Name": "OracleLinux_9_5",
+            "FriendlyName": "Oracle Linux 9.5",
+            "StoreAppId": "9NL3F53JZ3HX",
             "Amd64": true,
             "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/OracleLinux_9.1-230428.Appx",
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/OracleLinux_9.5-250708.Appx",
             "Arm64PackageUrl": null,
-            "PackageFamilyName": "3810OracleAmericaInc.62074632F71C9_dm28ctvqnhe9g"
+            "PackageFamilyName": "3810OracleAmericaInc.OracleLinux9.5_dm28ctvqnhe9g"
         },
         {
-            "Name": "openSUSE-Leap-15.5",
-            "FriendlyName": "openSUSE Leap 15.5",
-            "StoreAppId": "9NJGLDP5G04B",
+            "Name": "openSUSE-Leap-15.6",
+            "FriendlyName": "openSUSE Leap 15.6",
+            "StoreAppId": "9PDTJHBQRQPF",
             "Amd64": true,
-            "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/openSuseLeap15-5-231506_x64.Appx",
-            "Arm64PackageUrl": null,
-            "PackageFamilyName": "46932SUSE.openSUSELeap15.5_022rs5jcyhyac"
+            "Arm64": true,
+            "Amd64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/openSUSELeap15p6-250320_x64.Appx",
+            "Arm64PackageUrl": "https://publicwsldistros.blob.core.windows.net/wsldistrostorage/openSUSELeap15p6-250320_ARM64.Appx",
+            "PackageFamilyName": "46932SUSE.openSUSELeap15.6_022rs5jcyhyac"
         },
         {
-            "Name": "SUSE-Linux-Enterprise-Server-15-SP4",
-            "FriendlyName": "SUSE Linux Enterprise Server 15 SP4",
-            "StoreAppId": "9NMQXWVJJSZJ",
+            "Name": "SUSE-Linux-Enterprise-15-SP6",
+            "FriendlyName": "SUSE Linux Enterprise 15 SP6",
+            "StoreAppId": "9N738KZGNB91",
             "Amd64": true,
             "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/SUSELinuxEnterpriseServer15_SP4-230130_x64.Appx",
+            "Amd64PackageUrl": "https://github.com/SUSE/WSL-instarball/releases/download/v20250618.0/SUSE-Linux-Enterprise-15-SP6-15.6-WSL.x86_64-156.3.148.0-Build3.148.appx",
             "Arm64PackageUrl": null,
-            "PackageFamilyName": "46932SUSE.SUSELinuxEnterpriseServer15SP4_022rs5jcyhyac"
-        },
-        {
-            "Name": "SUSE-Linux-Enterprise-15-SP5",
-            "FriendlyName": "SUSE Linux Enterprise 15 SP5",
-            "StoreAppId": "9N648JDGXK2D",
-            "Amd64": true,
-            "Arm64": false,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/SUSELinuxEnterprise15_SP5-231024.Appx",
-            "Arm64PackageUrl": null,
-            "PackageFamilyName": "46932SUSE.SUSELinuxEnterprise15SP5_022rs5jcyhyac"
+            "PackageFamilyName": "46932SUSE.SUSELinuxEnterprise15SP6_022rs5jcyhyac"
         },
         {
             "Name": "openSUSE-Tumbleweed",
@@ -136,8 +329,8 @@
             "StoreAppId": "9MSSK2ZXXN11",
             "Amd64": true,
             "Arm64": true,
-            "Amd64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/openSUSETumbleweed-231024_x64.Appx",
-            "Arm64PackageUrl": "https://wslstorestorage.blob.core.windows.net/wslblob/openSUSETumbleweed-231024_ARM64.Appx",
+            "Amd64PackageUrl": "https://github.com/openSUSE/WSL-instarball/releases/download/v20260106.0/openSUSE-Tumbleweed-20260103-WSL.x86_64-26003.9.1368.0-Build9.1368.appx",
+            "Arm64PackageUrl": "https://github.com/openSUSE/WSL-instarball/releases/download/v20260106.0/openSUSE-Tumbleweed-20260103-WSL.aarch64-26003.9.741.0-Build9.741.appx",
             "PackageFamilyName": "46932SUSE.openSUSETumbleweed_022rs5jcyhyac"
         }
     ]

distributions/requirements.txt

@@ -0,0 +1,5 @@
+python-magic==0.4.27
+click==8.1.3
+GitPython==3.1.41
+PyGithub==2.5.0
+json-cfg==0.4.2

distributions/validate-modern.py

@@ -0,0 +1,565 @@
+import click
+import jsoncfg
+from jsoncfg.config_classes import ConfigJSONObject, ConfigJSONArray, ConfigJSONScalar
+import requests
+import tempfile
+import hashlib
+import tarfile
+import configparser
+import magic
+import os.path
+import git
+import re
+import sys
+from github import Github
+
+
+USR_LIB_WSL = '/usr/lib/wsl'
+USR_LIBEXEC_WSL = '/usr/libexec/wsl'
+USR_SHARE_WSL = '/usr/share/wsl'
+
+MAGIC = magic.Magic()
+X64_ELF_MAGIC = re.compile('^ELF 64-bit.* x86-64, version 1')
+ARM64_ELF_MAGIC = re.compile('^ELF 64-bit.* ARM aarch64, version 1')
+
+KNOWN_TAR_FORMATS = {'^XZ compressed data.*': True, '^gzip compressed data.*': True}
+
+DISCOURAGED_SYSTEM_UNITS = ['systemd-resolved.service',
+                            'systemd-networkd.service',
+                            'systemd-networkd-wait-online.service',
+                            'systemd-tmpfiles-setup.service',
+                            'systemd-tmpfiles-clean.service',
+                            'systemd-tmpfiles-setup-dev-early.service',
+                            'systemd-tmpfiles-setup-dev.service',
+                            'tmp.mount',
+                            'NetworkManager.service',
+                            'networking.service',
+                            'hypervkvpd.service']
+
+WSL1_UNSUPPORTED_XATTRS = ['security.selinux', 'security.ima', 'security.evm']
+
+WSL_CONF_KEYS = ['automount.enabled',
+                 'automount.ldconfig',
+                 'automount.mountfstab',
+                 'automount.options',
+                 'automount.root',
+                 'boot.command',
+                 'boot.protectbinfmt',
+                 'boot.systemd',
+                 'fileserver.enabled',
+                 'filesystem.umask',
+                 'general.hostname',
+                 'gpu.appendlibpath',
+                 'gpu.enabled',
+                 'interop.appendwindowspath',
+                 'interop.enabled',
+                 'network.generatehosts',
+                 'network.generateresolvconf',
+                 'network.hostname',
+                 'time.usewindowstimezone',
+                 'user.default']
+
+errors = {}
+warnings = {}
+
+def subset(inner, outer) -> bool:
+    for key, value in inner:
+        if key not in outer:
+            return True
+
+        if not node_equals(value, outer[key]):
+            return False
+
+    return True
+
+def node_equals(left, right):
+    if isinstance(left, ConfigJSONScalar):
+        return left() == right()
+
+    elif isinstance(left, ConfigJSONArray):
+        return len(left) == len(right) and all(node_equals(l, r) for l, r in zip(left, right))
+    else:
+        return subset(left, right) and subset(right, left)
+
+@click.command()
+@click.option('--manifest', default=None)
+@click.option('--tar', default=None)
+@click.option('--compare-with-branch')
+@click.option('--repo-path', '..')
+@click.option('--arm64', is_flag=True)
+@click.option('--debug', is_flag=True)
+def main(manifest: str, tar: str, compare_with_branch: str, repo_path: str, arm64: bool, debug: bool):
+    try:
+        if tar is not None:
+            with open(tar, 'rb') as fd:
+                read_tar(None, fd, ARM64_ELF_MAGIC if arm64 else  X64_ELF_MAGIC)
+        else:
+            if manifest is None:
+                raise RuntimeError('Either --tar or --manifest is required')
+
+            manifest_content = jsoncfg.load_config(manifest)
+
+            baseline_manifest = None
+            if compare_with_branch is not None:
+                repo = git.Repo(repo_path)
+                baseline_json = repo.commit(compare_with_branch).tree / 'distributions/DistributionInfo.json'
+                baseline_manifest = jsoncfg.loads_config(baseline_json.data_stream.read().decode())['ModernDistributions']
+
+            for flavor, versions in manifest_content["ModernDistributions"]:
+                baseline_flavor = baseline_manifest[flavor] if baseline_manifest and flavor in baseline_manifest else None
+
+                for e in versions:
+                    name = e['Name']() if 'Name' in e else None
+
+                    if name is None:
+                        error(flavor, 'Found nameless distribution')
+                        continue
+
+                    if baseline_flavor is not None:
+                        baseline_version = next((entry for entry in baseline_flavor if entry['Name']() == name), None)
+                        if baseline_version is None:
+                            click.secho(f'Found new entry for flavor "{flavor}": {name}', fg='green', bold=True)
+                        elif not node_equals(baseline_version, e):
+                            click.secho(f'Found changed entry for flavor "{flavor}": {name}', fg='green', bold=True)
+                        else:
+                            click.secho(f'Distribution entry "{flavor}/{name}" is unchanged, skipping')
+                            continue
+
+                    click.secho(f'Reading information for distribution: {name}', bold=True)
+                    if 'FriendlyName' not in e:
+                        error(e, 'Manifest entry is missing a "FriendlyName" entry')
+
+                    if not name.startswith(flavor):
+                        error(e, f'Name should start with "{flavor}"')
+
+                    url_found = False
+
+                    if 'Amd64Url' in e:
+                       read_url(e['Amd64Url'], X64_ELF_MAGIC)
+                       url_found = True
+
+                    if 'Arm64Url' in e:
+                       read_url(e['Arm64Url'], ARM64_ELF_MAGIC)
+                       url_found = True
+
+                    if not url_found:
+                        error(flavor, 'No URL found')
+
+                    expectedKeys = ['Name', 'FriendlyName', 'Default', 'Amd64Url', 'Arm64Url']
+                    for key, value in e:
+                        if key not in expectedKeys:
+                            error(e, f'Unexpected key: "{key}"')
+
+                default_entries = sum(1 for e in versions if 'Default' in e and e['Default']())
+                if default_entries != 1:
+                    error(e, f'Found no default distribution for "{flavor}"' if default_entries == 0 else f'Found multiple default distributions for "{flavor}"')
+
+            report_status_on_pr(manifest)
+
+            sys.exit(1 if errors else 0)
+
+    except:
+        if debug:
+            import traceback
+            traceback.print_exc()
+            import pdb
+            pdb.post_mortem()
+        else:
+            raise
+
+def report_status_on_pr(manifest: str):
+    def format_list(entries: list) -> str:
+        if len(entries) == 1:
+            return entries[0]
+
+        output = ''
+        for e in entries:
+            output += f'\n* {e}'
+
+        return output
+
+    for line, text in errors.items():
+        escaped = format_list(text).replace('\n', '%0A')
+        print(f'::error file={manifest},line={line}::Error: {escaped}')
+
+    for line, text in warnings.items():
+        escaped = format_list(text).replace('\n', '%0A')
+        print(f'::warning file={manifest},line={line}::Warning: {escaped}')
+
+
+def read_config_keys(config: configparser.ConfigParser) -> dict:
+    keys = {}
+
+    for section in config.sections():
+        for key in config[section].keys():
+            keys[f'{section}.{key.lower()}'] = config[section][key]
+
+    return keys
+
+def read_passwd(node, default_uid: int, fd):
+    def read_passwd_line(line: str):
+        fields = line.split(':')
+
+        if len(fields) != 7:
+            error(node, f'Invalid passwd entry: {line}')
+            return None, None
+        try:
+            uid = int(fields[2])
+        except ValueError:
+            error(node, f'Invalid passwd entry: {line}')
+            return None, None
+
+        return uid, fields
+
+    entries = {}
+
+    for line in fd.readlines():
+        uid, fields = read_passwd_line(line.decode())
+
+        if uid in entries:
+            error(node, f'found duplicated uid in /etc/passw: {uid}')
+        else:
+            entries[uid] = fields
+
+    if 0 not in entries:
+        error(node, f'No root (uid=0) found in /etc/passwd')
+    elif entries[0][0] != 'root':
+        error(node, f'/etc/passwd has a uid=0, but it is not root: {entries[0][0]}')
+
+    if default_uid is not None and default_uid in entries:
+        warning(node, f'/etc/passwd already has an entry for default uid: {entries[default_uid]}')
+
+# This logic isn't perfect at listing all boot units, but parsing all of systemd configuration would be too complex.
+def read_systemd_enabled_units(node, tar) -> dict:
+    config_dirs = ['/usr/local/lib/systemd/system', '/usr/lib/systemd/system', '/etc/systemd/system']
+
+    all_files = tar.getnames()
+
+    def link_target(unit_path: str):
+        try:
+            info = tar.getmember(unit_path)
+        except KeyError:
+            info = tar.getmember('.' + unit_path)
+
+        if not info.issym():
+            return unit_path
+        else:
+            if info.linkpath.startswith('/'):
+                return get_tar_file(tar, linux_real_path(info.linkpath), follow_symlink=True)[1]
+            else:
+                return get_tar_file(tar, linux_real_path(os.path.dirname(unit_path) + '/' + info.linkpath), follow_symlink=True)[1]
+
+    def list_directory(path: str):
+        files = []
+        for e in all_files:
+            if e.startswith(path):
+                files.append(e[len(path) + 1:])
+            elif e.startswith('.' + path):
+                files.append(e[len(path) + 2:])
+
+        return files
+
+    def is_dev_null(path: str) -> bool:
+        return path == './dev/null' or path == '/dev/null'
+
+    def is_masked(unit: str):
+        try:
+            target = link_target(f'/etc/systemd/system/{unit}')
+        except KeyError:
+            return False # No symlink found, unit is not masked
+
+        return is_dev_null(target)
+
+    units = {}
+    for config_dir in config_dirs:
+        targets = [e for e in list_directory(config_dir) if e.endswith('.target.wants')]
+
+        for target in targets:
+            for e in list_directory(f'{config_dir}/{target}'):
+                fullpath = f'{config_dir}/{target}/{e}'
+
+                unit_target = link_target(fullpath)
+
+                if is_dev_null(unit_target) and not is_masked(e):
+                    units[e] = fullpath
+
+    return units
+
+# Manually implemented because os.path.realpath tries to resolve local symlinks
+def linux_real_path(path: str):
+    components = path.split('/')
+
+    result = []
+    for e in components:
+        if e == '.' or not e:
+            continue
+        elif e == '..':
+            if result:
+                del result[-1]
+            continue
+
+        result.append(e)
+
+    real_path = '/'.join(result)
+    if path and path[0] == '/':
+        return '/' + real_path
+    else:
+        return real_path
+
+def get_tar_file(tar, path: str, follow_symlink=False, symlink_depth=10):
+    if symlink_depth < 0:
+        print(f'Warning: Exceeded maximum symlink depth when reading: {path}')
+        return None, None
+
+    # Tar members can be formatted as /{path}, {path}, or ./{path}
+    if path.startswith('/'):
+        paths = [path, '.' + path, path[1:]]
+    elif path.startswith('./'):
+        paths = [path, path[1:], path[2:]]
+    else:
+        paths = [path, './' + path, '/' + path]
+
+    def follow_if_symlink(info, path: str):
+        if follow_symlink and info.issym():
+            if info.linkpath.startswith('/'):
+                return get_tar_file(tar, info.linkpath, follow_symlink=True, symlink_depth=symlink_depth - 1)
+            else:
+                return get_tar_file(tar, linux_real_path(os.path.dirname(path) + '/' + info.linkpath), follow_symlink=True, symlink_depth=symlink_depth -1)
+        else:
+            return info, path
+
+    # First try accessing the file directly
+    for e in paths:
+        try:
+            return follow_if_symlink(tar.getmember(e), e)
+        except KeyError:
+            continue
+
+    if not follow_symlink:
+        return None, None
+
+    # Then look for symlinks
+    # The path might be covered by a symlink, check if parent exists and is a symlink
+    parent_path = os.path.dirname(path)
+    if parent_path != path:
+        try:
+            parent_info, real_parent_path = get_tar_file(tar, parent_path, follow_symlink=True, symlink_depth=symlink_depth - 1)
+            if real_parent_path is not None and real_parent_path != parent_path:
+                return get_tar_file(tar, f'{real_parent_path}/{os.path.basename(path)}', follow_symlink=True, symlink_depth=symlink_depth -1)
+        except KeyError:
+            pass
+
+    return None, None
+
+def find_unsupported_attrs(tar):
+    found_xattrs = set()
+    first_file = None
+
+    for e in tar.getmembers():
+        for name in e.pax_headers:
+            if any(name.startswith('SCHILY.xattr.' + xattr) for xattr in WSL1_UNSUPPORTED_XATTRS):
+                found_xattrs.add(name.replace('SCHILY.xattr.', ''))
+
+                if first_file is None:
+                    first_file  = e.name
+
+    return first_file, found_xattrs
+
+
+def read_tar(node, file, elf_magic: str):
+    with tarfile.open(fileobj=file) as tar:
+
+        def validate_mode(path: str, mode, uid, gid, max_size = None, optional = False, follow_symlink = False, magic = None, parse_method = None):
+            info, real_path = get_tar_file(tar, path, follow_symlink)
+
+            if info is None:
+                if not optional:
+                    error(node, f'File "{path}" not found in tar')
+                return False
+
+            permissions = oct(info.mode)
+            if permissions not in mode:
+                warning(node, f'file: "{path}" has unexpected mode: {permissions} (expected: {mode})')
+
+            if info.uid != uid:
+                warning(node, f'file: "{path}" has unexpected uid: {info.uid} (expected: {uid})')
+
+            if gid is not None and info.gid != gid:
+                warning(node, f'file: "{path}" has unexpected gid: {info.gid} (expected: {gid})')
+
+            if max_size is not None and info.size > max_size:
+                error(node, f'file: "{path}" is too big (info.size), max: {max_size}')
+
+            if magic is not None or parse_method is not None:
+                content = tar.extractfile(real_path)
+
+                if parse_method is not None:
+                    parse_method(content)
+
+                if magic is not None:
+                    content.seek(0)
+                    buffer = content.read(256)
+                    file_magic = MAGIC.from_buffer(buffer)
+                    if not magic.match(file_magic):
+                        error(node, f'file: "{path}" has unexpected magic type: {file_magic} (expected: {magic})')
+
+            return True
+
+        def validate_config(path: str, valid_keys: list):
+            _, path = get_tar_file(tar, path, follow_symlink=True)
+            if path is None:
+                error(node, f'File "{file}" not found in tar')
+                return None
+
+            content = tar.extractfile(path)
+            config = configparser.ConfigParser()
+            config.read_string(content.read().decode())
+
+            keys = read_config_keys(config)
+
+            unexpected_keys = [e for e in keys if e.casefold() not in valid_keys]
+            if unexpected_keys:
+                error(node, f'Found unexpected_keys in "{path}": {unexpected_keys}')
+            else:
+                click.secho(f'Found valid keys in "{path}": {list(keys.keys())}')
+
+            return keys
+
+        defaultUid = None
+        if validate_mode('/etc/wsl-distribution.conf', [oct(0o664), oct(0o644)], 0, 0, follow_symlink=True):
+            config = validate_config('/etc/wsl-distribution.conf', ['oobe.command', 'oobe.defaultuid', 'shortcut.icon', 'shortcut.enabled', 'oobe.defaultname', 'windowsterminal.profiletemplate', 'windowsterminal.enabled'])
+
+            if oobe_command := config.get('oobe.command', None):
+                validate_mode(oobe_command, [oct(0o775), oct(0o755)], 0, 0)
+
+                if not oobe_command.startswith(USR_LIB_WSL) and not oobe_command.startswith(USR_LIBEXEC_WSL):
+                    warning(node, f'value for oobe.command is not under {USR_LIB_WSL} or {USR_LIBEXEC_WSL}: "{oobe_command}"')
+
+            if defaultUid := config.get('oobe.defaultuid', None):
+                if defaultUid != '1000':
+                    warning(node, f'Default UID is not 1000. Found: {defaultUid}')
+
+                defaultUid = int(defaultUid)
+
+            if shortcut_icon := config.get('shortcut.icon', None):
+                validate_mode(shortcut_icon, [oct(0o664), oct(0o644)], 0, 0, 1024 * 1024)
+
+                if not shortcut_icon.startswith(USR_LIB_WSL) and not shortcut_icon.startswith(USR_SHARE_WSL):
+                    warning(node, f'value for shortcut.icon is not under {USR_LIB_WSL} or {USR_SHARE_WSL}: "{shortcut_icon}"')
+            else:
+                warning(node, 'No shortcut.icon provided')
+
+            if terminal_profile := config.get('windowsterminal.profileTemplate', None):
+                validate_mode(terminal_profile, [oct(0o660), oct(0o640)], 0, 0, 1024 * 1024)
+
+                if not terminal_profile.startswith(USR_LIB_WSL):
+                    warning(node, f'value for windowsterminal.profileTemplate is not under {USR_LIB_WSL}: "{terminal_profile}"')
+
+        if validate_mode('/etc/wsl.conf', [oct(0o664), oct(0o644)], 0, 0, optional=True, follow_symlink=True):
+            config = validate_config('/etc/wsl.conf', WSL_CONF_KEYS)
+            if config.get('boot.systemd', False):
+                validate_mode('/sbin/init', [oct(0o775), oct(0o755), oct(0o555)], 0, 0, magic=elf_magic, follow_symlink=True)
+
+            if (default_user := config.get('user.default')) is not None:
+                warning(node, f'Found discouraged wsl.conf key: user.default={default_user}')
+
+        validate_mode('/etc/passwd', [oct(0o664), oct(0o644)], 0, 0, parse_method = lambda fd: read_passwd(node, defaultUid, fd))
+        validate_mode('/etc/shadow', [oct(0o640), oct(0o600), oct(0)], 0, None)
+        validate_mode('/bin/bash', [oct(0o755), oct(0o775), oct(0o555)], 0, 0, magic=elf_magic, follow_symlink=True, optional=True)
+        validate_mode('/bin/sh', [oct(0o755), oct(0o775), oct(0o555)], 0, 0, magic=elf_magic, follow_symlink=True)
+
+        enabled_systemd_units = read_systemd_enabled_units(node, tar)
+        for unit, path in enabled_systemd_units.items():
+            if unit in DISCOURAGED_SYSTEM_UNITS:
+                warning(node, f'Found discouraged system unit: {path}')
+
+        first_file, found_xattrs = find_unsupported_attrs(tar)
+        if first_file is not None:
+            warning(node, f'Found extended attributes that are not supported in WSL1: {found_xattrs}. Sample file: {first_file}')
+
+def read_url(url: dict, elf_magic):
+     hash = hashlib.sha256()
+     address = url['Url']()
+
+     if not address.endswith('.wsl'):
+         warning(url, f'Url does not point to a .wsl file: {address}')
+
+     tar_format = None
+     if address.startswith('file://'):
+         with open(address.replace('file:///', '').replace('file://', ''), 'rb') as fd:
+            while True:
+                e = fd.read(4096 * 4096 * 10)
+                if not e:
+                    break
+
+                hash.update(e)
+
+                if tar_format is None:
+                    tar_format = MAGIC.from_buffer(e)
+
+            fd.seek(0, 0)
+            read_tar(url, fd, elf_magic)
+     else:
+         with requests.get(address, stream=True) as response:
+
+            try:
+                response.raise_for_status()
+            except Exception as e:
+                error(url, str(e))
+                return
+
+            with tempfile.NamedTemporaryFile() as file:
+                for e in response.iter_content(chunk_size=4096 * 4096):
+                    file.write(e)
+                    hash.update(e)
+
+                    if tar_format is None:
+                        tar_format = MAGIC.from_buffer(e)
+
+                file.seek(0, 0)
+                read_tar(url, file, elf_magic)
+
+
+     expected_sha = url['Sha256']() if 'Sha256' in url else None
+     if expected_sha is None:
+         error(url, 'URL is missing "Sha256"')
+     else:
+         if expected_sha.startswith('0x'):
+             expected_sha = expected_sha[2:]
+
+         sha = hash.digest()
+         if bytes.fromhex(expected_sha) != sha:
+            error(url, f'URL {address} Sha256 does not match. Expected: {expected_sha}, actual: {hash.hexdigest()}')
+         else:
+             click.secho(f'Hash for {address} matches ({expected_sha})', fg='green')
+
+     known_format = next((value for key, value in KNOWN_TAR_FORMATS.items() if re.match(key, tar_format)), None)
+     if known_format is None:
+        error(url, f'Unknown tar format: {tar_format}')
+     elif not known_format:
+        warning(url, f'Tar format not supported by WSL1: {tar_format}')
+
+def error(node, message: str):
+    if node is None:
+        click.secho(f'Error: {message}', fg='red')
+    else:
+        global errors
+
+        line = jsoncfg.node_location(node).line
+        click.secho(f'Error on line {line}: {message}', fg='red')
+
+        errors[line] = errors.get(line, []) + [message]
+
+def warning(node, message: str):
+    if node is None:
+        click.secho(f'Warning: {message}', fg='yellow')
+    else:
+        global warnings
+
+        line = jsoncfg.node_location(node).line
+        click.secho(f'Warning on line {line}: {message}', fg='yellow')
+
+        warnings[line] = warnings.get(line, []) + [message]
+
+if __name__ == "__main__":
+    main()

distributions/validate.py

@@ -3,6 +3,7 @@ import json
 import sys
 import hashlib
 import base64
+import difflib
 from urllib.request import urlretrieve
 from xml.etree import ElementTree
 import tempfile
@@ -65,7 +66,16 @@ if __name__ == "__main__":
         exit(1)
 
     with open(sys.argv[1]) as fd:
-        content = json.loads(fd.read())
+        data = fd.read()
+        content = json.loads(data)
+        diff = difflib.unified_diff(
+            data.splitlines(keepends=True),
+            (json.dumps(content, indent=4) + "\n").splitlines(keepends=True),
+            fromfile="a" + sys.argv[1],
+            tofile="b" + sys.argv[1],
+        )
+        diff = "".join(diff)
+        assert diff == "", diff
 
     distros = content['Distributions']
     assert is_unique([e.get('StoreAppId') for e in distros if e])

doc/README.md

@@ -0,0 +1,10 @@
+# WSL open source documentation
+
+Build instructions: 
+
+```
+$ pip install mkdocs mkdocs-mermaid2-plugin
+$ mkdocs serve
+```
+
+You can then view the documentation at `http://127.0.0.1:8000/`.

doc/docs/debugging.md

@@ -0,0 +1,74 @@
+# Debugging WSL
+
+## Logging
+
+There are multiple sources of logging in WSL. The main one is the ETL trace that is emitted from Windows processes.
+
+To collect an ETL trace, run ([link to wsl.wprp](https://github.com/microsoft/WSL/blob/master/diagnostics/wsl.wprp)):
+
+```
+wpr -start wsl.wprp -filemode
+
+[reproduce the issue]
+
+wpr -stop logs.ETL
+```
+
+The consolidated `wsl.wprp` file includes multiple profiles for different scenarios:
+- `WSL` - General WSL tracing (default)
+- `WSL-Storage` - Enhanced storage tracing
+- `WSL-Networking` - Comprehensive networking tracing
+- `WSL-HvSocket` - HvSocket-specific tracing
+
+To use a specific profile, append `!ProfileName` to the wprp file, e.g., `wpr -start wsl.wprp!WSL-Networking -filemode`
+
+Once the log file is saved, you can use [WPA](https://apps.microsoft.com/detail/9n58qrw40dfw?hl=en-US&gl=US) to view the logs.
+
+Notable ETL providers: 
+
+- `Microsoft.Windows.Lxss.Manager`: Logs emitted from wslservice.exe
+    Important events: 
+    - `GuestLog`: Logs from the vm's dmesg
+    - `Error`: Unexpected errors
+    - `CreateVmBegin`, `CreateVmEnd`: Virtual machine lifetime
+    - `CreateNetworkBegin`, `CreateNetworkEnd`: Networking configuration
+    - `SentMessage`, `ReceivedMessage`: Communication on the hvsocket channels with Linux.
+    
+- `Microsoft.Windows.Subsystem.Lxss`: Other WSL executables (wsl.exe, wslg.exe, wslconfig.exe, wslrelay.exe, ...)
+    Important events:
+    - `UserVisibleError`: An error was displayed to the user 
+
+- `Microsoft.Windows.Plan9.Server`: Logs from the Windows plan9 server (used when accessing /mnt/ shares and running Windows)
+
+
+On the Linux side, the easiest way to access logs is to look at `dmesg` or use the debug console, which can enabled by writing:
+
+```
+[wsl2]
+debugConsole=true
+```
+
+to `%USERPROFILE%/.wslconfig` and restarting WSL
+
+
+## Attaching debuggers
+
+Usermode can be attached to WSL Windows processes (wsl.exe, wslservice.exe, wslrelay.exe, ...). The symbols are available under the `bin/<platform>/<target>` folder. 
+You can also use [this trick](https://github.com/microsoft/WSL/blob/master/CONTRIBUTING.md#11-reporting-a-wsl-process-crash) to automatically collect crash dumps when processes crash.
+
+## Linux debugging
+
+`gdb` can be attached to Linux processes (see [man gdb](https://man7.org/linux/man-pages/man1/gdb.1.html)). 
+
+The simplest way to debug a WSL process with gdb is to use the `/mnt` mountpoints to access the code from gdb. 
+Once started, just use `dir /path/to/wsl/source` in gdb to connect the source files.
+
+## Root namespace debugging
+
+Some WSL process such as `gns` or `mini_init` aren't accessible from within WSL distributions. To attach a debugger to those, use the debug shell via:
+
+```
+wsl --debug-shell
+```
+
+You can then install `gdb` by running `tdnf install gdb` and start debugging processes.

doc/docs/dev-loop.md

@@ -0,0 +1,103 @@
+# Building WSL
+
+## Prerequisites 
+
+The following tools are required to build WSL: 
+
+- CMake >= 3.25
+    - Can be installed with `winget install Kitware.CMake`
+- Visual Studio with the following 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
+
+- Building WSL requires support for symbolic links. To ensure this capability, enable [Developer Mode](https://learn.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) in Windows Settings or execute the build process with Administrator privileges.
+    
+## Building WSL
+
+Once you have cloned the repository, generate the Visual Studio solution by running:
+
+```
+cmake .
+```
+
+This will generate a `wsl.sln` file that you can build either with Visual Studio, or via `cmake --build .`.
+
+Build parameters:
+
+- `cmake . -A arm64`: Build a package for ARM64
+- `cmake . -DCMAKE_BUILD_TYPE=Release`: Build for release
+- `cmake . -DBUILD_BUNDLE=TRUE`: Build a bundle msix package (requires building ARM64 first)
+
+Note: To build and deploy faster during development, see options in `UserConfig.cmake`.
+
+
+## Deploying WSL 
+
+Once the build is complete, you can install WSL by installing the MSI package found under `bin\<platform>\<target>\wsl.msi`, or by running `powershell tools\deploy\deploy-to-host.ps1`.
+
+To deploy on a Hyper-V virtual machine, you can use `powershell tools\deploy\deploy-to-vm.ps1 -VmName <vm> -Username <username> -Password <password>`
+
+## Running tests
+
+To run unit tests, run: `bin\<platform>\<target>\test.bat`. There's quite a lot of tests so you probably don't want to run everything. Here's a reasonable subset:
+`bin\<platform>\<target>\test.bat /name:*UnitTest*`
+
+To run a specific test case run:
+`bin\<platform>\<target>\test.bat /name:<class>::<test>`
+Example: `bin\x64\debug\test.bat /name:UnitTests::UnitTests::ModernInstall` 
+
+To run the tests for WSL1, add `-Version 1`. 
+Example: `bin\x64\debug\test.bat -Version 1` 
+
+
+After running the tests once, you can add `-f` to skip the package installation, which makes the tests faster (this requires test_distro to be the default WSL distribution).
+
+Example:
+
+```
+wsl --set-default test_distro
+bin\x64\debug\test.bat /name:*UnitTest* -f
+```
+
+## Debugging tests
+
+See [debugging](debugging.md) for general debugging instructions.
+
+To attach a debugger to the unit test process, use: `/waitfordebugger` when calling `test.bat`. 
+Use `/breakonfailure` to automatically break on the first test failure. 
+
+## Tips and tricks
+
+**Building and deploying faster** 
+
+To iterate faster, create a copy of [```UserConfig.cmake.sample```](https://github.com/microsoft/WSL/blob/master/UserConfig.cmake.sample):
+
+```
+copy UserConfig.cmake.sample UserConfig.cmake
+```
+
+And uncomment this line:
+
+```
+# set(WSL_DEV_BINARY_PATH "C:/wsldev")
+```
+
+This will change the build logic to build a smaller package that installs faster.
+Also see:
+
+- `WSL_BUILD_THIN_PACKAGE` to build an even smaller package
+- `WSL_POST_BUILD_COMMAND` to automatically deploy the package during build
+
+**Code formatting**
+
+Every pull request needs to be clang-formatted before it can be merged.
+
+The code can be manually formatted by running: `powershell .\FormatSource.ps1 -ModifiedOnly $false`.
+To automatically check formatting when creating a commit, run: `tools\SetupClangFormat.bat`

doc/docs/index.md

@@ -0,0 +1,10 @@
+# WSL open source documentation
+
+This site contains the developer documentation for the Windows Subsystem for Linux. 
+
+For user documentation, including installation and configuration, see [https://learn.microsoft.com/windows/wsl/](https://learn.microsoft.com/windows/wsl/).
+
+
+To get started developing (building, testing and deploying), see [Getting started](dev-loop.md).
+
+To learn more about how WSL works, see [technical documentation](technical-documentation/index.md)

doc/docs/technical-documentation/boot-process.md

@@ -0,0 +1,116 @@
+# The WSL2 boot process
+
+This page describes the steps in the WSL2 process, from the user invoking [wsl.exe](wsl.exe.md) to the user's Linux shell (bash in this example), in the WSL2 distribution.
+
+## Overview 
+
+The below diagram shows the sequence of events to start bash within a WSL2 distribution. See [WSL architecture](index.md) for details about what each process does.
+
+```mermaid
+sequenceDiagram
+    wsl.exe->>wslservice.exe: CreateInstance(<distro>)
+    wslservice.exe->>wsl.exe: S_OK
+    wsl.exe->>wslservice.exe: CreateLxProcess(<distro>, <command line>, <env>, ...)
+    create participant mini_init
+    wslservice.exe->>mini_init: LxMiniInitMessageEarlyConfig
+    create participant gns
+    mini_init-->>gns: fork(), exec("/gns")
+    wslservice.exe->>gns: LxGnsMessageInterfaceConfiguration
+    gns->>wslservice.exe: LxGnsMessageResult
+    wslservice.exe->>mini_init: LxMiniInitMessageInitialConfig
+    wslservice.exe->>mini_init: LxMiniInitMessageLaunchInit
+    create participant init
+    mini_init-->>init: fork(), exec("/init")
+    init->>wslservice.exe: LxMiniInitMessageCreateInstanceResult
+    wslservice.exe->>init: LxInitMessageCreateSession
+    create participant session leader
+    init-->>session leader: fork()
+    session leader->>wslservice.exe: LxInitMessageCreateSessionResponse
+    wslservice.exe->>session leader: InitCreateProcessUtilityVm
+    create participant relay
+    session leader-->>relay: fork()
+    relay->>wslservice.exe: LxMessageResultUint32 (hvsocket connect port)
+    wslservice.exe->>relay: connect hvsockets for STDIN, STDOUT, STDERR
+    create participant bash
+    relay-->>bash: fork(), exec("/bin/bash")
+    relay<<-->>bash: relay STDIN, STDOUT, STDERR
+    wslservice.exe-->>wsl.exe: S_OK + hvsockets for STDIN, STDOUT, STDERR
+    wsl.exe<<->>relay: Relay STDIN, STDOUT, STDERR
+    destroy bash
+    relay-->>bash: waitpid()
+    relay->>wsl.exe: LxInitMessageExitStatus (process exit code)
+```
+
+## CreateInstance()
+
+When [wslservice.exe](wslservice.exe.md) receives the CreateInstance() call via COM, it will:
+
+1) Identify which distribution the user wants to create. This is done by looking up the `DistributionRegistration` (see `src/windows/service/exe/DistributionRegistration.cpp`) in the Windows registry, matching either on the distribution ID, or using the default if none is provided.
+
+2) Based on the type of distribution (WSL1 or WSL2), either create a WSL1 instance, or start up a WSL2 virtual machine.
+
+3) Associate the newly creating distribution to the calling process (see `src/windows/service/exe/Lifetime.cpp`)
+
+
+## Starting the WSL2 virtual machine
+
+To start a WSL2 distribution, [wslservice.exe](wslservice.exe.md) needs a virtual machine. If the virtual machine isn't already running, it will be created as part of the `CreateInstance()` call. 
+
+The WSL2 virtual machine is created via the [Host Compute System (HCS) service](https://learn.microsoft.com/virtualization/api/hcs/overview) (see `src/windows/service/exe/WslCoreVm.cpp`).
+
+To create a new virtual machine, [wslservice.exe](wslservice.exe.md) generates a JSON string, which describes the virtual machine configuration. This JSON is then passed to [HcsCreateComputeSystem()](https://learn.microsoft.com/virtualization/api/hcs/reference/hcscreatecomputesystem) to create a new virtual machine.
+
+See `src/windows/common/hcs_schema.h` for more details on the HCS JSON schema.
+
+Part of the JSON configuration includes:
+
+- The kernel: WSL will use its built-in kernel, usually installed `C:/Program Files/WSL/tools/kernel`, or a custom kernel if overridden via [.wslconfig](https://learn.microsoft.com/windows/wsl/wsl-config)
+- The initramfs: WSL uses its own initramfs (usually installed in `C:\Program Files\WSL\tools\initrd.img`). It's an image that only contains the [mini_init](mini_init.md) binary
+- The resources accessible to the virtual machine such as CPU, RAM, GPU, etc
+
+When started, the virtual machine will boot into the provided kernel, and then execute [mini_init](mini_init.md).
+
+## The Linux boot process
+
+[mini_init](mini_init.md) is the process that performs usermode initialization inside the virtual machine. After performing various configurations, `mini_init` receives a `LxMiniInitMessageEarlyConfig` message from the [wslservice.exe](wslservice.exe.md) which contains the following information: 
+
+- Identifiers for the system VHD, swap VHD and kernel modules VHD if any
+- The machine's hostname
+- The configured memory reclaim mode and page reporting order
+
+[mini_init](mini_init.md) then creates the [gns process](gns.md), which is responsible for networking configuration and then receives a `LxMiniInitMessageInitialConfig` message, which contains: 
+
+- An entropy buffer, to seed the virtual machine's entropy
+- Information about the GPU drivers shares to mount, if any
+- Whether [wslg](https://github.com/microsoft/wslg) is enabled
+
+After applying all the configuration requested by [wslservice.exe](wslservice.exe.md), the virtual machine is ready to start Linux distributions.
+
+## Starting a Linux distribution
+
+To start a new distribution, [wslservice.exe](wslservice.exe.md) sends a `LxMiniInitMessageLaunchInit` message to [mini_init](mini_init.md), which then mounts the distribution vhd and starts [init](init.md). See ([init](init.md) for more details on WSL2 distributions configuration)
+
+Once running, [wslservice.exe](wslservice.exe.md) can then send a `LxInitMessageCreateSession` message to start a new [session leader](session-leader.md) inside that distribution, which can be used to launch linux processes
+
+## Relaying the linux process's input and output to Windows
+
+Once the user's linux process has been created, [wslservice.exe](wslservice.exe.md) can return from `CreateLxProcess()` back to [wsl.exe](wsl.exe.md). In the case of WSL2, [wsl.exe](wsl.exe.md) receives the following HANDLES: 
+
+- STDIN
+- STDOUT
+- STDERR
+- Control channel
+- Interop channel
+
+The `STDIN`, `STDOUT` and `STDERR` handles are used to relay input and output from the Linux process to the Windows terminal. Depending on the type of handle (terminal, pipe, file, ...), [wsl.exe](wsl.exe.md) will apply different relaying logics (see `src/windows/common/relay.cpp`) to achieve the best compatibility between Windows & Linux. 
+
+The `Control channel` is used to notify the linux process of a change in the terminal (for instance when [wsl.exe's](wsl.exe.md) terminal window is resized) so these changes can be applied to the Linux process as well. 
+
+The `Interop channel` has two usages: 
+
+- Create Windows processes from Linux (see [interop](interop.md))
+- Notify [wsl.exe](wsl.exe.md) when the Linux process has exited (see `LxInitMessageExitStatus`)
+
+Once the Linux process has exited, [wsl.exe](wsl.exe.md) flushes all remaining IO, and exits with the same exit code as the Linux process. 
+
+If [wsl.exe](wsl.exe.md) is terminated before the Linux process exits, [wslhost.exe](wslhost.exe.md) will take over the `Interop channel` and continue to handle requests to execute Windows processes.

doc/docs/technical-documentation/drvfs.md

@@ -0,0 +1,35 @@
+# Accessing Windows drives from Linux
+
+WSL offers mountpoints to access Windows drives from Linux. These mountpoints are mounted under `/mnt` by default, and point to the root of Windows drives.
+
+## Elevated vs non-elevated mountpoints 
+
+Within a distribution, WSL separates between Linux processes that have been created from an elevated (as in administrator level) and from a non-elevated (user level) context. 
+
+This is done by having two separate [mount namespaces](https://man7.org/linux/man-pages/man7/mount_namespaces.7.html) within the distribution. One of them offers an elevated access to Windows drives, and the other offers a non-elevated access to Windows drives.
+
+When a Linux process is created, [wslservice.exe](wslservice.exe.md) determines its elevation status, and then tell [init](init.md) to create the process in the appropriate mount namespace.
+
+## Mounting a Windows drive
+
+*Note: This section only applies to WSL2 distributions. *
+
+When a [session leader](session-leader.md) is created, [wslservice.exe](wslservice.exe.md) starts a [plan9](https://9fans.github.io/plan9port/man/man9/intro.html) file server. This file server can be connected to from the WSL2 virtual machine to mount Windows drives. 
+
+When the WSL distribution is created, [wslservice.exe](wslservice.exe.md) uses the `LX_INIT_CONFIGURATION_INFORMATION` message to indicate whether the process that created the distribution is elevated or not. Based on this, [init](init.md) will mount either the elevated, or un-elevated version of the plan9 server.
+
+Later when the first command is created in the namespace that hasn't been mounted yet, (either elevated, or non-elevated), [wslservice.exe](wslservice.exe.md) sends a `LxInitMessageRemountDrvfs` to [init](init.md), which tell `init` to mount the other namespace. 
+
+See: `src/windows/service/exe/WslCoreInstance.cpp` and `src/linux/drvfs.cpp`. 
+
+## Mounting a drive from Linux 
+
+As long as the Windows plan9 server is running, drives can be mounted simply by calling [mount](https://linux.die.net/man/8/mount). For instance mounting the C: drive manually can be done via: 
+
+```
+mount -t drvfs C: /tmp/my-mount-point
+```
+
+Internally, this is handled by `/usr/sbin/mount.drvfs`, which is a symlink to `/init`. When `/init` starts, it looks at `argv[0]` to determine which entrypoint to run. If `argv[0]` is `mount.drvfs`, then `/init` runs the `mount.drvfs` entrypoint (see `MountDrvfsEntry()` in `src/linux/init/drvfs.cpp`).
+
+Depending on the distribution configuration, `mount.drvfs` will either mount the drive as `drvfs` (WSL1), or  `plan9`, `virtio-plan9` or `virtiofs` (WSL), depending on [.wslconfig](https://learn.microsoft.com/windows/wsl/wsl-config).

doc/docs/technical-documentation/gns.md

@@ -0,0 +1,16 @@
+# GNS
+
+`gns` is a process created by `mini_init`. Its job is to configure networking within the WSL2 virtual machine. 
+
+## Networking configuration 
+
+Networking settings are shared by all WSL2 distributions. While WSL2 is running, `gns` maintains an hvsocket channel to [wslservice.exe](wslservice.exe.md), which is used to send various networking related configurations such as:
+
+- Interface IP configuration
+- Routing table entries
+- DNS configuration
+- MTU size configuration
+
+When DNS tunneling is enabled, `gns` is also responsible for replying to DNS requests.
+
+See `src/linux/init/GnsEngine.cpp` and `src/windows/service/exe/GnsChannel.cpp`