1TICKIT_TERM_OBSERVE_SIGWINCHL(i3b)rary Functions ManTuIaClKIT_TERM_OBSERVE_SIGWINCH(3)
2
3
4

NAME

6       tickit_term_observe_sigwinch - react to the SIGWINCH signal
7

SYNOPSIS

9       #include <tickit.h>
10
11       void tickit_term_observe_sigwinch(TickitTerm *tt, bool observe);
12
13       Link with -ltickit.
14

DESCRIPTION

16       tickit_term_observe_sigwinch() controls a setting on the TickitTerm in‐
17       stance 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  in‐
26       put-related functions (listed below), this flag will cause the function
27       to first perform the actions of tickit_term_refresh_size(3).  This  de‐
28       ferred handling ensures that the TICKIT_EV_RESIZE event is only invoked
29       at a time when the application is expecting input events, and not asyn‐
30       chronously 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

EVENT-DEFERRAL FUNCTIONS

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

SEE ALSO

47       tickit_term_build(3),                      tickit_term_refresh_size(3),
48       tickit_term_bind_event(3), tickit_term(7), tickit(7)
49
50
51
52                                               TICKIT_TERM_OBSERVE_SIGWINCH(3)
Impressum