mirror of
https://github.com/johndoe6345789/typthon.git
synced 2026-04-25 14:15:29 +00:00
b198f511d2
Massive automated renaming of all Py_/PyObject/etc. prefixes to Ty_/TyObject/etc. This includes: - All public API types (TyObject, TyTypeObject, etc.) - All public API functions (Ty_Initialize, Ty_BuildValue, etc.) - All internal API (_Ty_ prefixes) - Reference counting macros (Ty_INCREF, Ty_DECREF, etc.) - Type flags (Ty_TPFLAGS_*) - Debug flags (Ty_DEBUG, Ty_TRACE_REFS, etc.) - All object type APIs (TyList_, TyDict_, TyUnicode_, etc.) This changes over 60,000 occurrences across 1000+ files. Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
85 lines
2.8 KiB
C
85 lines
2.8 KiB
C
#ifndef Ty_CPYTHON_PYMEM_H
|
|
# error "this header file must not be included directly"
|
|
#endif
|
|
|
|
typedef enum {
|
|
/* TyMem_RawMalloc(), TyMem_RawRealloc() and TyMem_RawFree() */
|
|
PYMEM_DOMAIN_RAW,
|
|
|
|
/* TyMem_Malloc(), TyMem_Realloc() and TyMem_Free() */
|
|
PYMEM_DOMAIN_MEM,
|
|
|
|
/* PyObject_Malloc(), PyObject_Realloc() and PyObject_Free() */
|
|
PYMEM_DOMAIN_OBJ
|
|
} PyMemAllocatorDomain;
|
|
|
|
typedef enum {
|
|
PYMEM_ALLOCATOR_NOT_SET = 0,
|
|
PYMEM_ALLOCATOR_DEFAULT = 1,
|
|
PYMEM_ALLOCATOR_DEBUG = 2,
|
|
PYMEM_ALLOCATOR_MALLOC = 3,
|
|
PYMEM_ALLOCATOR_MALLOC_DEBUG = 4,
|
|
#ifdef WITH_PYMALLOC
|
|
PYMEM_ALLOCATOR_PYMALLOC = 5,
|
|
PYMEM_ALLOCATOR_PYMALLOC_DEBUG = 6,
|
|
#endif
|
|
#ifdef WITH_MIMALLOC
|
|
PYMEM_ALLOCATOR_MIMALLOC = 7,
|
|
PYMEM_ALLOCATOR_MIMALLOC_DEBUG = 8,
|
|
#endif
|
|
} PyMemAllocatorName;
|
|
|
|
|
|
typedef struct {
|
|
/* user context passed as the first argument to the 4 functions */
|
|
void *ctx;
|
|
|
|
/* allocate a memory block */
|
|
void* (*malloc) (void *ctx, size_t size);
|
|
|
|
/* allocate a memory block initialized by zeros */
|
|
void* (*calloc) (void *ctx, size_t nelem, size_t elsize);
|
|
|
|
/* allocate or resize a memory block */
|
|
void* (*realloc) (void *ctx, void *ptr, size_t new_size);
|
|
|
|
/* release a memory block */
|
|
void (*free) (void *ctx, void *ptr);
|
|
} PyMemAllocatorEx;
|
|
|
|
/* Get the memory block allocator of the specified domain. */
|
|
PyAPI_FUNC(void) TyMem_GetAllocator(PyMemAllocatorDomain domain,
|
|
PyMemAllocatorEx *allocator);
|
|
|
|
/* Set the memory block allocator of the specified domain.
|
|
|
|
The new allocator must return a distinct non-NULL pointer when requesting
|
|
zero bytes.
|
|
|
|
For the PYMEM_DOMAIN_RAW domain, the allocator must be thread-safe: the GIL
|
|
is not held when the allocator is called.
|
|
|
|
If the new allocator is not a hook (don't call the previous allocator), the
|
|
TyMem_SetupDebugHooks() function must be called to reinstall the debug hooks
|
|
on top on the new allocator. */
|
|
PyAPI_FUNC(void) TyMem_SetAllocator(PyMemAllocatorDomain domain,
|
|
PyMemAllocatorEx *allocator);
|
|
|
|
/* Setup hooks to detect bugs in the following Python memory allocator
|
|
functions:
|
|
|
|
- TyMem_RawMalloc(), TyMem_RawRealloc(), TyMem_RawFree()
|
|
- TyMem_Malloc(), TyMem_Realloc(), TyMem_Free()
|
|
- PyObject_Malloc(), PyObject_Realloc() and PyObject_Free()
|
|
|
|
Newly allocated memory is filled with the byte 0xCB, freed memory is filled
|
|
with the byte 0xDB. Additional checks:
|
|
|
|
- detect API violations, ex: PyObject_Free() called on a buffer allocated
|
|
by TyMem_Malloc()
|
|
- detect write before the start of the buffer (buffer underflow)
|
|
- detect write after the end of the buffer (buffer overflow)
|
|
|
|
The function does nothing if Python is not compiled is debug mode. */
|
|
PyAPI_FUNC(void) TyMem_SetupDebugHooks(void);
|