FreeBSD Manual Pages
Tcl_DumpActiveMemory(3) Tcl Library Procedures Tcl_DumpActiveMemory(3) ______________________________________________________________________________ NAME Tcl_DumpActiveMemory, Tcl_InitMemory, Tcl_ValidateAllMemory - Validated memory allocation interface SYNOPSIS #include <tcl.h> int Tcl_DumpActiveMemory(fileName) Tcl_InitMemory(interp) Tcl_ValidateAllMemory(fileName, line) ARGUMENTS Tcl_Interp *interp (in) Tcl interpreter in which to add com- mands. const char *fileName (in) For Tcl_DumpActiveMemory, 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 (nor- mally __FILE__). int line (in) Line number at which the call to Tcl_ValidateAllMemory is made (nor- mally __LINE__). ______________________________________________________________________________ DESCRIPTION These functions provide access to Tcl memory debugging information. They are only functional when Tcl has been compiled with TCL_MEM_DEBUG defined at compile-time. When TCL_MEM_DEBUG is not defined, these functions are all no-ops. Tcl_DumpActiveMemory will output a list of all currently allocated mem- ory to the specified file. The information output for each allocated block of memory is: starting and ending addresses (excluding guard zone), size, source file where Tcl_Alloc 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 interpreter given by interp. Tcl_InitMemory is called by Tcl_Main. Tcl_ValidateAllMemory forces a validation of the guard zones of all currently allocated blocks of memory. Normally validation of a block occurs when its freed, unless full validation is enabled, in which case validation of all blocks occurs when Tcl_Alloc and Tcl_Free are called. This function forces the validation to occur at any point. SEE ALSO TCL_MEM_DEBUG, memory KEYWORDS memory, debug Tcl 8.1 Tcl_DumpActiveMemory(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO | KEYWORDS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tcl_InitMemory.tcl90&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>