1 /* A GNU-like <stdlib.h>.
3 Copyright (C) 1995, 2001-2004, 2006-2009 Free Software Foundation, Inc.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19 @PRAGMA_SYSTEM_HEADER@
22 #if defined __need_malloc_and_calloc
23 /* Special invocation convention inside glibc header files. */
25 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
28 /* Normal invocation convention. */
32 /* The include_next requires a split double-inclusion guard. */
33 #@INCLUDE_NEXT@ @NEXT_STDLIB_H@
38 /* NetBSD 5.0 mis-defines NULL. */
41 /* Solaris declares getloadavg() in <sys/loadavg.h>. */
42 #if @GNULIB_GETLOADAVG@ && @HAVE_SYS_LOADAVG_H@
43 # include <sys/loadavg.h>
46 /* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
47 from <stdlib.h> if _REENTRANT is defined. Include it always. */
52 #if @GNULIB_RANDOM_R@ || !@HAVE_STRUCT_RANDOM_DATA@
56 #if !@HAVE_STRUCT_RANDOM_DATA@
59 int32_t *fptr; /* Front pointer. */
60 int32_t *rptr; /* Rear pointer. */
61 int32_t *state; /* Array of state values. */
62 int rand_type; /* Type of random number generator. */
63 int rand_deg; /* Degree of random number generator. */
64 int rand_sep; /* Distance between front and rear. */
65 int32_t *end_ptr; /* Pointer behind state table. */
69 /* The definition of GL_LINK_WARNING is copied here. */
72 /* Some systems do not define EXIT_*, despite otherwise supporting C89. */
74 # define EXIT_SUCCESS 0
76 /* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
77 with proper operation of xargs. */
79 # define EXIT_FAILURE 1
80 #elif EXIT_FAILURE != 1
82 # define EXIT_FAILURE 1
92 /* Parse a signed decimal integer.
93 Returns the value of the integer. Errors are not detected. */
94 extern long long atoll (const char *string);
96 #elif defined GNULIB_POSIXCHECK
99 (GL_LINK_WARNING ("atoll is unportable - " \
100 "use gnulib module atoll for portability"), \
104 #if @GNULIB_CALLOC_POSIX@
105 # if !@HAVE_CALLOC_POSIX@
107 # define calloc rpl_calloc
108 extern void * calloc (size_t nmemb, size_t size);
110 #elif defined GNULIB_POSIXCHECK
112 # define calloc(n,s) \
113 (GL_LINK_WARNING ("calloc is not POSIX compliant everywhere - " \
114 "use gnulib module calloc-posix for portability"), \
118 #if @GNULIB_GETLOADAVG@
119 # if !@HAVE_DECL_GETLOADAVG@
120 /* Store max(NELEM,3) load average numbers in LOADAVG[].
121 The three numbers are the load average of the last 1 minute, the last 5
122 minutes, and the last 15 minutes, respectively.
123 LOADAVG is an array of NELEM numbers. */
124 extern int getloadavg (double loadavg[], int nelem);
126 #elif defined GNULIB_POSIXCHECK
128 # define getloadavg(l,n) \
129 (GL_LINK_WARNING ("getloadavg is not portable - " \
130 "use gnulib module getloadavg for portability"), \
134 #if @GNULIB_GETSUBOPT@
135 /* Assuming *OPTIONP is a comma separated list of elements of the form
136 "token" or "token=value", getsubopt parses the first of these elements.
137 If the first element refers to a "token" that is member of the given
138 NULL-terminated array of tokens:
139 - It replaces the comma with a NUL byte, updates *OPTIONP to point past
140 the first option and the comma, sets *VALUEP to the value of the
141 element (or NULL if it doesn't contain an "=" sign),
142 - It returns the index of the "token" in the given array of tokens.
143 Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
144 For more details see the POSIX:2001 specification.
145 http://www.opengroup.org/susv3xsh/getsubopt.html */
146 # if !@HAVE_GETSUBOPT@
147 extern int getsubopt (char **optionp, char *const *tokens, char **valuep);
149 #elif defined GNULIB_POSIXCHECK
151 # define getsubopt(o,t,v) \
152 (GL_LINK_WARNING ("getsubopt is unportable - " \
153 "use gnulib module getsubopt for portability"), \
157 #if @GNULIB_MALLOC_POSIX@
158 # if !@HAVE_MALLOC_POSIX@
160 # define malloc rpl_malloc
161 extern void * malloc (size_t size);
163 #elif defined GNULIB_POSIXCHECK
166 (GL_LINK_WARNING ("malloc is not POSIX compliant everywhere - " \
167 "use gnulib module malloc-posix for portability"), \
173 /* Create a unique temporary directory from TEMPLATE.
174 The last six characters of TEMPLATE must be "XXXXXX";
175 they are replaced with a string that makes the directory name unique.
176 Returns TEMPLATE, or a null pointer if it cannot get a unique name.
177 The directory is created mode 700. */
178 extern char * mkdtemp (char * /*template*/);
180 #elif defined GNULIB_POSIXCHECK
182 # define mkdtemp(t) \
183 (GL_LINK_WARNING ("mkdtemp is unportable - " \
184 "use gnulib module mkdtemp for portability"), \
188 #if @GNULIB_MKOSTEMP@
189 # if !@HAVE_MKOSTEMP@
190 /* Create a unique temporary file from TEMPLATE.
191 The last six characters of TEMPLATE must be "XXXXXX";
192 they are replaced with a string that makes the file name unique.
193 The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
194 and O_TEXT, O_BINARY (defined in "binary-io.h").
195 The file is then created, with the specified flags, ensuring it didn't exist
197 The file is created read-write (mask at least 0600 & ~umask), but it may be
198 world-readable and world-writable (mask 0666 & ~umask), depending on the
200 Returns the open file descriptor if successful, otherwise -1 and errno
202 extern int mkostemp (char * /*template*/, int /*flags*/);
204 #elif defined GNULIB_POSIXCHECK
206 # define mkostemp(t,f) \
207 (GL_LINK_WARNING ("mkostemp is unportable - " \
208 "use gnulib module mkostemp for portability"), \
213 # if @REPLACE_MKSTEMP@
214 /* Create a unique temporary file from TEMPLATE.
215 The last six characters of TEMPLATE must be "XXXXXX";
216 they are replaced with a string that makes the file name unique.
217 The file is then created, ensuring it didn't exist before.
218 The file is created read-write (mask at least 0600 & ~umask), but it may be
219 world-readable and world-writable (mask 0666 & ~umask), depending on the
221 Returns the open file descriptor if successful, otherwise -1 and errno
223 # define mkstemp rpl_mkstemp
224 extern int mkstemp (char * /*template*/);
226 /* On MacOS X 10.3, only <unistd.h> declares mkstemp. */
229 #elif defined GNULIB_POSIXCHECK
231 # define mkstemp(t) \
232 (GL_LINK_WARNING ("mkstemp is unportable - " \
233 "use gnulib module mkstemp for portability"), \
238 # if @REPLACE_PUTENV@
240 # define putenv rpl_putenv
241 extern int putenv (char *string);
245 #if @GNULIB_RANDOM_R@
246 # if !@HAVE_RANDOM_R@
249 # define RAND_MAX 2147483647
252 int srandom_r (unsigned int seed, struct random_data *rand_state);
253 int initstate_r (unsigned int seed, char *buf, size_t buf_size,
254 struct random_data *rand_state);
255 int setstate_r (char *arg_state, struct random_data *rand_state);
256 int random_r (struct random_data *buf, int32_t *result);
258 #elif defined GNULIB_POSIXCHECK
260 # define random_r(b,r) \
261 (GL_LINK_WARNING ("random_r is unportable - " \
262 "use gnulib module random_r for portability"), \
265 # define initstate_r(s,b,sz,r) \
266 (GL_LINK_WARNING ("initstate_r is unportable - " \
267 "use gnulib module random_r for portability"), \
268 initstate_r (s,b,sz,r))
270 # define srandom_r(s,r) \
271 (GL_LINK_WARNING ("srandom_r is unportable - " \
272 "use gnulib module random_r for portability"), \
275 # define setstate_r(a,r) \
276 (GL_LINK_WARNING ("setstate_r is unportable - " \
277 "use gnulib module random_r for portability"), \
281 #if @GNULIB_REALLOC_POSIX@
282 # if !@HAVE_REALLOC_POSIX@
284 # define realloc rpl_realloc
285 extern void * realloc (void *ptr, size_t size);
287 #elif defined GNULIB_POSIXCHECK
289 # define realloc(p,s) \
290 (GL_LINK_WARNING ("realloc is not POSIX compliant everywhere - " \
291 "use gnulib module realloc-posix for portability"), \
297 /* Test a user response to a question.
298 Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear. */
299 extern int rpmatch (const char *response);
301 #elif defined GNULIB_POSIXCHECK
303 # define rpmatch(r) \
304 (GL_LINK_WARNING ("rpmatch is unportable - " \
305 "use gnulib module rpmatch for portability"), \
311 /* Set NAME to VALUE in the environment.
312 If REPLACE is nonzero, overwrite an existing value. */
313 extern int setenv (const char *name, const char *value, int replace);
318 # if @REPLACE_STRTOD@
319 # define strtod rpl_strtod
321 # if !@HAVE_STRTOD@ || @REPLACE_STRTOD@
322 /* Parse a double from STRING, updating ENDP if appropriate. */
323 extern double strtod (const char *str, char **endp);
325 #elif defined GNULIB_POSIXCHECK
327 # define strtod(s, e) \
328 (GL_LINK_WARNING ("strtod is unportable - " \
329 "use gnulib module strtod for portability"), \
335 /* Parse a signed integer whose textual representation starts at STRING.
336 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
337 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
339 If ENDPTR is not NULL, the address of the first byte after the integer is
341 Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
343 extern long long strtoll (const char *string, char **endptr, int base);
345 #elif defined GNULIB_POSIXCHECK
347 # define strtoll(s,e,b) \
348 (GL_LINK_WARNING ("strtoll is unportable - " \
349 "use gnulib module strtoll for portability"), \
353 #if @GNULIB_STRTOULL@
354 # if !@HAVE_STRTOULL@
355 /* Parse an unsigned integer whose textual representation starts at STRING.
356 The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
357 it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
359 If ENDPTR is not NULL, the address of the first byte after the integer is
361 Upon overflow, the return value is ULLONG_MAX, and errno is set to
363 extern unsigned long long strtoull (const char *string, char **endptr, int base);
365 #elif defined GNULIB_POSIXCHECK
367 # define strtoull(s,e,b) \
368 (GL_LINK_WARNING ("strtoull is unportable - " \
369 "use gnulib module strtoull for portability"), \
373 #if @GNULIB_UNSETENV@
376 /* On some systems, unsetenv() returns void.
377 This is the case for MacOS X 10.3, FreeBSD 4.8, NetBSD 1.6, OpenBSD 3.4. */
378 # define unsetenv(name) ((unsetenv)(name), 0)
381 /* Remove the variable NAME from the environment. */
382 extern int unsetenv (const char *name);
390 #endif /* _GL_STDLIB_H */
391 #endif /* _GL_STDLIB_H */