adf_rl_get_...ty_remaining(9)

💖 adf_rl_get_capability_remaining — the Kernel API Manual glow-up ✨

okay so bestie, we're in the Kernel API Manual today and the star of the show is adf_rl_get_capability_remaining(9) — yes the header line got shortened to adf_rl_get_...ty_remaining(9) up top, that's just the terminal being extra, she's fine 🎀

---

🌸 NAME 🌸

adf_rl_get_capability_remaining — returns the remaining SLA value (CIR) for selected service or provided sla_id. literally her whole job 💅

---

✨ SYNOPSIS ✨

int adf_rl_get_capability_remaining (struct adf_accel_dev *accel_dev ,
enum adf_base_services srv , int sla_id );

like, three args, one int back, we love a clean signature 🫶

---

🦋 ARGUMENTS 🦋

• accel_dev — pointer to acceleration device structure. the whole device vibe, she needs it 💜
• srv — service ID for which capability is requested. tell her which service you're asking about 🌸
• sla_id — ID of the cluster or root to which we want assign a new SLA. that's the one, the ID itself 🔥

---

💅 DESCRIPTION 💅

so here's what she does, no cap: first she checks if the provided SLA id is valid. if it is valid, and the service matches the requested service, and the type is cluster or root — she returns the remaining capability. slay, straightforward 👑

but if the provided ID does not match the service or type? she doesn't just give up, she falls back and returns the remaining capacity of the default cluster for that service. main character energy honestly, she always has a backup plan 💖

---

🌈 RETURN 🌈

• Positive value — correct remaining value ✨ (good vibes, real number)
• -EINVAL — algorithm cannot find a remaining value for provided data 😭 (she looked, bestie, it's not there)

---

🧚 SEE ALSO 🧚

Kernel file ./drivers/crypto/intel/qat/qat_common/adf_rl.c — that's where she lives, go say hi 🏠

and her whole friend group, fr fr:

find_parent(9), adf_rl_get_sla_arr_of_type(9), prepare_rp_ids(9), can_parent_afford_sla(9), can_node_afford_update(9), get_next_free_sla_id(9), get_next_free_node_id(9), add_new_sla_entry(9), add_update_sla(9), adf_rl_add_sla(9), adf_rl_update_sla(9), adf_rl_get_sla(9), adf_rl_remove_sla(9), adf_rl_remove_sla_all(9)

---

💀 quick reminder: the file path in SEE ALSO shows up truncated as ./drivers/crypto/intel/qat/qat... in the footer, that's just the page being shy, the real one is the full path above 🍓

---

okay and finally the cute sign-off 🎀 this one comes from ./drivers/crypto/intel/qat/qat... and it's dated October 2026 — yeah, future-coded icon behavior, periodt ⭐ go read the source, ily, bye 💜🦋