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
|
/**
* slibc — Yet another C library
* Copyright © 2015, 2016 Mattias Andrée (m@maandree.se)
*
* 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 <http://www.gnu.org/licenses/>.
*/
#ifndef _ALLOCA_H
#define _ALLOCA_H
#include <slibc/version.h>
#include <slibc/features.h>
#ifndef __PORTABLE
#define __NEED_size_t
#include <bits/types.h>
/* alloca is machine- _and_ compiler-dependent, it is not
* implemented in slibc, but in the compiler. */
/**
* Allocation memory in the stack frame of the caller.
*
* Undefined behaviour is invoked if the memory
* cannot be allocated.
*
* @etymology (Alloca)te!
*
* @param size The number of bytes to allocate.
* @return Pointer to the beginning of the allocated
* space. Do not free it, it will be freed
* automatically when the function returns.
*
* @since Always.
*/
void* alloca(size_t)
__GCC_ONLY(__attribute__((__warn_unused_result__)));
#if defined(__GNUC__)
# define alloca(size) __builtin_alloca(size)
#endif
#if defined(__PLAN9_SOURCE)
/**
* Check for execution stack overflow. If the stack of
* overflow, or will overflow, the program shall abort.
*
* It is possible that the process is killed by SIGSEGV
* instead of aborting.
*
* This is a Plan 9 from Bell Labs extension.
*
* @etymology I (need) addition (stack) space.
*
* @param n The number of bytes the stack will grow by.
* 0 can be used to check for a current stack
* overflow. Must be non-negative.
*
* @since Always.
*/
void (needstack)(int);
# if defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L)
# define needstack(n) __needstack(n, __FILE__, __LINE__, __func__)
# else
# define needstack(n) __needstack(n, __FILE__, __LINE__, NULL)
# endif
#endif
/**
* This function is called if the `needstack` macro is called.
* It enhances the `needstack` function with detail on where
* the program failed.
*
* You should not use this function directly.
*
* @param n The number of bytes the stack will grow by. 0 can be used
* to check for a current stack overflow. Must be non-negative.
* @param file The filename of the source cose whence the check was made.
* @param line The line in the source code whence the check was made.
* @param func The function in the source code whence the check was made,
* `NULL` if unknown (C99 is required.)
*/
void __needstack(int, const char*, int, const char*);
#endif
#endif
|
