TT_MESSAGE_SEND(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💌 NAME 💌

tt_message_send — send a message. that's it. that's the whole job. she sends. 💅

okay so real quick, bestie: this page lives in the library call section of the manual (yes, the same one you keep ending up in at 2am). keep that in mind, it's part of the whole vibe ✨

✨ SYNOPSIS ✨

#include <Tt/tt_c.h>
Tt_status tt_message_send(
Tt_message m);

🦋 DESCRIPTION 🦋

The tt_message_send function sends the specified message. that's the tea. you give her a message, she ships it. iconic behavior honestly 🫶

The m argument is the opaque handle for the message involved in this operation. and yes, opaque means you don't get to peek inside — it's giving mysterious main character energy, don't fight it 🙈

🌸 RETURN VALUE 🌸

okay so upon successful completion (and also upon not-so-successful completion, no judgment), the tt_message_send function returns the status of the operation as one of the following Tt_status values. vibe check time, one bullet each, no skipping 👑

  • TT_OK — slay! the operation completed successfully 💖
  • TT_ERR_ADDRESS — the specified Tt_address is invalid 😭
  • TT_ERR_CLASS — the specified Tt_class is invalid 😭
  • TT_ERR_FILE — the specified file does not exist or it is inaccessible. not found, not vibing, not today 💀
  • TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. the session ghosted you fr fr 🫠
  • TT_ERR_OBJID — the objid passed to the ToolTalk service does not reference an existing object spec 🍓
  • TT_ERR_OTYPE — the specified object type is not the name of an installed object type 🌈
  • TT_ERR_OVERFLOW — the ToolTalk service has more active messages than it can handle. (the maximum number of active messages is implementation specific, but is at least 2000.) bestie is overwhelmed, she's at capacity, please give her a minute 😮‍💨
  • TT_ERR_POINTER — the pointer passed does not point to an object of the correct type for this operation. wrong type, wrong era, wrong everything 💀
  • TT_ERR_PROCID — the specified process identifier is out of date or invalid 🧚
  • TT_ERR_SESSION — the specified ToolTalk session is out of date or invalid 🎀
  • TT_WRN_STALE_OBJID — the object attribute in the message has been replaced with a newer one. it's not an error bestie, it's just a warning — the old one got a glow-up ✨
heads up: a whole bunch of these are straight-up "nope, invalid, try again" energy. don't take it personally, she's just being honest 💜

🔥 SEE ALSO 🔥

kisses, this was tt_message_send straight out of the library call section 🎀✨ periodt 💅

📦 where this page comes from