memleaks(3NCURSES) memleaks(3NCURSES)
NAME
_nc_freeall _nc_free_and_exit - curses memory-leak checking
SYNOPSIS
#include <curses.h>
void _nc_freeall(void);
void _nc_free_and_exit(int);
DESCRIPTION
These functions are used to simplify analysis of memory leaks in the
ncurses library. They are normally not available; they must be config-
ured into the library at build time using the --disable-leaks option.
That compiles-in code that frees memory that normally would not be
freed.
Any implementation of curses must not free the memory associated with a
screen, since (even after calling endwin), it must be available for use
in the next call to refresh. There are also chunks of memory held for
performance reasons. That makes it hard to analyze curses applications
for memory leaks. To work around this, one can build a debugging ver-
sion of the ncurses library which frees those chunks which it can, and
provides these functions to free all of the memory allocated by the
ncurses library.
The _nc_free_and_exit function is the preferred one since some of the
memory which is freed may be required for the application to continue
running. Its parameter is the code to pass to the exit routine.
RETURN VALUE
These functions do not return a value.
PORTABILITY
These functions are not part of the XSI interface.
SEE ALSO
ncurses(3NCURSES).
memleaks(3NCURSES)