TT_MESSAGE_FILE_SET(3)

💖 NAME 💖

okay so this is the tt_message_file_set library-call page, bestie, and it's about one job: set the file attribute for a message. That's the whole vibe. 💅

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

tt_message_file_set sets the file attribute for the specified message. periodt.

The m argument is the opaque handle for the message involved in this operation — opaque meaning you hold the handle and pass it along, you don't go poking around inside it, iykyk. 🫶

The file argument is the name of the file involved in this operation.

🔥 RETURN VALUE 🔥

Upon successful completion, tt_message_file_set returns the status of the operation as one of these Tt_status values:

• TT_OK — the operation completed successfully. slay. ✨
• TT_ERR_FILE — the specified file does not exist or it is inaccessible.
• 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.

bestie, those are the exact status values this page lists — no extra ones, no guessing, fr fr. 😭

🌈 SEE ALSO 🌈

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

---

and that's a wrap on the tt_message_file_set(library call) page 🎀 the footer is just that library-call tag — no separate source/version/date line attached — so bye bestie, go set that file attribute responsibly 💖