_tracef man page on MirBSD

Man page or keyword search:  
man Server   6113 pages
apropos Keyword Search (all sections)
Output format
MirBSD logo
[printable version]



curs_trace(3)	    UNIX Programmer's Manual	    curs_trace(3)

NAME
     _tracef, _tracedump, _traceattr, _traceattr2, _nc_tracebits,
     _tracechar, _tracechtype, _tracechtype2, _tracemouse, trace
     - curses debugging routines

SYNOPSIS
     #include <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 *_tracechar(const unsigned char 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  li-
     braries,  as  well as applications which use the ncurses li-
     braries. 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.

     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  defini-
     tions 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.

MirOS BSD #10-current	Printed 18.8.2011			1

curs_trace(3)	    UNIX Programmer's Manual	    curs_trace(3)

     TRACE_CHARPUT
	  trace all character outputs.

     TRACE_ORDINARY
	  trace all update actions. The old and new  screen  con-
	  tents 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 parame-
     ter  is  nonzero.	Some features overlap. The specific names
     are used as a guideline.

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 oth-
     er curses implementations are known to have similar, undocu-
     mented features, but they are not compatible with ncurses.

SEE ALSO
     curses(3).

MirOS BSD #10-current	Printed 18.8.2011			2

[top]

List of man pages available for MirBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net