zfcp_reqlist_find_rm(9)

📦 version 7.3.1, in nixpkgs unstable

💅 zfcp_reqlist_find_rm — the Kernel API Manual, bestie edition ✨

okay so this is a page from the Kernel API Manual (zfcp_reqlist_find_rm(9)) and honestly? it's giving "small function, big responsibilities" 🎀 because it does two things at once and holds a lock the whole time. iykyk.

🌸 NAME 🌸

zfcp_reqlist_find_rm — look up a request by its id and then yeet it out of the reqlist 🫶 (that's the whole vibe, no cap)

✨ SYNOPSIS ✨

struct zfcp_fsf_req * zfcp_reqlist_find_rm (struct zfcp_reqlist *rl ,
       u64 req_id );

like yes bestie, it returns a pointer to a struct zfcp_fsf_req * and it takes exactly these two args 💖

🦋 ARGUMENTS 🦋

  • rl — the reqlist you're gonna search through and remove the entry from. it's literally the main character here 👑
  • req_id — the request id of the request you're hunting for 🔍 (u64, in case you were wondering, and yes that's in the synopsis, slay)

💜 DESCRIPTION 💜

so here's the tea ☕ — this function tries to find the FSF request with the specified id, and then removes it from the reqlist. that's it, that's the whole arc 💫

the important part tho: the reqlist lock is held during both steps of the operation. both of them. find and remove. no gaps, no "oops i dropped the lock in between" energy 🙈 — it's one continuous locked operation and that is genuinely iconic of it tbh.

⭐ RETURN ⭐

  • pointer to the FSF request — if the request has been found 🎉
  • NULL — if it has not been found 😭

that's the whole return contract, no extra surprises fr fr.

🌈 SEE ALSO 🌈

all the reqlist besties, in the kernel file ./drivers/s390/scsi/zfcp_reqlist.h:

go read them, they're all part of the same friend group 💅

ngl this one is a tiny function but it's doing lock-safe lookup-and-delete and that's a whole mood. treat the NULL return with respect — it means "not found", not "something broke" 💀

and that's the page!! 🍓 it lives over in ./drivers/s390/scsi in the kernel tree, and the manual page itself is dated October 2026 — so yeah, future-dated kernel docs, we love to see it 🧚💖 mwah, go forth and remove requests safely bestie 🫶✨

📦 where this page comes from