Updated crash dump info in CONTRIBUTING.md
Craig Loewen committed
Oct 23, 2023 at 09:03 UTC
8fa0273e0319cac874be990a8c441e06c37e4bff
1 file changed
+13
-1
CONTRIBUTING.md
+13
-1
@@ -206,7 +206,19 @@ Make sure that the email body contains:
206
207
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).
208
209
-To enable automatic crash dumps, run the following commands in an elevated command prompt:
209
+To force WSL to crash and collect this information, 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:
210
+
211
+```
212
+Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/WSL/master/diagnostics/collect-wsl-logs.ps1" -OutFile collect-wsl-logs.ps1
213
+Set-ExecutionPolicy Bypass -Scope Process -Force
214
+.\collect-wsl-logs.ps1 -Dump
215
+```
216
+
217
+The script will output the path to the log file when it is done.
218
+
219
+#### Enable automatic crash dump collection
220
+
221
+If your crash is sporadic or hard to reproduce, please enable automatic crash dumps to catch logs for this behavior:
222
223
```
224
md C:\crashes