Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TICKIT_TER...E_SIGWINCH(3) Library Functions Manual TICKIT_TER...E_SIGWINCH(3)

NAME
       tickit_term_observe_sigwinch - react to the SIGWINCH signal

SYNOPSIS
       #include	<tickit.h>

       void tickit_term_observe_sigwinch(TickitTerm *tt, bool observe);

       Link with -ltickit.

DESCRIPTION
       tickit_term_observe_sigwinch() controls a setting on the	TickitTerm in-
       stance  that  allows it to be informed when the process receives	a SIG-
       WINCH signal, meaning that the controlling terminal  may	 have  changed
       size.

       When  this flag is enabled on at	least one terminal instance, a handler
       for the SIGWINCH	signal is automatically	installed by libtickit itself.
       On receipt of the signal	the handler will mark a	flag on	any TickitTerm
       instance	that is	observing it to	indicate  that	the  window  may  have
       changed	size.  The next	time these instances invoke any	of several in-
       put-related functions (listed below), this flag will cause the function
       to first	perform	the actions of tickit_term_refresh_size(3).  This  de-
       ferred handling ensures that the	TICKIT_EV_RESIZE event is only invoked
       at a time when the application is expecting input events, and not asyn-
       chronously during the signal handler itself.

       Note  that  use of this ability requires	giving control of the process-
       wide SIGWINCH signal to the libtickit library. If this is not suitable,
       the process should arrange to invoke tickit_term_refresh_size()	at  an
       appropriate time	by some	other mechanism.

EVENT-DEFERRAL FUNCTIONS
       *      tickit_term_input_push_bytes(3)

       *      tickit_term_input_readable(3)

       *      The tickit_term_input_check_timeout_msec(3) family

       *      The tickit_term_input_wait_msec(3) family

SEE ALSO
       tickit_term_build(3),			  tickit_term_refresh_size(3),
       tickit_term_bind_event(3), tickit_term(7), tickit(7)

						    TICKIT_TER...E_SIGWINCH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tickit_term_observe_sigwinch&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help