MONGOC_SOCKET_CONNECT(3)

💅 MONGOC_SOCKET_CONNECT(3) — the connect() glow-up, libmongoc edition ✨

okay bestie, so this one lives in the libmongoc manual, and it's genuinely one of those little functions that eats. it's mongoc_socket_connect — the wrapper that makes connect() behave the same whether you're on some UNIX-like situation or on Microsoft Windows. portability slay 🦋

---

🎀 SYNOPSIS 🎀

int
mongoc_socket_connect (mongoc_socket_t *sock,
                       const struct sockaddr *addr,
                       mongoc_socklen_t addrlen,
                       int64_t expire_at);

like, look at her. four args, one int return, no notes. 💅

---

🌸 PARAMETERS 🌸

• sock — a mongoc_socket_t. this is the socket you're connecting, the main character of this whole operation 👑
• addr — a struct sockaddr. the address you wanna connect to, no cap.
• addrlen — a mongoc_socklen_t. the length situation for addr.
• expire_at — an int64_t holding the absolute timeout using the monotonic clock ⏰ like, absolute absolute. not "wait this long," but "give up at this exact moment."

---

✨ DESCRIPTION ✨

so here's the tea 🍓 — this function is a wrapper around the BSD socket connect() interface. the whole point is better portability between UNIX-like platforms and Microsoft Windows. one function, both worlds, iconic behavior. 🌈

it performs a socket connection... but it will fail if expire_at has already been reached by the monotonic clock. so it's giving "connect with a deadline," and the deadline is non-negotiable. 💀

keep in mind — and this is the part people fumble, so pay attention bestie — this is an absolute timeout in milliseconds. absolute. milliseconds. so you should add your desired timeout to System Clock. don't just pass your timeout raw and expect it to vibe check correctly, because it won't. 😭

fr fr: expire_at is a point in time, not a duration. do the math first, then call. 🫶

---

⭐ RETURNS ⭐

• 0 if successful — we love a clean win 💖
• -1 on failure, and errno is set — so go check errno, it's literally telling you what happened 🙈

---

💜 AUTHOR 💜

MongoDB, Inc — yes, that MongoDB. the database girlies. 👑

---

🧚 COPYRIGHT 🧚

2009-present, MongoDB, Inc. — all rights reserved, all vibes preserved. 🎀

---

okay that's the whole page!! version 2.5.6, dated Oct 09, 2026, brought to you by libmongoc and the letter M for MongoDB 💌 mwah, go forth and connect responsibly ✨🦋💅