RDMA_GET_REQUEST(3)

💖 RDMA_GET_REQUEST 💖

okay bestie, so you know rdma_get_request from the librdmacm programmer's manual? yeah. this is that. it grabs the next pending connection request event off your listening endpoint, and honestly? it's giving gatekeeper of the group chat. nothing gets in without it. 🎀

✨ NAME ✨

rdma_get_request — retrieves the next pending connection request event. literally that's the whole job. she's focused. 💅

🌸 SYNOPSIS 🌸

#include <rdma/rdma_cma.h>

int rdma_get_request (struct rdma_cm_id *listen, struct rdma_cm_id
**id);

🦋 ARGUMENTS 🦋

• listen — your listening rdma_cm_id. the one standing at the door with the clipboard. 👑
• id — the rdma_cm_id that gets associated with the new connection. new bestie acquired fr fr.

💜 DESCRIPTION 💜

Retrieves a connection request event. that's it, that's the vibe.

and here's the important part, no cap: if no requests are pending, the call will block until an event is received. like, it will sit there. patiently. waiting. not moving. not texting back. just waiting for that event to show up. 😭

🔥 RETURN VALUE 🔥

Returns 0 on success, or -1 on error. and if it errors out? errno will be set to indicate the failure reason. she always tells you what went wrong. icon behaviour. ✨

👑 NOTES 👑

• This call may only be used on listening rdma_cm_id's operating synchronously. so don't try to be cute with it in async mode, bestie, she said what she said. 💀
• On success, a new rdma_cm_id representing the connection request will be returned to the user. fresh id, fresh start. 🌈
• The new rdma_cm_id will reference event information associated with the request until the user calls rdma_reject, rdma_accept, or rdma_destroy_id on the newly created identifier. so like, that event info is your plus-one and it's staying until you officially wrap things up. don't leave it hanging. 🫶
• For a description of the event data, see rdma_get_cm_event. (she has the lore. go read her.) 📖
• If QP attributes are associated with the listening endpoint, the returned rdma_cm_id will also reference an allocated QP. cute little bonus package. 🎁

⭐ SEE ALSO ⭐

• rdma_get_cm_event(3)
• rdma_accept(3)
• rdma_reject(3)
• rdma_connect(3)
• rdma_listen(3)
• rdma_destroy_id(3)

okay that's the whole page, you ate that, go build something iconic 💖

this was brought to you by librdmacm, dated 2007-10-31 — yes she's been serving since 2007 and she's still main character energy. periodt. 🎀✨