TT_MESSAGE_SESSION(3)

💖 NAME 💖

tt_message_session — retrieve the session attribute from a message. Also, hi bestie, this is a library call manual page, and it’s literally here to explain how to pull the session attribute out of a message. 🫶

---

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
char *tt_message_session(
Tt_message m);

---

🦋 DESCRIPTION 🦋

tt_message_session is the function that retrieves the session attribute from the specified message. No cap, that’s the whole vibe. 💅

The m argument is the opaque handle for the message involved in this operation. Keep it cute, keep it opaque. 🎀

---

🌸 RETURN VALUE 🌸

Upon successful completion, tt_message_session returns the identifier of the session to which this message applies. 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. Slay. 💖
• TT_ERR_NOMP — The ttsession(1) process is not running and the ToolTalk service cannot restart it. 😭
• TT_ERR_POINTER — The pointer passed does not point to an object of the correct type for this operation. 💀

---

🎀 APPLICATION USAGE 🎀

The application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. Don’t forget, bestie — free the data, keep the vibes immaculate. ✨

---

⭐ SEE ALSO ⭐

Go peek at these, iykyk:

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

---

And that’s the whole page, bestie! 💖 Footer sign-off: this one ends with tt_message_session(library call) — that’s the source/version/date line, so we’re officially out. 🫶✨