4 <!-- Manpage converted by man2html 3.0.1 -->
8 <B>_tracef</B>, <B>_tracedump</B>, <B>_traceattr</B>, <B>_traceattr2</B>,
9 <B>_nc_tracebits</B>, <B>_tracechar</B>, <B>_tracechtype</B>, <B>_tracechtype2</B>,
10 <B>_tracemouse</B>, <B>trace</B> - <B>curses</B> debugging routines
14 <H2>SYNOPSIS</H2><PRE>
15 <B>#include</B> <B><curses.h></B>
16 <B>void</B> <B>_tracef(const</B> <B>char</B> <B>*format,</B> <B>...);</B>
17 <B>void</B> <B>_tracedump(const</B> <B>char</B> <B>*label,</B> <B>WINDOW</B> <B>*win);</B>
18 <B>char</B> <B>*_traceattr(attr_t</B> <B>attr);</B>
19 <B>char</B> <B>*_traceattr2(int</B> <B>buffer,</B> <B>chtype</B> <B>ch);</B>
20 <B>char</B> <B>*_nc_tracebits(void);</B>
21 <B>char</B> <B>*_tracechar(const</B> <B>unsigned</B> <B>char</B> <B>ch);</B>
22 <B>char</B> <B>*_tracechtype(chtype</B> <B>ch);</B>
23 <B>char</B> <B>*_tracechtype2(int</B> <B>buffer,</B> <B>chtype</B> <B>ch);</B>
24 <B>char</B> <B>*_tracemouse(const</B> <B>MEVENT</B> <B>*event);</B>
25 <B>void</B> <B>trace(const</B> <B>unsigned</B> <B>int</B> <B>param);</B>
29 <H2>DESCRIPTION</H2><PRE>
30 The <B>trace</B> routines are used for debugging the ncurses
31 libraries, as well as applications which use the ncurses
32 libraries. These functions are normally available only
33 with the debugging library <I>libncurses</I><B>_</B><I>g.a</I>, but may be com-
34 piled into any model (shared, static, profile) by defining
35 the symbol <B>TRACE</B>.
37 The principal parts of this interface are the <B>trace</B> rou-
38 tine which selectively enables different tracing features,
39 and the <B>_tracef</B> routine which writes formatted data to the
42 Calling <B>trace</B> with a nonzero parameter opens the file
43 <B>trace</B> in the current directory for output. The parameter
44 is formed by OR'ing values from the list of <B>TRACE_</B><I>xxx</I> def-
45 initions in <B><curses.h></B>. These include:
51 trace user and system times of updates.
57 trace update actions, old & new screens.
60 trace cursor movement and scrolling.
63 trace all character outputs.
66 trace all update actions. The old and new screen
67 contents are written to the trace file for each
71 trace all curses calls. The parameters for each call
72 are traced, as well as return values.
75 trace virtual character puts, i.e., calls to <B>addch</B>.
78 trace low-level input processing, including timeouts.
81 trace state of TTY control bits.
84 trace internal/nested calls.
87 trace per-character calls.
90 trace read/write of terminfo/termcap data.
93 trace changes to video attributes and colors.
96 maximum trace level, enables all of the separate
99 Some tracing features are enabled whenever the <B>trace</B>
100 parameter is nonzero. Some features overlap. The
101 specific names are used as a guideline.
105 <H2>RETURN VALUE</H2><PRE>
106 Routines which return a value are designed to be used as
107 parameters to the <B>_tracef</B> routine.
111 <H2>PORTABILITY</H2><PRE>
112 These functions are not part of the XSI interface. Some
113 other curses implementations are known to have similar,
114 undocumented features, but they are not compatible with
119 <H2>SEE ALSO</H2><PRE>
120 <B><A HREF="ncurses.3x.html">curses(3x)</A></B>.
128 Man(1) output converted with
129 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>