bnx2i_drop_session(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… bnx2i_drop_session β€” a little Kernel API Manual moment (section 9, bestie)

okay so real talk, this one lives in the Kernel API Manual, section 9, and it's called bnx2i_drop_session. it's tiny. it's iconic. let's go 🫢


✨ SYNOPSIS ✨

void bnx2i_drop_session (struct iscsi_cls_session *cls_session );

that's it. that's the whole vibe. no return value, no drama 🌸


πŸŽ€ ARGUMENTS πŸŽ€

  • cls_session β€” the iscsi cls session pointer, aka the main character of this whole function πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

so what does it do? it notifies iscsid that there's an error, so iscsid can go ahead and initiate recovery. like, "hey bestie, something's up, go fix it" πŸ“£

and here's the part you cannot skip, ngl: this function relies on the caller using the iscsi class iterator so that the object is refcounted and does not disapper from under us. (yes, that's spelled exactly like that in the original β€” we don't fix typos, we respect them πŸ™ˆ) so if you're not iterating the iscsi class, the object could vanish mid-call and that would be a whole mess. use the iterator. periodt ✨

lowkey important: the refcount safety net only exists if you, the caller, are using the iscsi class iterator. no iterator, no safety. don't do that to yourself πŸ’€

πŸ‘‘ SEE ALSO πŸ‘‘

like, that's the whole friend group right there πŸ§šπŸ’œ


and that's the page!! mwah πŸ’‹ this little number shipped out of ./drivers/scsi/bnx2i in October 2026 β€” go read the source, it's giving lore 🌈⭐

πŸ“¦ where this page comes from