1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
/* KInterbasDB Python Package - Header File for Memory Management Wrappers
**
** Version 3.1
**
** The following contributors hold Copyright (C) over their respective
** portions of code (see license.txt for details):
**
** [Original Author (maintained through version 2.0-0.3.1):]
** 1998-2001 [alex] Alexander Kuznetsov <alexan@users.sourceforge.net>
** [Maintainers (after version 2.0-0.3.1):]
** 2001-2002 [maz] Marek Isalski <kinterbasdb@maz.nu>
** 2002-2004 [dsr] David Rushby <woodsplitter@rocketmail.com>
** [Contributors:]
** 2001 [eac] Evgeny A. Cherkashin <eugeneai@icc.ru>
** 2001-2002 [janez] Janez Jere <janez.jere@void.si>
*/
/* This header file is intended to provide centralized aliases for the various
** sets of memory handling functions that kinterbasdb uses. The centralization
** will have two main benefits:
** - facilitate debug tracing of memory operations
** - reduce the likelihood of "series mismatches" between allocation and
** freeing functions for the same piece of memory by providing more
** descriptive names (such as kimem_xsqlda_malloc for XSQLDA memory
** allocation).
** This issue is especially crucial with Python 2.3, which makes the
** specialized pymalloc memory allocater (available via the
** PyObject_[Malloc|Realloc|Free] series) the default. */
#ifndef _KIMEM_H
#define _KIMEM_H
/*************************** PLAIN ************************************/
/* kimem_plain_* is kinterbasdb's simplest series of memory handlers.
** Typically, these will simply be aliases for the libc C memory handlers.
**
** kimem_plain_* should NEVER resolve to pymalloc's memory handlers, nor to any
** other memory allocator that's expected to be incompatible with "generic"
** memory allocated "by some third party".
**
** Also, unlike kimem_main_*, this series must be threadsafe.
*/
#define kimem_plain_malloc malloc
#define kimem_plain_realloc realloc
#define kimem_plain_free free
/*************************** MAIN ************************************/
/* series for pymalloc, the specialized Python-oriented memory handler that
** became standard in Python 2.3.
**
** Unless there's a specific reason not to (as noted elsewhere in this file,
** including in the WARNING just below), any kinterbasdb [|de|re]allocation of
** raw memory should use this series.
**
** WARNING:
** Members of the kimem_main_* series must only be called when the GIL is
** held, since they rely on pymalloc, which assumes the GIL is held.
*/
#define kimem_main_malloc PyObject_Malloc
#define kimem_main_realloc PyObject_Realloc
#define kimem_main_free PyObject_Free
/*************************** DB_CLIENT ***********************************/
/* This series is implemented by the database client library. The client
** library sometimes gives us deallocation responsibility for chunks of memory
** that were allocated using its own memory handler. */
#define kimem_db_client_malloc isc_malloc
#define kimem_db_client_realloc isc_realloc
#define kimem_db_client_free isc_free
/*************************** XSQLDA ************************************/
/* The kimem_xsqlda_* memory management aliases were established because
** trouble arises when XSQLDA structures are allocated/freed with pymalloc.
** Probably, some isc_* functions that handle XSQLDAs or their XSQLVARs make
** changes to those structures' memory that are not obvious, and in a way that
** requires those structures to have been allocated with the standard C malloc.
**
** NOTES:
** - These memory handlers are for the XSQLDA structures themselves (which
** contain XSQLVARs), not for handling memory indirectly related to the
** XSQLDA, such as XSQLVAR.sqldata and XSQLVAR.sqlind (those latter work just
** fine with pymalloc). */
#define kimem_xsqlda_malloc kimem_plain_malloc
#define kimem_xsqlda_realloc kimem_plain_realloc
#define kimem_xsqlda_free kimem_plain_free
/******************************************************************************/
#endif /* not def _KIMEM_H */
|
