TT_OPEN(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💅 tt_open — bestie, let's get you an ID

okay so real talk, the manual page calls this tt_open(library call) and honestly? that's the whole vibe: this is the library call version of tt_open 💖

✨ NAME ✨

tt_open — returns the process identifier for the calling process, like a little name tag for your process at the ToolTalk party 🎀

🌸 SYNOPSIS 🌸

#include <Tt/tt_c.h>
char *tt_open(void)

🦋 DESCRIPTION 🦋

The tt_open function returns the process identifier for the calling process. That's it, that's the whole function, and she ate 💅

👑 RETURN VALUE 👑

okay so tt_open also sets this identifier as the default procid for the process. Fancy, right? And tt_open(3) is typically the very first ToolTalk function a process calls — she's the main character, the opener of doors 🚪✨

Your application must call tt_open(3) before making other tt_ calls. Periodt. But there are exactly two exceptions, and yes we're listing them because they're iconic:

Those two can be called before tt_open. Everybody else? Wait your turn 🙈

A process can call tt_open more than once to obtain multiple procids — no cap, collect them like stickers 💖 To open another session, the process must make the following calls in the order specified:

tt_default_session_set
tt_open

order matters, bestie, don't freestyle it 🫶

⭐ RETURN VALUE ⭐ (yes, again, she has two — queen behavior)

Upon successful completion, the tt_open function returns the character value that uniquely identifies the process. You can use tt_ptr_error(3) to extract one of the following Tt_status values from that returned pointer:

  • TT_OK — The operation completed successfully. slay ✨
  • TT_ERR_NOMP — The ttsession(1) process is not running and the ToolTalk service cannot restart it. 😭 yeah that's a yikes

🌈 APPLICATION USAGE 🌈

Your app should use tt_free(3) to free any data stored in the address returned by the ToolTalk API. Clean up after yourself, it's giving self-care 🧚

Each procid has its own associated file descriptor, and can join another session. And if you want to switch to another procid? Call tt_default_procid_set. Easy. Done. Iconic 👑

🔥 SEE ALSO 🔥

ngl go read those too, iykyk 💜

and that's the page, bestie 🎀 big kisses from the tt_open(library call) corner — both the header up top and the footer down here just say tt_open(library call), so consider this your cute sign-off: library call energy, tt_open, periodt 💅🌸🦋

📦 where this page comes from