table of contents
TICKIT_TERM_PAUSE(3) | Library Functions Manual | TICKIT_TERM_PAUSE(3) |
NAME¶
tickit_term_pause, tickit_term_resume - pause and resume a terminal instanceSYNOPSIS¶
#include <tickit.h> void tickit_term_pause(TickitTerm *tt); void tickit_term_resume(TickitTerm *tt);
Link with -ltickit.
DESCRIPTION¶
tickit_term_pause() suspends the operation of the terminal by resetting any modes or other persistent state on it as if shutting down. Any modes set within the object instance are remembered however.tickit_term_resume() returns the terminal back to the state it was operating in before tickit_term_pause() was called, allowing the program to continue as normal.
It is intended these functions 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). After calling tickit_term_pause(), no other terminal-related functions should be called, nor other IO operations attempted, until after a subsequent tickit_term_resume(3).