UPDATE-GRUB-GFXPAYLOAD(8)

💖 update-grub-gfxpayload — bestie edition 💖

okay so this is update-grub-gfxpayload(8) from the LOCAL manual, and honestly? she's a little niche but she's doing her job. let's get into it 🫶

✨ NAME ✨

update-grub-gfxpayload — updates /boot/grub/gfxblacklist.txt, no cap 💅

🌸 SYNOPSIS 🌸

update-grub-gfxpayload

that's it. no flags. no arguments. she takes nothing and she gives everything ✨

🦋 DESCRIPTION 🦋

so here's the tea, bestie: update-grub-gfxpayload refreshes /boot/grub/gfxblacklist.txt using the source files hanging out in /usr/share/grub-gfxpayload-lists/blacklist/ 📂✨

and what is that blacklist even for? it disables GRUB's gfxpayload=keep facility on certain graphics cards. basically some GPUs just can't handle the vibe and the blacklist is there to protect them 🙈💀

real talk though: this thing should normally only need to be called internally by packages. she's a behind-the-scenes queen, not a main character you invoke by hand. packages run her, she does her thing, everyone moves on. periodt. 👑

BUT — if you personally need to turn off gfxpayload=keep locally (maybe because your system boots into a black screen or a corrupt screen, which is genuinely the worst 😭), then bestie, you do not need this program at all. don't touch her. instead, just add this line to /etc/default/grub:

GRUB_GFXPAYLOAD_LINUX=text

that's the move. simple, clean, iconic. ✨🎀

👑 AUTHOR 👑

Colin Watson <cjwatson@ubuntu.com> — the legend herself 💜

🌈 SEE ALSO 🌈

ngl there's no SEE ALSO section in the original, and I'm not about to invent one because that would be making stuff up and we don't do that here 💅 so just... go forth and enjoy your non-black screen 🦋

okay and finally, the cute lil sign-off: this page came from Ubuntu, dated December 16, 2010 🌸 and it's filed under UPDATE-GRUB-GFXPAYLOAD(8). that's the whole page, bestie — you ate it, you understood it, you're literally a Unix girlie now 💖✨🎀🫶