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)