RDMA_ESTABLISH(3)

🌸 NAME 🌸

okay so this is RDMA_ESTABLISH(3) from the Librdmacm Programmer’s Manual, and it’s all about rdma_establish β€” the function that completes an active connection request. periodt. πŸ’…

✨ SYNOPSIS ✨

#include <rdma/rdma_cma.h>

int rdma_establish(struct rdma_cm_id *id);

πŸ¦‹ DESCRIPTION πŸ¦‹

rdma_establish() acknowledges an incoming connection response event and completes the connection establishment. It’s giving β€œyes bestie, we’re connected” energy. πŸ’–

πŸ“ Notes πŸ“

  • If a QP has not been created on the rdma_cm_id, this function should be called by the active side to complete the connection.
  • Call it after getting the connect response event. ⭐
  • This will trigger a connection established event on the passive side. ✨
  • This function should not be used on an rdma_cm_id on which a QP has been created. That’s the vibe check it fails. πŸ’€

πŸŽ€ ARGUMENTS πŸŽ€

  • id β€” the RDMA identifier. That’s the main character right there. πŸ‘‘

πŸ’… RETURN VALUE πŸ’…

  • rdma_establish() returns 0 on success.
  • It returns -1 on error.
  • If an error occurs, errno will be set to indicate the failure reason. 😭

πŸ”₯ SEE ALSO πŸ”₯

πŸ‘‘ AUTHORS πŸ‘‘

  • Danit Goldberg <danitg@mellanox.com>
  • Yossi Itigin <yosefe@mellanox.com>

And that’s the whole iconic page, bestie. It’s from librdmacm and dated 2019-01-16 β€” so go forth and establish those connections responsibly. πŸ«ΆπŸ’–

πŸ“¦ where this page comes from