globus_xio...r_instance(3)

✨ NAME ✨

globus_xio_tcp_driver_instance — Opening/Closing 🎀

• Opening/Closing.

okay so this page lives in the Library Functions Manual, and the manpage name is globus_xio...r_instance(3) (yes bestie, that's the truncated lil name, it's giving ✨mysterious✨). Anyway. Let's get into it 🫶

---

🌸 SYNOPSIS 🌸

not me opening this section and finding it literally empty 💀 no synopsis lines, no nothing. The real content is down in Detailed Description, keep scrolling bestie.

---

🦋 Detailed Description 🦋

Opening/Closing. That's the whole vibe. Periodt. 💅

An XIO handle with the tcp driver can be created with either globus_xio_handle_create() or globus_xio_server_register_accept(). Two doors, same destination, slay 🌈

If the handle is created with globus_xio_server_register_accept(), then the globus_xio_register_open() call does nothing more than initialize the internal handle with the accepted socket. That's it. That's the whole job. Lowkey iconic for doing the bare minimum and getting away with it 🧚

If the handle is created with globus_xio_handle_create(), and there is no handle set on the attr passed to the globus_xio_register_open() call, then it performs the equivalent of an asynchronous connect() call. Main character energy fr fr 🔥

In that case, the contact string must contain a host name and service/port. Both the hostname and port number can be numeric or symbolic, like:

some.webserver.com:80
214.123.12.1:http

If the hostname is symbolic and it resolves to multiple ip addresses, each one will be attempted in succession, until the connect is successful or there are no more addresses. She's persistent, she's trying every single one, no cap 💜

---

🎀 When the handle gets closed 🎀

When the XIO handle is closed, the tcp driver will destroy its internal resources and close the socket — unless this socket was set on an attr (in which case, hands off bestie 🙈).

• Any write data pending in system buffers will be sent, unless the linger option has been set.
• Any remaining data in recv buffers will be discarded.
• And (on some systems) a connection reset gets sent to the peer. 😭

bestie be aware: that last part is per-system behaviour, and the discarded recv data is just gone, so plan accordingly 💀

---

👑 Author 👑

Generated automatically by Doxygen for globus_xio from the source code. Not a human, just a lil robot doing its thing 🤖💖

---

sign-off time 🎀 This was globus_xio, Version 6.6, and you just read globus_xio...r_instance(3) from the Library Functions Manual. Go forth and open/close some handles bestie, ily, bye 🦋💅✨