_malloc.h (3428B) - Raw
1 /* 2 * Copyright (c) 2018-2023 Apple Computer, Inc. All rights reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 24 #ifndef _MALLOC_UNDERSCORE_MALLOC_H_ 25 #define _MALLOC_UNDERSCORE_MALLOC_H_ 26 27 /* 28 * This header is included from <stdlib.h>, so the contents of this file have 29 * broad source compatibility and POSIX conformance implications. 30 * Be cautious about what is included and declared here. 31 */ 32 33 #include <Availability.h> 34 #include <sys/cdefs.h> 35 #if __has_include(<sys/_types/_size_t.h>) 36 #include <sys/_types/_size_t.h> 37 #else 38 #define __need_size_t 39 #include <stddef.h> 40 #undef __need_size_t 41 #endif 42 43 #if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 44 #include <malloc/_malloc_type.h> 45 #else 46 #define _MALLOC_TYPED(override, type_param_pos) 47 #endif 48 49 #include <malloc/_ptrcheck.h> 50 __ptrcheck_abi_assume_single() 51 52 __BEGIN_DECLS 53 54 void * __sized_by_or_null(__size) malloc(size_t __size) __result_use_check __alloc_size(1) _MALLOC_TYPED(malloc_type_malloc, 1); 55 void * __sized_by_or_null(__count * __size) calloc(size_t __count, size_t __size) __result_use_check __alloc_size(1,2) _MALLOC_TYPED(malloc_type_calloc, 2); 56 void free(void * __unsafe_indexable); 57 void * __sized_by_or_null(__size) realloc(void * __unsafe_indexable __ptr, size_t __size) __result_use_check __alloc_size(2) _MALLOC_TYPED(malloc_type_realloc, 2); 58 void * __sized_by_or_null(__size) reallocf(void * __unsafe_indexable __ptr, size_t __size) __result_use_check __alloc_size(2); 59 #if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 60 void * __sized_by_or_null(__size) valloc(size_t __size) __result_use_check __alloc_size(1) _MALLOC_TYPED(malloc_type_valloc, 1); 61 #endif /* !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) */ 62 #if (defined(__DARWIN_C_LEVEL) && defined(__DARWIN_C_FULL) && __DARWIN_C_LEVEL >= __DARWIN_C_FULL) || \ 63 (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L) || \ 64 (defined(__cplusplus) && __cplusplus >= 201703L) 65 void * __sized_by_or_null(__size) aligned_alloc(size_t __alignment, size_t __size) __result_use_check __alloc_align(1) __alloc_size(2) _MALLOC_TYPED(malloc_type_aligned_alloc, 2) __OSX_AVAILABLE(10.15) __IOS_AVAILABLE(13.0) __TVOS_AVAILABLE(13.0) __WATCHOS_AVAILABLE(6.0); 66 #endif 67 /* rdar://120689514 */ 68 int posix_memalign(void * __unsafe_indexable *__memptr, size_t __alignment, size_t __size) _MALLOC_TYPED(malloc_type_posix_memalign, 3) __OSX_AVAILABLE_STARTING(__MAC_10_6, __IPHONE_3_0); 69 70 __END_DECLS 71 72 #endif /* _MALLOC_UNDERSCORE_MALLOC_H_ */