TTDT_SUBCONTRACT_MANAGE(3)

💅 ttdt_subcontract_manage — manage an outstanding request

okay so real quick: this is a page from the ttdt_subcontract_manage(library call) manual, and yes bestie we're getting into it ✨

---

✨ NAME ✨

ttdt_subcontract_manage — manage an outstanding request 🫶

---

🌸 SYNOPSIS 🌸

#include <Tt/tttk.h>
Tt_pattern *ttdt_subcontract_manage(
Tt_message subcontract,
Ttdt_contract_cb cb,
Widget shell,
void *clientdata);

---

🦋 DESCRIPTION 🦋

so ttdt_subcontract_manage is literally the function that lets a requester manage the standard Desktop interactions with the tool that's handling the request. main character energy fr 💅

what it does is register, in the default session, for TT_HANDLER-addressed requests Get_Geometry and Get_XInfo, plus Status notices. that's the whole vibe check ✨

now here's the tea on shell ☕ — if shell is not NULL, the ToolTalk service handles the Get_Geometry and Get_XInfo notices transparently, no stress, it's handled 🙈. otherwise it passes them to cb. but the Status notice? that one is always passed to the callback, every single time, no exceptions 👑

if you wanna know what a Ttdt_contract_cb callback actually is, go read ttdt_session_join(3) — it's all described over there 📖

🚨 important cleanup lore: if subcontract gets destroyed by tttk_message_destroy, then the patterns get destroyed too — iconic, self-cleaning, we love to see it. but otherwise, the caller is responsible for iterating over the array and destroying each pattern themselves. that's on you, bestie 😭 don't forget or it's giving leak.

---

💖 RETURN VALUE 💖

Upon successful completion, ttdt_subcontract_manage returns a null-terminated array of Tt_pattern, and associates this array with subcontract. slay 🎉

otherwise? it returns an error pointer 💀. the application can use tt_ptr_error(3) to extract one of the following Tt_status values from the returned handle:

• TT_DESKTOP_EINVAL — both the shell and cb arguments were NULL. like, both? yeah that's a no from me 🙈
• TT_ERR_NOMEM — there is insufficient memory available to perform the function. the math isn't mathing, no room 😭
• TT_ERR_NOMP — the ttsession(1) process is not running and the ToolTalk service cannot restart it. it's not giving what it needs to give 💀
• TT_ERR_POINTER — the subcontract argument was not a valid Tt_message. bestie that's not a real message 🚩
• TT_ERR_PROCID — the specified process identifier is out of date or invalid. expired, stale, past its moment ⏰

---

🌈 SEE ALSO 🌈

• Tt/tttk.h - Tttttk(5)
• ttdt_session_join(3)
• tttk_message_destroy(3)

---

okay that's the whole page, you ate that 🍓 and just so you know, this was ttdt_subcontract_manage(library call) — same title on both ends of the page, cute little bookends 🎀 now go forth and manage those outstanding requests, bestie 💜