1TICKIT_TERM_AWAIT_STARTED_MSLEiCb(r3a)ry Functions MTaInCuKaIlT_TERM_AWAIT_STARTED_MSEC(3)
2
3
4
6 tickit_term_await_started_* - wait until the terminal is initialised
7
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
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 milisec‐
26 onds, or -1 to wait indefinitely. tickit_term_await_started_tv() takes
27 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
37 tickit_term_await_started_msec() and tickit_term_await_started_tv()
38 return no value.
39
41 tickit_term_new(3), tickit_term_set_output_func(3),
42 tickit_term_set_output_fd(3), tickit_term(7), tickit(7)
43
44
45
46 TICKIT_TERM_AWAIT_STARTED_MSEC(3)