MANUAL SWITCHING AND MANUAL POWER CONTROL(9)

✨ Manual switching and manual power control ✨

okay so bestie, this is the Kernel API Manual, section 9, and it is literally all about Manual switching and manual power control. slay. 🫶

🌸 the mode + the magic file 🌸

in this mode of use, the file /sys/kernel/debug/vgaswitcheroo/switch can be read to retrieve the current vga_switcheroo state, and commands can be written to it to change the state. ✨

the file appears as soon as two GPU drivers and one handler have registered with vga_switcheroo. iconic.

🎀 commands it understands 🎀

• OFF — power off the device not in use. 💤
• ON — power on the device not in use. ⚡
• IGD — switch to the integrated graphics device. power on the integrated GPU if necessary, power off the discrete GPU. prerequisite is that no user space processes (e.g. Xorg, alsactl) have opened device files of the GPUs or the audio client. if the switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/ and /dev/snd/controlC1 to identify processes blocking the switch. 🔍
• DIS — switch to the discrete graphics device. 🎮
• DIGD — delayed switch to the integrated graphics device. this will perform the switch once the last user space process has closed the device files of the GPUs and the audio client. ⏳
• DDIS — delayed switch to the discrete graphics device. ⏳
• MIGD — mux-only switch to the integrated graphics device. does not remap console or change the power state of either gpu. if the integrated GPU is currently off, the screen will turn black. if it is on, the screen will show whatever happens to be in VRAM. either way, the user has to blindly enter the command to switch back. 🙈💀
• MDIS — mux-only switch to the discrete graphics device. 🌀

🫶 little caveats 🫶

for GPUs whose power state is controlled by the driver's runtime pm, the ON and OFF commands are a no-op (see next section). 💅

⚠️ for muxless machines, the IGD/DIS, DIGD/DDIS and MIGD/MDIS commands should not be used. periodt.

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/vga/vga_switcheroo.c Overview(9)
• struct vga_switcheroo_client(9)
• struct vgasr_priv(9)
• vga_switcheroo_register_handler(9)
• vga_switcheroo_unregister_handler(9)
• vga_switcheroo_handler_flags(9)
• vga_switcheroo_register_client(9)
• vga_switcheroo_register_audio_client(9)
• vga_switcheroo_client_probe_defer(9)
• vga_switcheroo_get_client_state(9)
• vga_switcheroo_unregister_client(9)
• vga_switcheroo_client_fb_set(9)
• vga_switcheroo_lock_ddc(9)
• vga_switcheroo_unlock_ddc(9)
• vga_switcheroo_process_delayed_switch(9)
• Driver power control(9)
• vga_switcheroo_init_domain_pm_ops(9)

mwah 💋 this cutie page is sourced from ./drivers/gpu/vga and dated October 2026. go off, bestie. 🌟