rdma_move_ah_attr(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… rdma_move_ah_attr(9) β€” like, the Kernel API Manual, but make it make sense ✨

okay bestie, buckle up β€” this is rdma_move_ah_attr from the kernel API manual (section 9, the fancy "kernel internals" one πŸŽ€). she's short, she's sweet, and honestly she's giving "tiny function, big consequences" energy. let's go πŸ’–


🌸 NAME 🌸

rdma_move_ah_attr β€” moves the ah_attr that source is pointing at over to destination. yes, that's it. that's the whole vibe. moving a thing from point A to point B, no cap 🫢


✨ SYNOPSIS ✨

void rdma_move_ah_attr (struct rdma_ah_attr *dest , struct rdma_ah_attr
*src );

like, two pointers, zero return value. she's a void girlie and she's thriving πŸ’…


πŸ¦‹ ARGUMENTS πŸ¦‹

  • dest β€” pointer to the destination ah_attr, i.e. the place we're copying to. the docs are lowkey clear about this: dest is assumed to be valid or zero'd. so please, bestie, don't hand her uninitialised garbage πŸ™ˆ
  • src β€” pointer to the new ah_attr. the fresh one. the incoming main character πŸ‘‘

πŸ”₯ DESCRIPTION πŸ”₯

okay so here's what actually happens, and this part is important so like, pay attention πŸ’€

rdma_move_ah_attr first releases any reference in the destination ah_attr β€” but only if it is valid. so if dest was already holding onto something, she cleans up after herself before moving on. responsible queen behaviour, honestly πŸ‘‘

then β€” and this is the iconic bit β€” it transfers ownership of the internal references from src to dest, which makes src invalid in the process. not "kinda stale", not "probably fine" β€” invalid. src is done, she's retired, she's not coming to the group chat anymore 😭

and just to be super clear: no new reference of the src ah_attr is taken. zero. none. it's a move, not a copy β€” the references literally pack up and change addresses. so if you were planning on using src afterwards, bestie... no you weren't. 🫢


🌈 SEE ALSO 🌈

that's the whole squad, all 26 of them, no gatekeeping πŸ§šπŸ’œ


⚠️ friendly reminder before you go: after this call, src is invalid. do not touch. do not pass go. she has left the building. πŸ’€

okay that's the page!! source dir is ./drivers/infiniband/core, dated October 2026, and the page itself is rdma_move_ah_attr(9) β€” mwah, love that for us πŸ’–βœ¨πŸŽ€ slay, stay hydrated, and always release your references bestie πŸ“πŸ¦‹

πŸ“¦ where this page comes from