From c7a8920b83ef695b428cff45bfaca90e0073761a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 30 Aug 2015 18:01:13 +0200 Subject: move memory allocation functions to malloc.h MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- include/malloc.h | 121 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ include/stdlib.h | 90 +---------------------------------------- 2 files changed, 122 insertions(+), 89 deletions(-) create mode 100644 include/malloc.h (limited to 'include') diff --git a/include/malloc.h b/include/malloc.h new file mode 100644 index 0000000..c18f885 --- /dev/null +++ b/include/malloc.h @@ -0,0 +1,121 @@ +/** + * slibc — Yet another C library + * Copyright © 2015 Mattias Andrée (maandree@member.fsf.org) + * + * 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 3 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 . + */ +#ifndef _MALLOC_H +#define _MALLOC_H +#include + + +#include + + + +#define __NEED_size_t +#include + + +/** + * Create a new memory allocation on the heap. + * The allocation will not be initialised. + * + * @param size The size of the allocation. + * @return Pointer to the beginning of the new allocation. + * If `size` is zero, this function will either return + * `NULL` (that is what this implement does) or return + * a unique pointer that can later be freed with `free`. + * `NULL` is returned on error, and `errno` is set to + * indicate the error. + * + * @throws ENOMEM The process cannot allocate more memory. + */ +void* malloc(size_t) + __GCC_ONLY(__attribute__((malloc, warn_unused_result))); + +/** + * Variant of `malloc` that clears the allocation with zeroes. + * + * `p = calloc(n, m)` is equivalent to + * `(p = malloc(n * m), p ? (explicit_bzero(p, n * m), p) : NULL)` + * + * @param elem_count The number of elements to allocate. + * @param elem_size The size of each element. + * @return Pointer to the beginning of the new allocation. + * If `elem_count` or `elem_size` is zero, this function + * will either return `NULL` (that is what this implement + * does) or return a unique pointer that can later be + * freed with `free`. `NULL` is returned on error, and + * `errno` is set to indicate the error. + * + * @throws ENOMEM The process cannot allocate more memory. + */ +void* calloc(size_t, size_t) + __GCC_ONLY(__attribute__((malloc, warn_unused_result))); + +/** + * Variant of `malloc` that extends, or shrinks, an existing allocation, + * if beneficial and possible, or creates a new allocation with the new + * size, copies the data, and frees the old allocation. + * + * On error, `ptr` is not freed. + * + * @param ptr Pointer to the beginning of the old memory allocation. + * The process may crash if it does not point to the + * beginning of a memory allocation on the heap. + * However, if it is `NULL`, this function will behave + * like `malloc`. + * @param size The new allocation size. If zero, this function will + * behave like `free`, and will return `NULL`. + * @return Pointer to the beginning of the new allocation. + * If `size` is zero, `NULL` is returned. On error `NULL` + * is returned and `errno` is set to indicate the error. + * + * @throws ENOMEM The process cannot allocate more memory. + */ +void* realloc(void*, size_t) + __GCC_ONLY(__attribute__((warn_unused_result))) + __slibc_warning("Use 'fast_realloc', 'secure_realloc' or 'crealloc' instead."); + +/** + * Free a memory allocation. + * + * @param ptr Pointer to the beginning of the memory allocation. + * The process may crash if it does not point to the + * beginning of a memory allocation on the heap. + * However, if it is `NULL`, nothing will happen. + */ +void free(void*) __slibc_warning("Use 'fast_free' or 'secure_free' instead."); + +/** + * This function is identical to `free`. + * Any argument beyond the first argument, is ignored. + * + * This function uses variadic arguments because there + * there are multiple conflicting specifications for `cfree`. + * + * @param ptr Pointer to the beginning of the memory allocation. + * The process may crash if it does not point to the + * beginning of a memory allocation on the heap. + * However, if it is `NULL`, nothing will happen. + */ +#ifndef _PORTABLE_SOURCE +void cfree(void*, ...) __deprecated("'cfree' is deprecated and not portable, use 'free' instead."); +#endif + + + +#endif + diff --git a/include/stdlib.h b/include/stdlib.h index 0b88fd2..5ac4e7c 100644 --- a/include/stdlib.h +++ b/include/stdlib.h @@ -21,6 +21,7 @@ #include +#include @@ -42,94 +43,5 @@ -/** - * Create a new memory allocation on the heap. - * The allocation will not be initialised. - * - * @param size The size of the allocation. - * @return Pointer to the beginning of the new allocation. - * If `size` is zero, this function will either return - * `NULL` (that is what this implement does) or return - * a unique pointer that can later be freed with `free`. - * `NULL` is returned on error, and `errno` is set to - * indicate the error. - * - * @throws ENOMEM The process cannot allocate more memory. - */ -void* malloc(size_t) - __GCC_ONLY(__attribute__((malloc, warn_unused_result))); - -/** - * Variant of `malloc` that clears the allocation with zeroes. - * - * `p = calloc(n, m)` is equivalent to - * `(p = malloc(n * m), p ? (explicit_bzero(p, n * m), p) : NULL)` - * - * @param elem_count The number of elements to allocate. - * @param elem_size The size of each element. - * @return Pointer to the beginning of the new allocation. - * If `elem_count` or `elem_size` is zero, this function - * will either return `NULL` (that is what this implement - * does) or return a unique pointer that can later be - * freed with `free`. `NULL` is returned on error, and - * `errno` is set to indicate the error. - * - * @throws ENOMEM The process cannot allocate more memory. - */ -void* calloc(size_t, size_t) - __GCC_ONLY(__attribute__((malloc, warn_unused_result))); - -/** - * Variant of `malloc` that extends, or shrinks, an existing allocation, - * if beneficial and possible, or creates a new allocation with the new - * size, copies the data, and frees the old allocation. - * - * On error, `ptr` is not freed. - * - * @param ptr Pointer to the beginning of the old memory allocation. - * The process may crash if it does not point to the - * beginning of a memory allocation on the heap. - * However, if it is `NULL`, this function will behave - * like `malloc`. - * @param size The new allocation size. If zero, this function will - * behave like `free`, and will return `NULL`. - * @return Pointer to the beginning of the new allocation. - * If `size` is zero, `NULL` is returned. On error `NULL` - * is returned and `errno` is set to indicate the error. - * - * @throws ENOMEM The process cannot allocate more memory. - */ -void* realloc(void*, size_t) - __GCC_ONLY(__attribute__((warn_unused_result))) - __slibc_warning("Use 'fast_realloc', 'secure_realloc' or 'crealloc' instead."); - -/** - * Free a memory allocation. - * - * @param ptr Pointer to the beginning of the memory allocation. - * The process may crash if it does not point to the - * beginning of a memory allocation on the heap. - * However, if it is `NULL`, nothing will happen. - */ -void free(void*) __slibc_warning("Use 'fast_free' or 'secure_free' instead."); - -/** - * This function is identical to `free`. - * Any argument beyond the first argument, is ignored. - * - * This function uses variadic arguments because there - * there are multiple conflicting specifications for `cfree`. - * - * @param ptr Pointer to the beginning of the memory allocation. - * The process may crash if it does not point to the - * beginning of a memory allocation on the heap. - * However, if it is `NULL`, nothing will happen. - */ -#ifndef _PORTABLE_SOURCE -void cfree(void*, ...) __deprecated("'cfree' is deprecated and not portable, use 'free' instead."); -#endif - - - #endif -- cgit v1.2.3-70-g09d2