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
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

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_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)
Impressum