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