rpma_conn_...ivate_data(3)

📦
version 1.3.0 · 3 versions
, in ubuntu noble

✨ rpma_conn_get_private_data — get a pointer to the connection's private data ✨

okay bestie, welcome to the RPMA Programmer's Manual 💖 this one's a lil function from librpma called rpma_conn_get_private_data, and she's giving handshake gossip energy — she hands you a pointer to the private data the other side of your connection sent over. cute, right? 🎀

🌸 NAME 🌸

rpma_conn_get_private_data — grab a pointer to the connection's private data 💅

🦋 SYNOPSIS 🦋

#include <librpma.h>

struct rpma_conn;
struct rpma_conn_private_data;
int rpma_conn_get_private_data(const struct rpma_conn *conn,
                struct rpma_conn_private_data *pdata);

✨ DESCRIPTION ✨

so basically, rpma_conn_get_private_data() obtains the pointer to the private data that was given by the other side of the connection. that's it. that's the whole vibe. the peer slid you their data and this function is the lil messenger that tells you where it's at 🫶

🔥 SECURITY WARNING 🔥

no cap, this one's serious. the connection's private data is INSECURE. 😭

an attacker might modify all data transferred via the rdma_cm private data. like, all of it. not a vibe.

users should avoid using rpma_conn_get_private_data(3) and rpma_conn_req_get_private_data(3) API calls, and they should utilize TLS/SSL connections to transfer all configuration data between peers instead. protect your data, bestie, she deserves it 💜

👑 RETURN VALUE 👑

rpma_conn_get_private_data() returns 0 on success, or a negative error code on failure. and heads up — on failure, rpma_conn_get_private_data() does not set *pdata. so don't go reading that value like it's gonna be something. it's not. 🙈

💀 ERRORS 💀

rpma_conn_get_private_data() can fail with the following error:

  • RPMA_E_INVAL — conn or pdata is NULL 💅 (yeah, passing NULL is not the move, periodt)

🌈 SEE ALSO 🌈

and that's the whole page, bestie 🎀 go forth and pointer responsibly ✨

RPMA — 01 April 2024 — mwah, sending you the fluffiest of vibes from the RPMA Programmer's Manual 🫶💖🧚‍♀️

📦 where this page comes from