curs_memleaks 3x

curs_memleaks(3x)                                     curs_memleaks(3x)




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 com-
       piles-in code that frees memory that normally would not be
       freed.

       Any  implementation of curses must not free the memory as-
       sociated with a screen, since (even after calling endwin),
       it  must  be  available  for  use  in the next call to re-
       fresh(3x).  There are also chunks of memory held for  per-
       formance  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  func-
       tions  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

       curses(3x).



                                                      curs_memleaks(3x)