mirror of
https://github.com/Zenithsiz/ftmemsim-valgrind.git
synced 2026-02-03 18:13:01 +00:00
461cc5c003
Sync VEX/LICENSE.GPL with top-level COPYING file. We used 3 different addresses for writing to the FSF to receive a copy of the GPL. Replace all different variants with an URL <http://www.gnu.org/licenses/>. The following files might still have some slightly different (L)GPL copyright notice because they were derived from other programs: - files under coregrind/m_demangle which come from libiberty: cplus-dem.c, d-demangle.c, demangle.h, rust-demangle.c, safe-ctype.c and safe-ctype.h - coregrind/m_demangle/dyn-string.[hc] derived from GCC. - coregrind/m_demangle/ansidecl.h derived from glibc. - VEX files for FMA detived from glibc: host_generic_maddf.h and host_generic_maddf.c - files under coregrin/m_debuginfo derived from LZO: lzoconf.h, lzodefs.h, minilzo-inl.c and minilzo.h - files under coregrind/m_gdbserver detived from GDB: gdb/signals.h, inferiors.c, regcache.c, regcache.h, regdef.h, remote-utils.c, server.c, server.h, signals.c, target.c, target.h and utils.c Plus the following test files: - none/tests/ppc32/testVMX.c derived from testVMX. - ppc tests derived from QEMU: jm-insns.c, ppc64_helpers.h and test_isa_3_0.c - tests derived from bzip2 (with embedded GPL text in code): hackedbz2.c, origin5-bz2.c, varinfo6.c - tests detived from glibc: str_tester.c, pth_atfork1.c - test detived from GCC libgomp: tc17_sembar.c - performance tests derived from bzip2 or tinycc (with embedded GPL text in code): bz2.c, test_input_for_tinycc.c and tinycc.c
100 lines
4.1 KiB
C
100 lines
4.1 KiB
C
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- A simple pool (memory) allocator. pub_tool_poolalloc.h ---*/
|
|
/*--------------------------------------------------------------------*/
|
|
|
|
/*
|
|
This file is part of Valgrind, a dynamic binary instrumentation
|
|
framework.
|
|
|
|
Copyright (C) 2011-2017 OpenWorks LLP info@open-works.co.uk,
|
|
Philippe Waroquiers philippe.waroquiers@skynet.be
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, see <http://www.gnu.org/licenses/>.
|
|
|
|
The GNU General Public License is contained in the file COPYING.
|
|
*/
|
|
|
|
#ifndef __PUB_TOOL_POOLALLOC_H
|
|
#define __PUB_TOOL_POOLALLOC_H
|
|
|
|
#include "pub_tool_basics.h" // UWord
|
|
|
|
//--------------------------------------------------------------------
|
|
// PURPOSE: Provides efficient allocation and free of elements of
|
|
// the same size.
|
|
// This pool allocator manages elements alloc/free by allocating
|
|
// "pools" of many elements from a lower level allocator (typically
|
|
// pub_tool_mallocfree.h).
|
|
// Single elements can then be allocated and released from these pools.
|
|
// A pool allocator is faster and has less memory overhead than
|
|
// calling directly pub_tool_mallocfree.h
|
|
// Note: the pools of elements are not freed, even if all the
|
|
// single elements have been freed. The only way to free the underlying
|
|
// pools of elements is to delete the pool allocator.
|
|
//--------------------------------------------------------------------
|
|
|
|
|
|
typedef struct _PoolAlloc PoolAlloc;
|
|
|
|
/* Create new PoolAlloc, using given allocation and free function, and
|
|
for elements of the specified size. alloc_fn must not return NULL (that
|
|
is, if it returns it must have succeeded.)
|
|
This function never returns NULL. */
|
|
extern PoolAlloc* VG_(newPA) ( UWord elemSzB,
|
|
UWord nPerPool,
|
|
Alloc_Fn_t alloc_fn,
|
|
const HChar* cc,
|
|
Free_Fn_t free_fn );
|
|
|
|
|
|
/* Free all memory associated with a PoolAlloc. */
|
|
extern void VG_(deletePA) ( PoolAlloc* pa);
|
|
|
|
/* Allocates an element from pa. The function never returns NULL. */
|
|
extern void* VG_(allocEltPA) ( PoolAlloc* pa);
|
|
|
|
/* Free element of pa. */
|
|
extern void VG_(freeEltPA) ( PoolAlloc* pa, void* p);
|
|
|
|
/* A pool allocator can be shared between multiple data structures.
|
|
For example, multiple OSet* can allocate/free nodes from the same
|
|
pool allocator.
|
|
The Pool Allocator provides support to use a ref counter
|
|
to detect a pool allocator is not needed anymore.
|
|
It is the caller responsibility to call VG_(addRefPA) for
|
|
each new reference to a pool and VG_(releasePA) when such a reference
|
|
disappears.
|
|
VG_(releasePA) will automatically call VG_(deletePA)
|
|
to delete the PA when the ref counter drops to 0. */
|
|
|
|
// VG_(addRefPA) indicates there is a new reference to pa.
|
|
extern void VG_(addRefPA) ( PoolAlloc* pa);
|
|
|
|
// VG_(releasePA) decrements the pa reference count and deletes the pa if that
|
|
// reference count has dropped to zero. Returns the new value of the reference
|
|
// count.
|
|
extern UWord VG_(releasePA) ( PoolAlloc* pa);
|
|
|
|
// How many elements are managed by the pool 'pa'. This includes
|
|
// the elements allocated by VG_(allocEltPA), the elements freed by
|
|
// VG_(freeEltPA) and the elements that are in a block and have not
|
|
// yet been allocated.
|
|
extern UWord VG_(sizePA) ( PoolAlloc* pa);
|
|
#endif // __PUB_TOOL_POOLALLOC_
|
|
|
|
/*--------------------------------------------------------------------*/
|
|
/*--- end pub_tool_poolalloc.h ---*/
|
|
/*--------------------------------------------------------------------*/
|