1TICKIT_TERM_PAUSE(3)       Library Functions Manual       TICKIT_TERM_PAUSE(3)
2
3
4

NAME

6       tickit_term_pause, tickit_term_resume - pause and resume a terminal in‐
7       stance
8

SYNOPSIS

10       #include <tickit.h>
11
12       void tickit_term_pause(TickitTerm *tt);
13       void tickit_term_resume(TickitTerm *tt);
14
15       void tickit_term_teardown(TickitTerm *tt);
16
17       Link with -ltickit.
18

DESCRIPTION

20       tickit_term_pause() suspends the operation of the terminal by resetting
21       any  modes  or  other  persistent  state on it as if shutting down. Any
22       modes set within the object instance are remembered however.
23
24       tickit_term_resume() returns the terminal back to the state it was  op‐
25       erating  in before tickit_term_pause() was called, allowing the program
26       to continue as normal.
27
28       It is intended these functions be used to create a program-wide suspend
29       feature,  where  the  terminal  can be handed back over to the invoking
30       shell while the process backgrounds itself. Typically this is  done  by
31       the process sending itself a SIGSTOP signal via raise(3). After calling
32       tickit_term_pause(), no  other  terminal-related  functions  should  be
33       called,  nor  other  IO  operations attempted, until after a subsequent
34       tickit_term_resume(3).
35
36       tickit_term_teardown() is similar to tickit_term_stop() except that  it
37       is intended to be used for final shutdown before the application itself
38       terminates. This ensures that the terminal is restored to its  original
39       state,  ahead  of the application outputting any final exit message for
40       the user to read. After this function has returned, no other  functions
41       on the terminal instance may be called.
42

SEE ALSO

44       tickit_term_build(3),     tickit_term_setctl_int(3),    tickit_term(7),
45       tickit(7)
46
47
48
49                                                          TICKIT_TERM_PAUSE(3)
Impressum