xref: /utopia/UTPA2-700.0.x/projects/tools/lint/mips-linux-gnu_include/mcheck.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1*53ee8cc1Swenshuai.xi /* Copyright (C) 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
2*53ee8cc1Swenshuai.xi    This file is part of the GNU C Library.
3*53ee8cc1Swenshuai.xi 
4*53ee8cc1Swenshuai.xi    The GNU C Library is free software; you can redistribute it and/or
5*53ee8cc1Swenshuai.xi    modify it under the terms of the GNU Lesser General Public
6*53ee8cc1Swenshuai.xi    License as published by the Free Software Foundation; either
7*53ee8cc1Swenshuai.xi    version 2.1 of the License, or (at your option) any later version.
8*53ee8cc1Swenshuai.xi 
9*53ee8cc1Swenshuai.xi    The GNU C Library is distributed in the hope that it will be useful,
10*53ee8cc1Swenshuai.xi    but WITHOUT ANY WARRANTY; without even the implied warranty of
11*53ee8cc1Swenshuai.xi    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12*53ee8cc1Swenshuai.xi    Lesser General Public License for more details.
13*53ee8cc1Swenshuai.xi 
14*53ee8cc1Swenshuai.xi    You should have received a copy of the GNU Lesser General Public
15*53ee8cc1Swenshuai.xi    License along with the GNU C Library; if not, write to the Free
16*53ee8cc1Swenshuai.xi    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
17*53ee8cc1Swenshuai.xi    02111-1307 USA.  */
18*53ee8cc1Swenshuai.xi 
19*53ee8cc1Swenshuai.xi #ifndef _MCHECK_H
20*53ee8cc1Swenshuai.xi #define _MCHECK_H	1
21*53ee8cc1Swenshuai.xi 
22*53ee8cc1Swenshuai.xi #include <features.h>
23*53ee8cc1Swenshuai.xi 
24*53ee8cc1Swenshuai.xi __BEGIN_DECLS
25*53ee8cc1Swenshuai.xi 
26*53ee8cc1Swenshuai.xi /* Return values for `mprobe': these are the kinds of inconsistencies that
27*53ee8cc1Swenshuai.xi    `mcheck' enables detection of.  */
28*53ee8cc1Swenshuai.xi enum mcheck_status
29*53ee8cc1Swenshuai.xi   {
30*53ee8cc1Swenshuai.xi     MCHECK_DISABLED = -1,       /* Consistency checking is not turned on.  */
31*53ee8cc1Swenshuai.xi     MCHECK_OK,                  /* Block is fine.  */
32*53ee8cc1Swenshuai.xi     MCHECK_FREE,                /* Block freed twice.  */
33*53ee8cc1Swenshuai.xi     MCHECK_HEAD,                /* Memory before the block was clobbered.  */
34*53ee8cc1Swenshuai.xi     MCHECK_TAIL                 /* Memory after the block was clobbered.  */
35*53ee8cc1Swenshuai.xi   };
36*53ee8cc1Swenshuai.xi 
37*53ee8cc1Swenshuai.xi 
38*53ee8cc1Swenshuai.xi /* Activate a standard collection of debugging hooks.  This must be called
39*53ee8cc1Swenshuai.xi    before `malloc' is ever called.  ABORTFUNC is called with an error code
40*53ee8cc1Swenshuai.xi    (see enum above) when an inconsistency is detected.  If ABORTFUNC is
41*53ee8cc1Swenshuai.xi    null, the standard function prints on stderr and then calls `abort'.  */
42*53ee8cc1Swenshuai.xi extern int mcheck (void (*__abortfunc) (enum mcheck_status)) __THROW;
43*53ee8cc1Swenshuai.xi 
44*53ee8cc1Swenshuai.xi /* Similar to `mcheck� but performs checks for all block whenever one of
45*53ee8cc1Swenshuai.xi    the memory handling functions is called.  This can be very slow.  */
46*53ee8cc1Swenshuai.xi extern int mcheck_pedantic (void (*__abortfunc) (enum mcheck_status)) __THROW;
47*53ee8cc1Swenshuai.xi 
48*53ee8cc1Swenshuai.xi /* Force check of all blocks now.  */
49*53ee8cc1Swenshuai.xi extern void mcheck_check_all (void);
50*53ee8cc1Swenshuai.xi 
51*53ee8cc1Swenshuai.xi /* Check for aberrations in a particular malloc'd block.  You must have
52*53ee8cc1Swenshuai.xi    called `mcheck' already.  These are the same checks that `mcheck' does
53*53ee8cc1Swenshuai.xi    when you free or reallocate a block.  */
54*53ee8cc1Swenshuai.xi extern enum mcheck_status mprobe (void *__ptr) __THROW;
55*53ee8cc1Swenshuai.xi 
56*53ee8cc1Swenshuai.xi /* Activate a standard collection of tracing hooks.  */
57*53ee8cc1Swenshuai.xi extern void mtrace (void) __THROW;
58*53ee8cc1Swenshuai.xi extern void muntrace (void) __THROW;
59*53ee8cc1Swenshuai.xi 
60*53ee8cc1Swenshuai.xi __END_DECLS
61*53ee8cc1Swenshuai.xi 
62*53ee8cc1Swenshuai.xi #endif /* mcheck.h */
63