X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_memleaks.3x.html;h=4c1876f700bd09d491e71339d26273a6588e7894;hb=67327e4e3b2121f8273fb73ec14ef234ed01231e;hp=543d40a735fa0d461fa5de78757e71dc2889fa1e;hpb=74433bcf4f6fe40862a28f3c00edaedcd5054b01;p=ncurses.git diff --git a/doc/html/man/curs_memleaks.3x.html b/doc/html/man/curs_memleaks.3x.html index 543d40a7..4c1876f7 100644 --- a/doc/html/man/curs_memleaks.3x.html +++ b/doc/html/man/curs_memleaks.3x.html @@ -1,6 +1,6 @@ -curs_memleaks 3x +curs_memleaks 3x 2023-12-23 ncurses 6.4 Library calls -

curs_memleaks 3x

+

curs_memleaks 3x 2023-12-23 ncurses 6.4 Library calls

-curs_memleaks(3x)                                            curs_memleaks(3x)
+curs_memleaks(3x)                Library calls               curs_memleaks(3x)

NAME

-       exit_curses, exit_terminfo - curses memory-leak checking
+       exit_curses, exit_terminfo - check for memory leaks in curses

SYNOPSIS

@@ -57,7 +57,7 @@
        #include <term.h>
        void exit_terminfo(int code);
 
-       /* deprecated (intentionally not declared in curses.h or term.h) */
+       /* deprecated (intentionally not declared in curses.h or term.h) */
        void _nc_freeall(void);
        void _nc_free_and_exit(int code);
        void _nc_free_tinfo(int code);
@@ -65,28 +65,28 @@

DESCRIPTION

        These  functions  are  used to simplify analysis of memory leaks in the
-       ncurses library.
+       ncurses library.
 
        Any implementation of curses must not free the memory associated with a
        screen, since (even after calling endwin(3x)), it must be available for
        use in the next call to refresh(3x).  There are also chunks  of  memory
-       held for performance reasons.  That makes it hard to analyze curses ap-
-       plications for memory leaks.  When using the specially  configured  de-
-       bugging version of the ncurses library, applications can call functions
-       which free those chunks of memory, simplifying the process  of  memory-
-       leak checking.
+       held  for  performance  reasons.   That makes it hard to analyze curses
+       applications for memory leaks.  When  using  the  specially  configured
+       debugging  version  of  the  ncurses  library,  applications  can  call
+       functions which free those chunks of memory, simplifying the process of
+       memory-leak checking.
 
        Some  of  the functions are named with a "_nc_" prefix because they are
        not intended for use in the non-debugging library:
 
        _nc_freeall
-            This frees (almost) all of the memory allocated by ncurses.
+            This frees (almost) all of the memory allocated by ncurses.
 
        _nc_free_and_exit
-            This frees the memory allocated by ncurses (like _nc_freeall), and
+            This frees the memory allocated by ncurses (like _nc_freeall), and
             exits the program.  It is preferred over _nc_freeall since some of
-            that memory may be required to keep the application running.  Sim-
-            ply exiting (with the given exit-code) is safer.
+            that memory may be  required  to  keep  the  application  running.
+            Simply exiting (with the given exit-code) is safer.
 
        _nc_free_tinfo
             Use  this  function  if only the low-level terminfo functions (and
@@ -94,9 +94,9 @@
             the program after freeing memory.
 
        The  functions  prefixed "_nc" are normally not available; they must be
-       configured into the library at build time using the --disable-leaks op-
-       tion.   That compiles-in code that frees memory that normally would not
-       be freed.
+       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.
 
        The exit_curses and exit_terminfo functions call _nc_free_and_exit  and
        _nc_free_tinfo  if  the  library  is  configured to support memory-leak
@@ -109,16 +109,30 @@

PORTABILITY

-       These functions are not part of X/Open Curses; nor do other implementa-
-       tions of curses provide a similar feature.
+       These   functions   are  not  part  of  X/Open  Curses;  nor  do  other
+       implementations of curses provide a similar feature.
+
+       In any implementation of X/Open Curses, an application can free part of
+       the memory allocated by curses:
+
+       o   The  portable  part  of  exit_curses  can be freed using delscreen,
+           passing the SCREEN pointer returned by newterm.
+
+           In some implementations, there is a global variable sp which  could
+           be used, e.g., if the screen were only initialized using initscr.
+
+       o   The portable part of exit_terminfo can be freed using del_curterm.
+
+           In this case, there is a global variable cur_term which can be used
+           as parameter.

SEE ALSO

-       curses(3x).
+       curses(3x), curs_initscr(3x), curs_terminfo(3x)
 
 
 
-                                                             curs_memleaks(3x)
+ncurses 6.4                       2023-12-23                 curs_memleaks(3x)