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

  
 
  

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

NAME
     tickit_term_await_started_* - wait until the terminal is initialised

SYNOPSIS
     #include <tickit.h>

     void tickit_term_await_started_msec(TickitTerm *tt, longmsec);
     void tickit_term_await_started_tv(TickitTerm *tt, const struct timeval *timeout);

     Link with -ltickit.

DESCRIPTION
     The tickit_term_await_started_*() family of functions wait until the termi-
     nal  driver  announces  it has completed setting up the terminal, and it is
     ready to be used. The timeout specifies the maximum time to wait; the func-
     tion will return after this time even if the terminal is not ready yet. One
     of these functions should be called after the  relevant  input  and  output
     methods have been set on the terminal instance.

     The    functions	 differ    in	 how	the    timeout	 is   specified.
     tickit_term_await_started_msec() takes a time as an  integer  in  millisec-
     onds,  or	-1  to wait indefinitely. tickit_term_await_started_tv() takes a
     time as a struct timeval, or NULL to wait indefinitely.

     Under most terminal drivers it is not strictly required  that  it	be  com-
     pletely  prepared	before it is used, as preparation consists mainly of de-
     tecting optionally-supported features the terminal may have. If the  appli-
     cation  starts  outputting  before this is finished, it simply may not make
     use of some features, or not  detect  or  report  that  some  features  are
     present.

RETURN VALUE
     tickit_term_await_started_msec()  and tickit_term_await_started_tv() return
     no value.

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

						      TICKIT_TER...ARTED_MSEC(3)

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

home | help