trace
NAMESYNOPSIS
DESCRIPTION
RETURN VALUE
PORTABILITY
SEE ALSO
NAME
_tracef, _tracedump, _traceattr, _traceattr2, _nc_tracebits, _tracecchar_t, _tracecchar_t2, _tracechar, _tracechtype, _tracechtype2, _tracemouse, trace − curses debugging routines
SYNOPSIS
#include <ncurses/curses.h>
void
_tracef(const char *format, ...);
void _tracedump(const char *label, WINDOW *win);
char *_traceattr(attr_t attr);
char *_traceattr2(int buffer, chtype ch);
char *_nc_tracebits(void);
char * _tracecchar_t(const cchar_t *string);
char * _tracecchar_t2(int buffer, const cchar_t *string);
char *_tracechar(int ch);
char *_tracechtype(chtype ch);
char *_tracechtype2(int buffer, chtype ch);
char *_tracemouse(const MEVENT *event);
void trace(const unsigned int param);
DESCRIPTION
The trace routines are used for debugging the ncurses libraries, as well as applications which use the ncurses libraries. These functions are normally available only with the debugging library libncurses_g.a, but may be compiled into any model (shared, static, profile) by defining the symbol TRACE. Additionally, some functions are only available with the wide-character configuration of the libraries.
The principal parts of this interface are the trace routine which selectively enables different tracing features, and the _tracef routine which writes formatted data to the trace file.
Calling
trace with a nonzero parameter opens the file
trace in the current directory for output. The
parameter is formed by OR’ing values from the list of
TRACE_xxx definitions in
<curses.h>. These include:
TRACE_DISABLE
turn off tracing.
TRACE_TIMES
trace user and system times of updates.
TRACE_TPUTS
trace tputs calls.
TRACE_UPDATE
trace update actions, old & new screens.
TRACE_MOVE
trace cursor movement and scrolling.
TRACE_CHARPUT
trace all character outputs.
TRACE_ORDINARY
trace all update actions. The old and new screen contents are written to the trace file for each refresh.
TRACE_CALLS
trace all curses calls. The parameters for each call are traced, as well as return values.
TRACE_VIRTPUT
trace virtual character puts, i.e., calls to addch.
TRACE_IEVENT
trace low-level input processing, including timeouts.
TRACE_BITS
trace state of TTY control bits.
TRACE_ICALLS
trace internal/nested calls.
TRACE_CCALLS
trace per-character calls.
TRACE_DATABASE
trace read/write of terminfo/termcap data.
TRACE_ATTRS
trace changes to video attributes and colors.
TRACE_MAXIMUM
maximum trace level, enables all of the separate trace features.
Some tracing features are enabled whenever the trace parameter is nonzero. Some features overlap. The specific names are used as a guideline.
These functions check the NCURSES_TRACE environment variable, to set the tracing feature as if trace was called:
filter, initscr, new_prescr, newterm, nofilter, ripoffline, setupterm, slk_init, tgetent
RETURN VALUE
Routines which return a value are designed to be used as parameters to the _tracef routine.
PORTABILITY
These functions are not part of the XSI interface. Some other curses implementations are known to have similar, undocumented features, but they are not compatible with ncurses.
SEE ALSO
ncurses(3NCURSES).
More Linux Commands
manpages/use_tioctl.3x.lc.html
use_tioctl.3x(lc) miscellaneous curses utility routines.....
The unctrl routine returns a character string which is a printable representation of the character c, ignoring attributes. Control characters are displayed in t
manpages/mrtg-nw-guide.1.html
mrtg-nw-guide(1) MRTG for NetWare - Linux manual page.......
MRTG is a relative newcomer to the NetWare platform. Earlier versions of NetWare could not run MRTG natively for several reasons: * Absence of NetWare OS suppor
manpages/glBlendColor.3gl.html
glBlendColor(3gl) - set the blend color - Linux manual page
The GL_BLEND_COLOR may be used to calculate the source and destination blending factors. The color components are clamped to the range [0, 1] before being store
manpages/sfconvert.1.html
sfconvert(1) - convert audio files - Linux manual page......
The sfconvert command converts an audio file to another file format or data format. OPTIONS The following keywords specify the format of the output sound file:
manpages/linphonecsh.1.html
linphonecsh(1) - Sends a command to a linphonec running in d
Linphonecsh is a small utility to send basic commands to a linphonec (console mode linphone) process. Unlike linphonec, linphonecsh does not wait commands from
manpages/dhcp-options.5.html
dhcp-options(5) - Dynamic Host Configuration Protocol option
The Dynamic Host Configuration protocol allows the client to receive options from the DHCP server describing the network configuration and various services that
manpages/etags.1.html
etags(1) - generate tag file for Emacs, vi - Linux man page
The etags program is used to create a tag table file, in a format understood by emacs(1); the gnuctags program is used to create a similar table in a format und
manpages/dmraid.8.html
dmraid(8) - discover, configure and activate software (ATA)R
dmraid discovers block and software RAID devices (eg, ATARAID) by using multiple different metadata format handlers which support various formats (eg, Highpoint
manpages/pammixinterlace.1.html
pammixinterlace(1) - mix adjacent lines to merge interlaced
This program is part of Netpbm(1) pammixinterlace is meant to operate on an image which is the interlacing of two images, where raster rows 0, 2, 4, etc. are fr
manpages/svc_getargs.3.html
svc_getargs(3) - library routines for remote procedure calls
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s
manpages/Tie::File.3pm.html
Tie::File(3pm) - Access the lines of a disk file via a Perl
Tie::File represents a regular text file as a Perl array. Each element in the array corresponds to a record in the file. The first line of the file is element 0
manpages/des_setparity.3.html
des_setparity(3) - fast DES encryption - Linux manual page
ecb_crypt() and cbc_crypt() implement the NBS DES (Data Encryption Standard). These routines are faster and more general purpose than crypt(3). They also are ab
