TICKIT_TERM_PAUSE(3)

💅 TICKIT_TERM_PAUSE — ok bestie, let's talk terminals

So this one is tickit_term_pause(3) from the library functions manual, and it's all about giving your terminal a lil nap and then waking it back up. No cap. 🦋

✨ NAME ✨

tickit_term_pause</p>, tickit_term_resume</p> — pause and resume a terminal instance

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_term_pause(TickitTerm *tt);
void tickit_term_resume(TickitTerm *tt);

void tickit_term_teardown(TickitTerm *tt);

Link with -ltickit.

💖 DESCRIPTION 💖

tickit_term_pause() — the "brb going afk" era 😴

tickit_term_pause() suspends the operation of the terminal by resetting any modes or other persistent state on it, literally as if it were shutting down. It's giving full power-down energy.

But — and this is the important part, bestie — any modes set within the object instance are remembered. So it's not forgetting your settings, it's just putting them in the lil pocket. 🫶

tickit_term_resume() — welcome back queen 👑

tickit_term_resume() returns the terminal back to the state it was operating in before tickit_term_pause() was called, which lets your program continue as normal. Like nothing ever happened. Iconic.

The whole point of this, fr fr 🎀

These functions are intended to be used to create a program-wide suspend feature, where the terminal can be handed back over to the invoking shell while the process backgrounds itself.

Typically this is done by the process sending itself a SIGSTOP signal via raise(3). Very demure, very mindful.

⚠️ okay listen — after calling tickit_term_pause(), no other terminal-related functions should be called, nor should any other IO operations be attempted, until after a subsequent tickit_term_resume(3). Like, none. Zero. Zip. Don't do it. 💀

tickit_term_teardown() — the final goodbye 🥺

tickit_term_teardown() is similar to tickit_term_stop() except that it's intended to be used for final shutdown before the application itself terminates.

This ensures the terminal is restored to its original state, ahead of the application outputting any final exit message for the user to read. So the user actually gets to see your farewell message on a clean screen instead of it being eaten by leftover terminal modes. Main character exit energy. ✨

🛑 After this function has returned, no other functions on the terminal instance may be called. That's it. That's the end. Periodt.

🌈 SEE ALSO 🌈

• tickit_term_build(3)
• tickit_term_setctl_int(3)
• tickit_term(7)
• tickit(7)

And that's the whole vibe, bestie — this page came straight out of the Library Functions Manual, filed under TICKIT_TERM_PAUSE(3) 💜 stay cozy, pause responsibly, and never call a terminal function after teardown, mwah 💋