INtime SDK Help
mpool_dump
INtime SDK v6 > About INtime > Other system libraries > Heaps and memory pools > Memory pools > mpool_dump

Dumps memory pool statistics and lists to the console or a file.

BOOLEAN mpool_dump(
    MPOOL pool, 
    DWORD flags, 
    const char * fname
);

Parameters

pool
The memory pool created by mpool_create.
flags
Valid values include:
MPOOL_DUMP_STATS Dump statistics.
MPOOL_DUMP_BLKHDR Dump block headers.
MPOOL_DUMP_BUFHDR Dump buffer headers.
MPOOL_DUMP_BUFFER Dump buffer contents.
MPOOL_DUMP_ALLOCED Dump the allocated buffer list.
MPOOL_DUMP_FREED Dump the freed buffer list.
fname
The name of file to dump to. If the file cannot be created, output is directed to the console.

Remarks

Use this call only in a low-priority context as it may slow your system. The pool is locked for the duration of the call.

Return Values

TRUE
Success.
FALSE
Failure. The function sets errno to one of these values:
EEXIST The heap is deleted.
EINVAL The heap is not a valid MPOOL or an internal error was detected.

Requirements

Versions Defined in Include Link to
INtime 4.0 intime/rt/include/mpool.h mpool.h clib.lib
   
See Also