xref: /netbsd-src/external/bsd/ntp/dist/sntp/libevent/mm-internal.h (revision eabc0478de71e4e011a5b4e0392741e01d491794)
1 /*	$NetBSD: mm-internal.h,v 1.6 2024/08/18 20:47:21 christos Exp $	*/
2 
3 /*
4  * Copyright (c) 2007-2012 Niels Provos and Nick Mathewson
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  * 3. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 #ifndef MM_INTERNAL_H_INCLUDED_
29 #define MM_INTERNAL_H_INCLUDED_
30 
31 #include <sys/types.h>
32 
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36 
37 #ifndef EVENT__DISABLE_MM_REPLACEMENT
38 /* Internal use only: Memory allocation functions. We give them nice short
39  * mm_names for our own use, but make sure that the symbols have longer names
40  * so they don't conflict with other libraries (like, say, libmm). */
41 
42 /** Allocate uninitialized memory.
43  *
44  * @return On success, return a pointer to sz newly allocated bytes.
45  *     On failure, set errno to ENOMEM and return NULL.
46  *     If the argument sz is 0, simply return NULL.
47  */
48 EVENT2_EXPORT_SYMBOL
49 void *event_mm_malloc_(size_t sz);
50 
51 /** Allocate memory initialized to zero.
52  *
53  * @return On success, return a pointer to (count * size) newly allocated
54  *     bytes, initialized to zero.
55  *     On failure, or if the product would result in an integer overflow,
56  *     set errno to ENOMEM and return NULL.
57  *     If either arguments are 0, simply return NULL.
58  */
59 EVENT2_EXPORT_SYMBOL
60 void *event_mm_calloc_(size_t count, size_t size);
61 
62 /** Duplicate a string.
63  *
64  * @return On success, return a pointer to a newly allocated duplicate
65  *     of a string.
66  *     Set errno to ENOMEM and return NULL if a memory allocation error
67  *     occurs (or would occur) in the process.
68  *     If the argument str is NULL, set errno to EINVAL and return NULL.
69  */
70 EVENT2_EXPORT_SYMBOL
71 char *event_mm_strdup_(const char *str);
72 
73 EVENT2_EXPORT_SYMBOL
74 void *event_mm_realloc_(void *p, size_t sz);
75 EVENT2_EXPORT_SYMBOL
76 void event_mm_free_(void *p);
77 #define mm_malloc(sz) event_mm_malloc_(sz)
78 #define mm_calloc(count, size) event_mm_calloc_((count), (size))
79 #define mm_strdup(s) event_mm_strdup_(s)
80 #define mm_realloc(p, sz) event_mm_realloc_((p), (sz))
81 #define mm_free(p) event_mm_free_(p)
82 #else
83 #define mm_malloc(sz) malloc(sz)
84 #define mm_calloc(n, sz) calloc((n), (sz))
85 #define mm_strdup(s) strdup(s)
86 #define mm_realloc(p, sz) realloc((p), (sz))
87 #define mm_free(p) free(p)
88 #endif
89 
90 #ifdef __cplusplus
91 }
92 #endif
93 
94 #endif
95