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