TT_DEFAULT_SESSION(3)

✨ tt_default_session ✨

okay bestie, welcome to the tt_default_session glow-up 💅 this one's a library call (yes, our fave genre), and it's literally just here to hand you the current default session identifier. no cap, that's the whole vibe 🎀

---

🌸 NAME 🌸

tt_default_session — retrieve the current default session identifier 🦋

---

✨ SYNOPSIS ✨

#include <Tt/tt_c.h>
char *tt_default_session(void)

that's it, that's the whole signature — no arguments, no drama, just a void and a char * coming back at you 🫶

---

💖 DESCRIPTION 💖

so the tt_default_session function retrieves the current default session identifier. that's the tea ☕ literally its one job and it ate 🔥

---

👑 RETURN VALUE 👑

upon successful completion, tt_default_session returns the pointer to the unique identifier for the current default session, periodt 💅

if that pointer is NULL, then no default session is set — and that's your signal that something's up 🙈 to actually find out what, your app can use tt_ptr_error(3) to extract one of these Tt_status values from the returned pointer:

• TT_OK — the operation completed successfully, slay ✅
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it 😭
• TT_ERR_PROCID — the current default process identifier is out of date or invalid 💀

---

🌈 APPLICATION USAGE 🌈

okay so important lore incoming 🧚 a session can have more than one session identifier. which means — and bestie listen — the application cannot compare the result of tt_default_session with the result of tt_message_session(3) to verify that the message was sent in the default session. iykyk, that comparison is a social faux pas, do not do it 🙅

fr fr, do not compare those two things. the manpage said what it said 💀

also, the application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. be a good citizen, free your pointers 🫶

---

⭐ SEE ALSO ⭐

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

---

and that's the page, bestie 🎀 this little icon was brought to you by the tt_default_session(library call) source, version and date energy — go forth, grab your default session, and remember to tt_free(3) your stuff 💜✨👑