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
|
/** \file xmalloc.h -- Declarations for the fail-on-OOM string functions */
#ifndef XMALLOC_H
#define XMALLOC_H
#include "config.h"
#include <stdlib.h>
#ifdef __cplusplus
extern "C" {
#endif
/* xmalloc.c */
#if !defined __GNUC__ || __GNUC__ + 0 < 2
# define __attribute__(xyz) /* Ignore. */
#endif
/** Allocate \a n characters of memory, abort program on failure. */
void *xmalloc(size_t n) __attribute__((malloc, returns_nonnull));
/** Reallocate \a n characters of memory, abort program on failure. */
void *xrealloc(/*@null@*/ void *, size_t n)__attribute__((malloc, returns_nonnull));
/** Free memory at position \a p and set pointer \a p to NULL afterwards. */
#define xfree(p) do { if (p) { free(p); (p) = 0; } } while(0)
/** Zero out and free memory up to strlen(p) at \a p and set pointer \a p to
* NULL. If you know the buffer size still, better call fm_safe_clearmem() with
* the max buffer size and then xfree(). */
#define xzerofree(p) do { if (p) { fm_safe_clearmem(p, strlen(p)); free(p); (p) = 0; } } while(0)
/** Duplicate string \a src to a newly malloc()d memory region and return its
* pointer, abort program on failure. You can free this with xzerofree() if it
* contains sensitive data, xfree() or free() otherwise. */
char *xstrdup(const char *src)__attribute__((malloc, returns_nonnull));
/** Duplicate at most the first \a n characters from \a src to a newly
* malloc()d memory region and NUL-terminate it, and return its pointer, abort
* program on failure. The memory size is the lesser of either the string
* length including NUL byte or n + 1. You can free this with xzerofree() if it
* contains sensitive data, xfree() or free() otherwise.*/
char *xstrndup(const char *src, size_t n)__attribute__((malloc, returns_nonnull));
#ifdef __cplusplus
}
#endif
#endif
|
