TT_PREQUEST_CREATE(3)

okay so bestie, welcome to the tt_prequest_create(library call) page — yes, the library call one — and it's literally about creating a procedure request message 💅✨

🌸 NAME 🌸

tt_prequest_create — create a procedure request message. that's the whole name section, short and iconic 🎀

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_message tt_prequest_create(
Tt_scope scope,
const char *op);

💖 DESCRIPTION 💖

the tt_prequest_create function creates a message. the message it creates contains this exact duo, no cap:

Tt_address = TT_PROCEDURE Tt_class = TT_REQUEST

you can use the returned handle to add arguments and other attributes, and to send the message. main character handle energy fr fr 🫶

the scope argument determines which processes are eligible to receive the message. here are the defined values, bestie:

• TT_SESSION — all processes joined to the indicated session are eligible.
• TT_FILE — all processes joined to the indicated file are eligible.
• TT_BOTH — all processes joined to either the indicated file or the indicated session are eligible.
• TT_FILE_IN_SESSION — all processes joined to both the indicated file and the indicated session are eligible.

the op argument is the operation to be performed by the receiving process. that's it, that's the op 💅

🔥 RETURN VALUE 🔥

upon successful completion, tt_prequest_create returns the unique handle that identifies this message. use tt_ptr_error(3) to extract one of these Tt_status values from the returned handle:

• 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 specified process identifier is out of date or invalid.

🦋 APPLICATION USAGE 🦋

the application should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. yes, free it, bestie, that's the assignment 🎀

okay important caveat: if the ToolTalk service is unable to create a message when requested, tt_prequest_create returns an invalid handle. when the application attempts to use this handle with another ToolTalk function, the ToolTalk service will return TT_ERR_POINTER. not the vibe — handle with care 💀

🌈 SEE ALSO 🌈

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

---

signing off from the footer, which gives us the tt_prequest_create library call source/version label and no date — so we're keeping it timeless and undated, periodt 💖✨