dev_pm_qos_add_request(9)

📦 version 7.3.1, in nixpkgs unstable

💖 dev_pm_qos_add_request(9) 💖

okay bestie, welcome to the Kernel API Manual — yes this is the actual manual page for dev_pm_qos_add_request, and yes we're gonna get through it together, no cap ✨

🌸 NAME 🌸

dev_pm_qos_add_request — inserts new qos request into the list 🫶

✨ SYNOPSIS ✨

int dev_pm_qos_add_request (struct device *dev , struct
dev_pm_qos_request *req , enum dev_pm_qos_req_type type , s32 value );

like literally that's the whole signature, she's not that complicated 💅

🎀 ARGUMENTS 🎀

  • dev — target device for the constraint. this is the device you're doing the whole thing for, bestie 🦋
  • req — pointer to a preallocated handle. you bring the handle, she just fills it in 💜
  • type — type of the request. iykyk 🌈
  • value — defines the qos request. the actual number-vibe you're asking for ⭐

🧚 DESCRIPTION 🧚

okay so here's the tea ☕ — this function inserts a new entry in the device constraints list of requested qos performance characteristics. iconic behavior honestly.

it recomputes the aggregate QoS expectations of parameters and initializes the dev_pm_qos_request handle. two things, one function, main character energy 👑

⚠️ real talk: the caller needs to save this handle for later use in updates and removal. do NOT lose it, bestie. that's your receipt 😭

now the return values, and we are not skipping a single one:

  • returns 1 if the aggregated constraint value has changed
  • returns 0 if the aggregated constraint value has not changed
  • returns -EINVAL in case of wrong parameters
  • returns -ENOMEM if there's not enough memory to allocate for data structures
  • returns -ENODEV if the device has just been removed from the system 💀
🫶 heads up: callers should ensure that the target device is not RPM_SUSPENDED before using this function for requests of type DEV_PM_QOS_FLAGS. like please do the vibe check first, fr fr.

🔥 SEE ALSO 🔥

all the siblings, and there are so many of them, we love a big family 🌸. they live in the kernel file ./drivers/base/power/qos.c:

and that's the whole page, bestie, you ate that 🍓💅

sign-off szn 🎀 this one came from the source ./drivers/base/power, dated October 2026 — slay, go forth and add your requests responsibly ✨👑

📦 where this page comes from