From dc43bee4043f74a0cc91e7c2ebc46d43ff4982d0 Mon Sep 17 00:00:00 2001 From: Evan Maddock <5157277+EbonJaeger@users.noreply.github.com> Date: Thu, 2 Nov 2023 11:39:24 -0400 Subject: [PATCH] troubleshooting: Add section for fixing Chromium shader cache (#428) Signed-off-by: Evan Maddock --- docs/user/troubleshooting/index.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/user/troubleshooting/index.md b/docs/user/troubleshooting/index.md index 14f566c58..31f24a50d 100644 --- a/docs/user/troubleshooting/index.md +++ b/docs/user/troubleshooting/index.md @@ -31,6 +31,19 @@ To run database recovery, run `sudo eopkg rdb` in the terminal and then updates ## Updated system and having issues +### Broken UI with Chromium applications + +There is an [upstream bug](https://bugs.chromium.org/p/chromium/issues/detail?id=1442633) with Chromium that causes it to try to use an invalid shader cache instead of rebuilding it, crashing the GPU process. The issue is now fixed in Chromium, but it may take some time for applications to update their Chromium version. + +To fix applications exhibiting this problem, run these commands to remove the shader cache: + +```bash +find ~/.cache -name GPUCache -exec rm -rv {} + +find ~/.config -name GPUCache -exec rm -rv {} + +``` + +And restart the application. + ### Boot into previous kernel `clr-boot-manager` by default retains the latest installed kernel, plus the currently running kernel. This means that when you receive a kernel update, there are two kernels to boot into. Sometimes there are regressions that occur in the kernel, so you are able to boot into the previous kernel if the update has caused any hardware issues (for example failing to suspend when it worked previously). When booting via EFI, the boot menu can be shown by hitting space (repeatedly) during boot.