amdgpu_devic...gating_state(9)

✨ amdgpu_device_ip_set_powergating_state ✨

okay so bestie, welcome to the kernel API manual for amdgpu_device_ip_set_powergating_state — this one lives in the kernel docs (section 9, the kernel API section 💅) and it's basically the function that flips the power-gating switch for your GPU's IP blocks. she's giving "lights off, bestie" energy fr fr 🎀

🌸 NAME 🌸

amdgpu_device_ip_set_powergating_state — set the PG state 💤⚡

🦋 SYNOPSIS 🦋

int amdgpu_device_ip_set_powergating_state (struct amdgpu_device *adev ,
       enum amd_ip_block_type block_type , enum amd_powergating_state state );

that's the whole signature, no cap — it returns an int, and the three args are asterisk-free except for adev which is a pointer obvi 💅

🎀 ARGUMENTS 🎀

• adev — a pointer to the amdgpu_device struct. the main character herself 💖
• block_type — the type of hardware IP you want, like SMU, GFX, UVD, etc. etc. — pick your fave enum amd_ip_block_type 💜
• state — the powergating state you want (gate or ungate, bestie — it's giving binary) 🌸

🔥 DESCRIPTION 🔥

so what does she actually do? <hotpink>Sets the requested powergating state</hotpink> for all instances of the hardware IP specified. all of them. every single one. no leaving anyone behind 💅

and when she's done, she returns <cyan>the error code from the last instance</cyan> — so like, she doesn't stop at the first error, she goes all the way through and then reports what the last one said. iconic behaviour honestly 👑

ok but fr: if you're checking for success, remember the return value is from the last instance, not the first failure. just so you're not surprised, bestie 🙈

⭐ SEE ALSO ⭐

• kernel file: ./drivers/gpu/drm/amd/amdgpu/amdgpu_ip.c
• amdgpu_device_ip_get_ip_block(9)
• amdgpu_device_ip_block_version_cmp(9)
• amdgpu_device_ip_block_add(9)
• amdgpu_device_ip_set_clockgating_state(9)
• amdgpu_device_ip_get_clockgating_state(9)
• amdgpu_device_ip_wait_for_idle(9)
• amdgpu_device_ip_is_valid(9)
• amdgpu_ip_from_ring(9)
• amdgpu_ring_mask_from_ip(9)
• amdgpu_device_ip_soft_reset(9)

🫶 and that's a wrap, bestie!! this page is brought to you by the fine folks over at ./drivers/gpu/drm/amd/amdgpu — dated October 2026, section 9 of the kernel API manual. go forth and gate responsibly 💖✨🎀🦋💅