RPMA_CONN_CFG_SET_TIMEOUT(3)

💖 rpma_conn_cfg_set_timeout — set connection establishment timeout 💖

okay bestie, welcome to the RPMA Programmer's Manual 🫶 this is the page for rpma_conn_cfg_set_timeout(3) and it's genuinely such a lil cutie. it does one (1) thing and it does it well. no cap.

---

✨ SYNOPSIS ✨

#include <librpma.h>

struct rpma_conn_cfg;
int rpma_conn_cfg_set_timeout(struct rpma_conn_cfg *cfg, int timeout_ms);

like yes, that's the whole thing. short king behavior 👑

---

🌸 DESCRIPTION 🌸

so rpma_conn_cfg_set_timeout() sets the connection establishment timeout. that's it, that's the job, and honestly? she's thriving 💅

the way this works is: you hand her a cfg and a timeout_ms, and she writes that timeout into your config so future-you knows how long to wait around for a connection to show up before giving up on it.

⚠️ real talk tho: if you never call this function, the timeout just has the default value of 1000 — and that default was set for you by rpma_conn_cfg_new(3). so if you're sitting there like "wait why is it 1000??" — bestie, it's because you didn't call this. mystery solved 🔍✨

---

🌈 RETURN VALUE 🌈

• 0 — slay! success, we ate, no crumbs 🎀
• negative error code — uh oh, something went wrong (see below, she's dramatic but she's fine)

---

💀 ERRORS 💀

rpma_conn_cfg_set_timeout() can fail with the following error:

• RPMA_E_INVAL — cfg is NULL or timeout_ms < 0. yeahhh so you either passed her nothing at all, or you tried to give her a negative timeout and she was like "girl. no. 🚫" — negative time is not a vibe, not even a little bit, not even a tiny amount. time moves forward only. periodt.

---

🔥 SEE ALSO 🔥

• rpma_conn_cfg_new(3) — the one who sets your default 1000, iconic behavior
• rpma_conn_cfg_get_timeout(3) — for when you wanna read it back and go "oh okay that's what I set" 👀
• librpma(7) — the big picture, the lore, the origin story
• <https://pmem.io/rpma/> — go click it, it's giving documentation main character energy ⭐

---

🦋 cute sign-off 🦋

this page lives in the RPMA manual and it's dated 01 April 2024 💜 so yeah, that's the whole thing — go set your timeouts, be responsible, and remember: NULL is not a personality trait, bestie. bye!! 🎀✨🧚💖