vga_default_device(9)

💅 vga_default_device(9) 💅

ok so this is a page from the Kernel API Manual, and it's all about vga_default_device — the function that hands you the default VGA device, specifically for vgacon. yes bestie, we're in kernel land today, buckle up 🎀

✨ SYNOPSIS ✨

struct pci_dev * vga_default_device (void );

🌸 ARGUMENTS 🌸

• void — literally no arguments. nothing. zero. she takes nothing and she gives you a struct pci_dev *. iconic behavior honestly 🫶

🦋 DESCRIPTION 🦋

okay so here's the tea: this whole thing can be defined by the platform. like, the platform gets to decide. and the default implementation? ngl it's rather dumb 😭 like it will probably only work properly on single VGA card setups and/or x86 platforms. that's the vibe. that's what we're working with.

and then — the big caveat — if your VGA default device is not PCI, you'll have to return NULL here. that's the rule, no cap. in that case, the author assumes it will not conflict with any PCI card. but if that assumption is not true? then they'll have to define two arch hooks for enabling/disabling the VGA default device, if that's even possible. 💀

and it gets messier, because this may be a problem with real ISA VGA cards, in addition to a PCI one. like, both at once. and at this point the author genuinely doesn't know how to deal with that card. can their IOs be disabled at all?? genuinely asking, no answer given 🙈 and if they can't be disabled, then it's basically a matter of having the proper arch hook telling us about it, so we basically never allow anybody to succeed a vga_get.

⚠️ heads up bestie: returning NULL is a real escape hatch, but the "no conflict with PCI cards" thing is an assumption, not a guarantee. if it doesn't hold, arch hooks are the fallback — and the ISA-plus-PCI situation is flat-out unresolved in this doc. don't @ me, @ the kernel 💀

👑 SEE ALSO 👑

• Kernel file ./drivers/pci/vgaarb.c
• vga_remove_vgacon(9)
• vga_get(9)
• vga_tryget(9)
• vga_put(9)
• vga_set_legacy_decoding(9)
• vga_client_register(9)

these are the sisters, the friends, the whole friend group — go read them next, iykyk 💖

ok that's the whole page, you ate that fr fr 🍓 this one lives in ./drivers/pci, dated October 2026, and it's vga_default_device(9) from the Kernel API Manual — mwah, go slay your VGA setup bestie ✨💅