1TICKIT_TERM_OBSERVE_SIGWINCHL(i3b)rary Functions ManTuIaClKIT_TERM_OBSERVE_SIGWINCH(3)
2
3
4
6 tickit_term_observe_sigwinch - react to the SIGWINCH signal
7
9 #include <tickit.h>
10
11 void tickit_term_observe_sigwinch(TickitTerm *tt, bool observe);
12
13 Link with -ltickit.
14
16 tickit_term_observe_sigwinch() controls a setting on the TickitTerm
17 instance that allows it to be informed when the process receives a SIG‐
18 WINCH signal, meaning that the controlling terminal may have changed
19 size.
20
21 When this flag is enabled on at least one terminal instance, a handler
22 for the SIGWINCH signal is automatically installed by libtickit itself.
23 On receipt of the signal the handler will mark a flag on any TickitTerm
24 instance that is observing it to indicate that the window may have
25 changed size. The next time these instances invoke any of several
26 input-related functions (listed below), this flag will cause the func‐
27 tion to first perform the actions of tickit_term_refresh_size(3). This
28 deferred handling ensures that the TICKIT_EV_RESIZE event is only
29 invoked at a time when the application is expecting input events, and
30 not asynchronously during the signal handler itself.
31
32 Note that use of this ability requires giving control of the process-
33 wide SIGWINCH signal to the libtickit library. If this is not suitable,
34 the process should arrange to invoke tickit_term_refresh_size() at an
35 appropriate time by some other mechanism.
36
38 * tickit_term_input_push_bytes(3)
39
40 * tickit_term_input_readable(3)
41
42 * The tickit_term_input_check_timeout_msec(3) family
43
44 * The tickit_term_input_wait_msec(3) family
45
47 tickit_term_new(3), tickit_term_set_input_fd(3),
48 tickit_term_refresh_size(3), tickit_term_bind_event(3), tickit_term(7),
49 tickit(7)
50
51
52
53 TICKIT_TERM_OBSERVE_SIGWINCH(3)