1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
/* eurephia_nullsafe.c
*
* standard C string functions, which is made NULL safe by checking
* if input value is NULL before performing the action.
*
* GPLv2 only - Copyright (C) 2009 - 2010
* David Sommerseth <dazo@users.sourceforge.net>
*
* 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; version 2
* of the License.
*
* 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, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
*/
/**
* @file eurephia_nullsafe.c
* @author David Sommerseth <dazo@users.sourceforge.net>
* @date 2009-09-07
*
* @brief standard C string functions, which is made NULL safe by checking
* if input value is NULL before performing the action.
*
*/
#include <stdio.h>
#include <stdlib.h>
#include <eurephia_context.h>
#include <eurephia_log.h>
#if __GNUC__ >= 3
#define __malloc__ __attribute__((malloc))
#else /* If not GCC 3 or newer, disable optimisations */
#define __malloc__
#endif
/**
* Internal function, should be called via the malloc_nullsafe() macro.
* This replaces the use of malloc() and memset(). This function uses calloc
* internally, which results in the memory region being zero'd by the kernel
* on memory allocation.
*
* @param ctx eurephiaCTX, used for logging
* @param sz size of the memory region being allocated
* @param file debug info, which file is doing this call
* @param line debug info, which line in the file
*
* @return Returns a void pointer to the memory region on success, otherwise NULL
*/
__malloc__ void *_malloc_nullsafe(eurephiaCTX *ctx, size_t sz, const char *file, int line) {
void *buf = NULL;
buf = calloc(1, sz); /* Using calloc, also gives a zero'd memory region */
if( !buf ) {
if( ctx ) {
eurephia_log(ctx, LOG_FATAL, 40,
"Could not allocate memory region for %ld bytes (File %s, line %i)",
sz, file, line);
} else {
fprintf(stderr, "** FATAL ERROR ** "
"Could not allocate memory region for %ld bytes (File %s, line %i)",
(unsigned long int) sz, file, line);
}
}
#ifdef DEBUG
else {
// Don't use DEBUG macro, to catch the right file and line number for the log
_eurephia_log_func(ctx, LOG_DEBUG, 40, file, line,
"Allocated %ld bytes of memory on address %p",
sz, buf);
}
#endif
return buf;
}
/**
* Internal function for freeing memory. Also does some logging of the freeing if debug level
* enabled and log level high enough. Should be called via the free_nullsafe() macro.
*
* @param ctx eurephiaCTX (for logging only)
* @param ptr Pointer to the memory region to be freed
* @param file debug info, which file is doing this call
* @param line debug info, which line in the file
*
*/
void inline _free_nullsafe(eurephiaCTX *ctx, void *ptr, const char *file, int line) {
if( ptr == NULL ) {
return;
}
#ifdef DEBUG
// Don't use DEBUG macro, to catch the right file and line number for the log
_eurephia_log_func(ctx, LOG_DEBUG, 40, file, line, "Freeing memory on address %p", ptr);
#endif
free(ptr);
}
|