NAME

       tickit_term_pause, tickit_term_resume - pause and resume a terminal instance

SYNOPSIS

       #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).

SEE ALSO

       tickit_term_new(3), tickit_term_setctl_int(3), tickit_term(7), tickit(7)

                                                                                            TICKIT_TERM_PAUSE(3)