trusty (3) _nc_free_and_exit.3ncurses.gz

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 configured 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 version 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)