NAME
Tcl_DumpActiveMemory, Tcl_InitMemory, Tcl_ValidateAllMem
ory - Validated memory allocation interface.
SYNOPSIS
#include <tcl.h>
int
Tcl_DumpActiveMemory(fileName)
void
Tcl_InitMemory(interp)
void
Tcl_ValidateAllMemory(fileName, line)
ARGUMENTS
Tcl_Interp *interp (in) Tcl interpreter
in which to add
commands.
char *fileName (in) For
Tcl_DumpActive
Memory, name of
the file to
which memory
information will
be written. For
Tcl_Vali
dateAllMemory,
name of the file
from which the
call is being
made (normally
__FILE__).
int line (in) Line number at
which the call
to Tcl_Vali
dateAllMemory is
made (normally
__LINE__).
_________________________________________________________________
DESCRIPTION
These functions provide access to Tcl memory debugging
information. They are only available when Tcl has been
compiled with TCL_MEM_DEBUG defined at compile-time.
Tcl_DumpActiveMemory will output a list of all currently
output for each allocated block of memory is: starting
and ending addresses (excluding guard zone), size, source
file where ckalloc was called to allocate the block and
line number in that file. It is especially useful to call
Tcl_DumpActiveMemory after the Tcl interpreter has been
deleted.
Tcl_InitMemory adds the Tcl memory command to the inter
preter given by interp. It is called by Tcl_Main when Tcl
has been compiled with TCL_MEM_DEBUG defined.
Tcl_ValidateAllMemory forces a validation of the guard
zones of all currently allocated blocks of memory. Nor
mally validation of a block occurs when its freed, unless
full validation is enabled, in which case validation of
all blocks occurs when ckalloc and ckfree are called.
This function forces the validation to occur at any point.
SEE ALSO
TCL_MEM_DEBUG, memory
KEYWORDS
memory, debug
Man(1) output converted with
man2html