rdma_set_ack_timeout(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… rdma_set_ack_timeout(9) πŸ’…

ok so you're literally reading a Kernel API Manual page, bestie, and it's about rdma_set_ack_timeout β€” a whole little function that sets the ack timeout of a QP that's associated with a connection identifier. yes that's a lot of acronyms, we'll get there 🫢


✨ NAME ✨

rdma_set_ack_timeout β€” Set the ack timeout of QP associated with a connection identifier.

🌸 SYNOPSIS 🌸

int rdma_set_ack_timeout (struct rdma_cm_id *id , u8 timeout );

like, that's the whole vibe. two args, one int coming back at you. periodt. ✨

πŸŽ€ ARGUMENTS πŸŽ€

  • id β€” the communication identifier to associated with service type. (their words, not mine 😭 β€” it's the rdma_cm_id you're tying this to.)
  • timeout β€” the ack timeout you're setting on a QP, and it's expressed as 4.096 * 2^(timeout) usec. yes, that's the actual formula, no cap, write it on your hand πŸ’œ

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so timing matters SO much here, like main character energy for real:

This function should be called before rdma_connect on the active side, and on the passive side before rdma_accept. ⏰

It is applicable to primary path only β€” don't get cute with it elsewhere πŸ™ˆ

The timeout will affect the local side of the QP. it is not negotiated with the remote side, and zero disables the timer. so yeah, 0 = timer off, iconic little detail πŸ’…

And β€” this is the juicy part β€” in case it is set before rdma_resolve_route, the value will also be used to determine PacketLifeTime for RoCE. two birds, one syscall, we love efficiency 🐦✨

⭐ RETURN ⭐

0 for success. that's it. that's the whole return section, slay πŸ’–

🌈 SEE ALSO 🌈

Kernel file ./drivers/infiniband/core/cma.c β€” and a whole friend group of functions you should also go read:


ngl bestie, if you're touching RoCE paths, double-check the ordering rules above before you ship. the "before rdma_connect / before rdma_accept" thing is not a suggestion, it's giving load-bearing 🫢

aaaaand that's the page!! 🌸 signed off from ./drivers/infiniband/core, dated October 2026 β€” go set some timeouts, you absolute icon πŸ‘‘πŸ’œ

πŸ“¦ where this page comes from