TT_SESSION_BPROP_SET(3)

🌸 NAME 🌸

okay bestie, this is tt_session_bprop_set from the library call manual — the function that replaces whatever values are currently stored under the named property of a session. It’s giving “out with the old byte-string, in with the new” energy. 💖

---

✨ SYNOPSIS ✨

#include &<Tt/tt_c.h>
Tt_status tt_session_bprop_set(
const char *sessid,
const char *propname,
const unsigned char *value,
int length);

---

🦋 DESCRIPTION 🦋

So tt_session_bprop_set does one very specific thing: it replaces any current values stored under the named property of the specified session with the given byte-string value. no cap. 🫶

• sessid — the name of the session joined. The application can use the sessid value returned when tt_default_session is called.
• propname — the name of the property whose value is to be replaced.
• value — the value to which the session property is set. If value is NULL, the property is removed entirely. 💀
• length — the size of the value in bytes.

bestie warning: if value is NULL, this is not a “set it to empty” situation — the property is removed entirely. periodt.

---

👑 RETURN VALUE 👑

Upon successful completion, tt_session_bprop_set returns the status of the operation as one of the following Tt_status values:

• 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_PROPLEN — The specified property value is too long. (The maximum size is implementation specific, but is at least 2048.) 😭
• TT_ERR_PROPNAME — The specified property name is syntactically invalid.
• TT_ERR_SESSION — The specified ToolTalk session is out of date or invalid.

---

🌈 SEE ALSO 🌈

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

---

okay that’s the whole page, bestie! footer sign-off: this is tt_session_bprop_set(library call) — and the footer just repeats that page name, with no separate source/version/date line to spill. byeee, go replace those byte-strings responsibly 💅✨🍓