TT_MESSAGE_HANDLER_SET(3)

🌸 NAME 🌸

okay so bestie, this is tt_message_handler_set — a library call, periodt — and it’s literally here to set the handler attribute for a message. that’s the whole assignment. 💅

---

✨ SYNOPSIS ✨

       #include &<Tt/tt_c.h>
       Tt_status tt_message_handler_set(
       Tt_message m,
       const char *procid);

🦋 DESCRIPTION 🦋

the tt_message_handler_set function sets the handler attribute for the specified message. slay.

the m argument is the opaque handle for the message involved in this operation. no cap, it’s opaque — don’t go peeking inside. the procid argument is the character value that uniquely identifies the process that is to handle the message. that’s the process getting the handler job, periodt.

👑 RETURN VALUE 👑

upon successful completion, the tt_message_handler_set function returns the status of the operation as one of these Tt_status values:

• TT_OK — the operation completed successfully. 🎀
• 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. 💀

🌈 SEE ALSO 🌈

• Tt/tt_c.h - Tttt_c(5).

---

mwah 🫶 — footer tea: this is the library-call page for tt_message_handler_set, and ngl the original footer doesn’t print a separate version or date, so that’s all she wrote. byeee ✨