This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

This manual page is associated with the Mac OS X developer tools. The software or headers described may not be present on your Mac OS X installation until you install the developer tools package. This package is available on your Mac OS X installation DVD, and the latest versions can be downloaded from developer.apple.com.

For more information about the manual page format, see the manual page for manpages(5).

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)

       void
       Tcl_InitMemory(interp)

       void
       Tcl_ValidateAllMemory(fileName, line)


ARGUMENTS
       Tcl_Interp   *interp            (in)      Tcl interpreter in which to add commands.

       CONST char   *fileName          (in)      For Tcl_DumpActiveMemory, name of the file to which  memory
                                                 information  will  be  written.  For Tcl_ValidateAllMemory,
                                                 name of the file from which the call is  being  made  (nor-mally (normally
                                                 mally __FILE__).

       int          line               (in)      Line  number  at which the call to Tcl_ValidateAllMemory is
                                                 made (normally __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 memory 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 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 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 ckalloc and ckfree 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)