1TICKIT_TERM_AWAIT_STARTED_MSLEiCb(r3a)ry Functions MTaInCuKaIlT_TERM_AWAIT_STARTED_MSEC(3)
2
3
4

NAME

6       tickit_term_await_started_* - wait until the terminal is initialised
7

SYNOPSIS

9       #include <tickit.h>
10
11       void tickit_term_await_started_msec(TickitTerm *tt, longmsec);
12       void tickit_term_await_started_tv(TickitTerm *tt, const struct timeval *timeout);
13
14       Link with -ltickit.
15

DESCRIPTION

17       The  tickit_term_await_started_*()  family  of functions wait until the
18       terminal driver announces it has completed setting up the terminal, and
19       it is ready to be used. The timeout specifies the maximum time to wait;
20       the function will return after this time even if the  terminal  is  not
21       ready  yet.  One of these functions should be called after the relevant
22       input and output methods have been set on the terminal instance.
23
24       The   functions   differ   in   how   the   timeout    is    specified.
25       tickit_term_await_started_msec()  takes  a  time  as an integer in mil‐
26       liseconds, or -1 to wait  indefinitely.  tickit_term_await_started_tv()
27       takes a time as a struct timeval, or NULL to wait indefinitely.
28
29       Under most terminal drivers it is not strictly required that it be com‐
30       pletely prepared before it is used, as preparation consists  mainly  of
31       detecting  optionally-supported  features the terminal may have. If the
32       application starts outputting before this is finished,  it  simply  may
33       not  make  use of some features, or not detect or report that some fea‐
34       tures are present.
35

RETURN VALUE

37       tickit_term_await_started_msec() and tickit_term_await_started_tv() re‐
38       turn no value.
39

SEE ALSO

41       tickit_term_build(3), tickit_term(7), tickit(7)
42
43
44
45                                             TICKIT_TERM_AWAIT_STARTED_MSEC(3)
Impressum