prepare_rp_ids(9)

✨ prepare_rp_ids — the ring pair ID glow-up ✨

okay so this is a page from the Kernel API Manual (prepare_rp_ids(9)), and honestly? it's a little baddie of a function. it takes a bitmask and turns it into an actual array of ring pair IDs. let's get into it 💅

---

🌸 NAME 🌸

prepare_rp_ids — creates an array of ring pair IDs from a bitmask. that's the whole vibe. mask goes in, array comes out. ✨

---

🦋 SYNOPSIS 🦋

int prepare_rp_ids (struct adf_accel_dev *accel_dev , struct rl_sla *sla
, const unsigned long rp_mask );

copy it exactly bestie, don't freestyle the signature 🙈

---

🎀 ARGUMENTS 🎀

• accel_dev — pointer to the acceleration device structure. literally the device, she's the main character here 👑
• sla — the SLA object data, and this is where the result gets written. it's giving "output parameter energy" 💖
• rp_mask — bitmask of ring pair IDs. the raw material, the blueprint, the moment 🫶

---

🔥 DESCRIPTION 🔥

so what does she actually do? the function tries to convert the provided bitmap into an array of IDs. no cap, that's the whole task.

but first she runs her vibe checks — she checks:

• if the RPs aren't in use ✅
• if they're assigned to the SLA service ✅
• if the number of provided IDs is not too big ✅

and if all of that slays? she writes the result into the field sla->ring_pairs_cnt. periodt. 💅

---

⭐ RETURN ⭐

• 0 — ok ✨ (we love a successful outcome, icon behavior)
• -EINVAL — ring pairs array cannot be created from the provided mask 😭 the mask did not pass the vibe check

---

🌈 SEE ALSO 🌈

the kernel file in question, and honestly a whole friend group of functions:

Kernel file ./drivers/crypto/intel/qat/qat_common/adf_rl.c

then the squad: find_parent(9), adf_rl_get_sla_arr_of_type(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_get_capability_remaining(9), adf_rl_remove_sla(9), adf_rl_remove_sla_all(9) 🫶

---

and that's the page, bestie 🧚 this cutie lives at ./drivers/crypto/intel/qat/qat... and she's dated October 2026, filed under prepare_rp_ids(9). go forth and prepare those IDs 💜💖🎀