1TICKIT_TERM_PAUSE(3) Library Functions Manual TICKIT_TERM_PAUSE(3)
2
3
4
6 tickit_term_pause, tickit_term_resume - pause and resume a terminal
7 instance
8
10 #include <tickit.h>
11
12 void tickit_term_pause(TickitTerm *tt);
13 void tickit_term_resume(TickitTerm *tt);
14
15 Link with -ltickit.
16
18 tickit_term_pause() suspends the operation of the terminal by resetting
19 any modes or other persistent state on it as if shutting down. Any
20 modes set within the object instance are remembered however.
21
22 tickit_term_resume() returns the terminal back to the state it was
23 operating in before tickit_term_pause() was called, allowing the pro‐
24 gram to continue as normal.
25
26 It is intended these functions be used to create a program-wide suspend
27 feature, where the terminal can be handed back over to the invoking
28 shell while the process backgrounds itself. Typically this is done by
29 the process sending itself a SIGSTOP signal via raise(3). After calling
30 tickit_term_pause(), no other terminal-related functions should be
31 called, nor other IO operations attempted, until after a subsequent
32 tickit_term_resume(3).
33
35 tickit_term_new(3), tickit_term_setctl_int(3), tickit_term(7),
36 tickit(7)
37
38
39
40 TICKIT_TERM_PAUSE(3)