diff options
Diffstat (limited to 'doc/html/man/curs_memleaks.3x.html')
| -rw-r--r-- | doc/html/man/curs_memleaks.3x.html | 66 |
1 files changed, 40 insertions, 26 deletions
diff --git a/doc/html/man/curs_memleaks.3x.html b/doc/html/man/curs_memleaks.3x.html index 388d969a3146..085e3aba91d8 100644 --- a/doc/html/man/curs_memleaks.3x.html +++ b/doc/html/man/curs_memleaks.3x.html @@ -1,6 +1,6 @@ -<!-- +<!-- **************************************************************************** - * Copyright 2019-2020,2021 Thomas E. Dickey * + * Copyright 2019-2023,2024 Thomas E. Dickey * * Copyright 2008-2010,2017 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,27 +27,27 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_memleaks.3x,v 1.11 2021/01/02 23:47:51 tom Exp @ + * @Id: curs_memleaks.3x,v 1.35 2024/03/16 15:35:01 tom Exp @ --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML> <HEAD> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts"> -<TITLE>curs_memleaks 3x</TITLE> +<TITLE>curs_memleaks 3x 2024-03-16 ncurses 6.5 Library calls</TITLE> <link rel="author" href="mailto:bug-ncurses@gnu.org"> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + </HEAD> <BODY> -<H1 class="no-header">curs_memleaks 3x</H1> +<H1 class="no-header">curs_memleaks 3x 2024-03-16 ncurses 6.5 Library calls</H1> <PRE> -<STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> <STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> +<STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> Library calls <STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE> - <STRONG>exit_curses</STRONG>, <STRONG>exit_terminfo</STRONG> - <STRONG>curses</STRONG> memory-leak checking + <STRONG>exit_curses</STRONG>, <STRONG>exit_terminfo</STRONG> - check for memory leaks in <EM>curses</EM> </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE> @@ -57,7 +57,7 @@ <STRONG>#include</STRONG> <STRONG><term.h></STRONG> <STRONG>void</STRONG> <STRONG>exit_terminfo(int</STRONG> <EM>code</EM><STRONG>);</STRONG> - /* deprecated (intentionally not declared in curses.h or term.h) */ + <EM>/*</EM> <EM>deprecated</EM> <EM>(intentionally</EM> <EM>not</EM> <EM>declared</EM> <EM>in</EM> <EM>curses.h</EM> <EM>or</EM> <EM>term.h)</EM> <EM>*/</EM> <STRONG>void</STRONG> <STRONG>_nc_freeall(void);</STRONG> <STRONG>void</STRONG> <STRONG>_nc_free_and_exit(int</STRONG> <EM>code</EM><STRONG>);</STRONG> <STRONG>void</STRONG> <STRONG>_nc_free_tinfo(int</STRONG> <EM>code</EM><STRONG>);</STRONG> @@ -65,28 +65,28 @@ </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE> These functions are used to simplify analysis of memory leaks in the - ncurses library. + <EM>ncurses</EM> library. Any implementation of curses must not free the memory associated with a screen, since (even after calling <STRONG><A HREF="curs_initscr.3x.html">endwin(3x)</A></STRONG>), it must be available for use in the next call to <STRONG><A HREF="curs_refresh.3x.html">refresh(3x)</A></STRONG>. 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 <EM>ncurses</EM> 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: <STRONG>_nc_freeall</STRONG> - This frees (almost) all of the memory allocated by ncurses. + This frees (almost) all of the memory allocated by <EM>ncurses</EM>. <STRONG>_nc_free_and_exit</STRONG> - This frees the memory allocated by ncurses (like <STRONG>_nc_freeall</STRONG>), and + This frees the memory allocated by <EM>ncurses</EM> (like <STRONG>_nc_freeall</STRONG>), and exits the program. It is preferred over <STRONG>_nc_freeall</STRONG> 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. <STRONG>_nc_free_tinfo</STRONG> 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 <STRONG>--disable-leaks</STRONG> op- - tion. That compiles-in code that frees memory that normally would not - be freed. + configured into the library at build time using the <STRONG>--disable-leaks</STRONG> + option. That compiles-in code that frees memory that normally would + not be freed. The <STRONG>exit_curses</STRONG> and <STRONG>exit_terminfo</STRONG> functions call <STRONG>_nc_free_and_exit</STRONG> and <STRONG>_nc_free_tinfo</STRONG> if the library is configured to support memory-leak @@ -109,16 +109,30 @@ </PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE> - 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: + + <STRONG>o</STRONG> The portable part of <STRONG>exit_curses</STRONG> can be freed using <STRONG>delscreen</STRONG>, + passing the <EM>SCREEN</EM> pointer returned by <STRONG>newterm</STRONG>. + + In some implementations, there is a global variable <STRONG>sp</STRONG> which could + be used, e.g., if the screen were only initialized using <STRONG>initscr</STRONG>. + + <STRONG>o</STRONG> The portable part of <STRONG>exit_terminfo</STRONG> can be freed using <STRONG>del_curterm</STRONG>. + + In this case, there is a global variable <STRONG>cur_term</STRONG> which can be used + as parameter. </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE> - <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>. + <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="curs_initscr.3x.html">curs_initscr(3x)</A></STRONG>, <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG> - <STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> +ncurses 6.5 2024-03-16 <STRONG><A HREF="curs_memleaks.3x.html">curs_memleaks(3x)</A></STRONG> </PRE> <div class="nav"> <ul> |
