TT_X_SESSION(3)

💖 NAME 💖

okay bestie, welcome to the tt_X_session(library call) page ✨

• tt_X_session — return the session associated with an X window system display 💅

---

🌸 SYNOPSIS 🌸

include this header and call it like this, fr fr:

#include &<Tt/tt_c.h>
char *tt_X_session(
const char *xdisplaystring);

---

🦋 DESCRIPTION 🦋

The tt_X_session function returns the session associated with the named X window system display. iconic behavior, honestly 💖

The application can call tt_X_session before it calls tt_open(3). yes bestie, before 👑✨

The xdisplaystring argument is the name of an X display server; for example, somehost:0 or :0. literally just the display name 🎀

---

⭐ RETURN VALUE ⭐

Upon successful completion, the tt_X_session function returns the identifier for the ToolTalk session associated with the named X window system display. slay 💅

The application can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned pointer:

• TT_OK — the operation completed successfully ✨
• TT_ERR_SESSION — the xdisplaystring does not name an X display 😭
• TT_ERR_POINTER — the xdisplaystring is NULL 💀

---

🌈 APPLICATION USAGE 🌈

The application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. cleanup era, no cap 🫶🧚

---

🔥 SEE ALSO 🔥

Tt/tt_c.h - Tttt_c(5), tt_ptr_error(3), tt_open(3), tt_free(3).

---

and that’s the whole tt_X_session(library call) page, bestie 🫶💖 — the footer is just tt_X_session(library call) with no extra source/version or date info listed, so that’s the cute little sign-off 💅✨