You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-12Lines changed: 20 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,28 +8,36 @@ Provides a list of installed distributions, the official Linux distro name, the
8
8
9
9
## wslctl
10
10
11
-
Allows WSL distros to be started on launch. The syntax follows that of systemctl:
11
+
Allows WSL distros to be started on Windows startup. The syntax follows that of systemctl:
12
12
13
-
```
14
-
wslctl enable pengwin
15
-
wslctl disable pengwin
16
-
wslctl restart pengwin
17
-
```
13
+
`wslctl enable pengwin`
14
+
15
+
`wslctl disable pengwin`
16
+
17
+
`wslctl restart pengwin`
18
+
19
+
## wsl-dist-update
20
+
21
+
Run package updates on all installed WSL distros. Tested on: Pengwin, Fedora Remix for WSL, Ubuntu, Debian, openSUSE Tumbleweed, ArchWSL, Oracle Linux, and the WSL.
22
+
23
+
wsl-dist-update can optionally additionally update the WSL system distro by passing the `--system` option.
24
+
25
+
To run wsl-dist-update as a service, copy wsl-dist-update.exe to a permanent location and run wsl-dist-update-sched.ps1, modifying the path to the .exe as needed.
18
26
19
27
## wsl-reset
20
28
21
-
A troubleshooting utility that resets WSL to various degrees.
29
+
A troubleshooting utility that resets the WSL 2 stack to various degrees.
22
30
23
-
`wsl-reset --reset` - shuts down WSL, resets the WSL service, and installs any WSL updates, if available
31
+
`wsl-reset --reset` - Shuts down WSL, resets the WSL service, and installs any WSL updates, if available.
24
32
25
-
`wsl-reset --hard-reset` - shuts down WSL, stops the WSL service, uninstalls WSL, and re-installs WSL
33
+
`wsl-reset --hard-reset` - Shuts down WSL, stops the WSL service, uninstalls WSL, and re-installs WSL.
26
34
27
-
`wsl-reset --destrutive-reset` - shuts down WSL, restarts the WSL service, **unregisters all WSL distros**, stops the WSL service, uninstalls WSL, and re-installs WSL
35
+
`wsl-reset --destrutive-reset` - Shuts down WSL, restarts the WSL service, **unregisters all WSL distros**, stops the WSL service, uninstalls WSL, and re-installs WSL.
28
36
29
37
## sysdistrowt
30
38
31
39
Adds the WSL System Distro (CBL-Mariner) to the Windows Terminal and/or Windows Terminal Preview profiles, for easier debugging.
32
40
33
-
### Misc
41
+
##build-wslinternals
34
42
35
-
/prompts folder contains example AI prompts used to generate the first draft of these scripts, the final scripts got hand polished, but they are there to see.
43
+
Builds wslinternals PowerShell scripts to .exe files using ps2exe. Requires PowerShell 5.
0 commit comments