trace



trace

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
PORTABILITY
SEE ALSO

NAME

_tracef, _tracedump, _traceattr, _traceattr2, _nc_tracebits, _tracecchar_t, _tracecchar_t2, _tracechar, _tracechtype, _tracechtype2, _tracemouse, tracecurses 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





We can't live, work or learn in freedom unless the software we use is free.