GCC47: Add local modifications
[dragonfly.git] / contrib / gcc-4.7 / include / libiberty.h
1 /* Function declarations for libiberty.
2
3    Copyright 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
4    2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
5    
6    Note - certain prototypes declared in this header file are for
7    functions whoes implementation copyright does not belong to the
8    FSF.  Those prototypes are present in this file for reference
9    purposes only and their presence in this file should not construed
10    as an indication of ownership by the FSF of the implementation of
11    those functions in any way or form whatsoever.
12
13    This program is free software; you can redistribute it and/or modify
14    it under the terms of the GNU General Public License as published by
15    the Free Software Foundation; either version 2, or (at your option)
16    any later version.
17
18    This program is distributed in the hope that it will be useful,
19    but WITHOUT ANY WARRANTY; without even the implied warranty of
20    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21    GNU General Public License for more details.
22
23    You should have received a copy of the GNU General Public License
24    along with this program; if not, write to the Free Software
25    Foundation, Inc., 51 Franklin Street - Fifth Floor,
26    Boston, MA 02110-1301, USA.
27    
28    Written by Cygnus Support, 1994.
29
30    The libiberty library provides a number of functions which are
31    missing on some operating systems.  We do not declare those here,
32    to avoid conflicts with the system header files on operating
33    systems that do support those functions.  In this file we only
34    declare those functions which are specific to libiberty.  */
35
36 #ifndef LIBIBERTY_H
37 #define LIBIBERTY_H
38
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42
43 #include "ansidecl.h"
44
45 /* Get a definition for size_t.  */
46 #include <stddef.h>
47 /* Get a definition for va_list.  */
48 #include <stdarg.h>
49
50 #include <stdio.h>
51
52 /* If the OS supports it, ensure that the supplied stream is setup to
53    avoid any multi-threaded locking.  Otherwise leave the FILE pointer
54    unchanged.  If the stream is NULL do nothing.  */
55
56 extern void unlock_stream (FILE *);
57
58 /* If the OS supports it, ensure that the standard I/O streams, stdin,
59    stdout and stderr are setup to avoid any multi-threaded locking.
60    Otherwise do nothing.  */
61
62 extern void unlock_std_streams (void);
63
64 /* Open and return a FILE pointer.  If the OS supports it, ensure that
65    the stream is setup to avoid any multi-threaded locking.  Otherwise
66    return the FILE pointer unchanged.  */
67
68 extern FILE *fopen_unlocked (const char *, const char *);
69 extern FILE *fdopen_unlocked (int, const char *);
70 extern FILE *freopen_unlocked (const char *, const char *, FILE *);
71
72 /* Build an argument vector from a string.  Allocates memory using
73    malloc.  Use freeargv to free the vector.  */
74
75 extern char **buildargv (const char *) ATTRIBUTE_MALLOC;
76
77 /* Free a vector returned by buildargv.  */
78
79 extern void freeargv (char **);
80
81 /* Duplicate an argument vector. Allocates memory using malloc.  Use
82    freeargv to free the vector.  */
83
84 extern char **dupargv (char **) ATTRIBUTE_MALLOC;
85
86 /* Expand "@file" arguments in argv.  */
87
88 extern void expandargv PARAMS ((int *, char ***));
89
90 /* Write argv to an @-file, inserting necessary quoting.  */
91
92 extern int writeargv PARAMS ((char **, FILE *));
93
94 /* Return the number of elements in argv.  */
95
96 extern int countargv (char**);
97
98 /* Return the last component of a path name.  Note that we can't use a
99    prototype here because the parameter is declared inconsistently
100    across different systems, sometimes as "char *" and sometimes as
101    "const char *" */
102
103 /* HAVE_DECL_* is a three-state macro: undefined, 0 or 1.  If it is
104    undefined, we haven't run the autoconf check so provide the
105    declaration without arguments.  If it is 0, we checked and failed
106    to find the declaration so provide a fully prototyped one.  If it
107    is 1, we found it so don't provide any declaration at all.  */
108 #if !HAVE_DECL_BASENAME
109 #if defined (__GNU_LIBRARY__ ) \
110  || defined (__linux__) \
111  || defined (__DragonFly__) \
112  || defined (__FreeBSD__) \
113  || defined (__OpenBSD__) \
114  || defined (__NetBSD__) \
115  || defined (__CYGWIN__) \
116  || defined (__CYGWIN32__) \
117  || defined (__MINGW32__) \
118  || defined (HAVE_DECL_BASENAME)
119 extern char *basename (const char *);
120 #else
121 /* Do not allow basename to be used if there is no prototype seen.  We
122    either need to use the above prototype or have one from
123    autoconf which would result in HAVE_DECL_BASENAME being set.  */
124 #define basename basename_cannot_be_used_without_a_prototype
125 #endif
126 #endif
127
128 /* A well-defined basename () that is always compiled in.  */
129
130 extern const char *lbasename (const char *);
131
132 /* Same, but assumes DOS semantics (drive name, backslash is also a
133    dir separator) regardless of host.  */
134
135 extern const char *dos_lbasename (const char *);
136
137 /* Same, but assumes Unix semantics (absolute paths always start with
138    a slash, only forward slash is accepted as dir separator)
139    regardless of host.  */
140
141 extern const char *unix_lbasename (const char *);
142
143 /* A well-defined realpath () that is always compiled in.  */
144
145 extern char *lrealpath (const char *);
146
147 /* Concatenate an arbitrary number of strings.  You must pass NULL as
148    the last argument of this function, to terminate the list of
149    strings.  Allocates memory using xmalloc.  */
150
151 extern char *concat (const char *, ...) ATTRIBUTE_MALLOC ATTRIBUTE_SENTINEL;
152
153 /* Concatenate an arbitrary number of strings.  You must pass NULL as
154    the last argument of this function, to terminate the list of
155    strings.  Allocates memory using xmalloc.  The first argument is
156    not one of the strings to be concatenated, but if not NULL is a
157    pointer to be freed after the new string is created, similar to the
158    way xrealloc works.  */
159
160 extern char *reconcat (char *, const char *, ...) ATTRIBUTE_MALLOC ATTRIBUTE_SENTINEL;
161
162 /* Determine the length of concatenating an arbitrary number of
163    strings.  You must pass NULL as the last argument of this function,
164    to terminate the list of strings.  */
165
166 extern unsigned long concat_length (const char *, ...) ATTRIBUTE_SENTINEL;
167
168 /* Concatenate an arbitrary number of strings into a SUPPLIED area of
169    memory.  You must pass NULL as the last argument of this function,
170    to terminate the list of strings.  The supplied memory is assumed
171    to be large enough.  */
172
173 extern char *concat_copy (char *, const char *, ...) ATTRIBUTE_SENTINEL;
174
175 /* Concatenate an arbitrary number of strings into a GLOBAL area of
176    memory.  You must pass NULL as the last argument of this function,
177    to terminate the list of strings.  The supplied memory is assumed
178    to be large enough.  */
179
180 extern char *concat_copy2 (const char *, ...) ATTRIBUTE_SENTINEL;
181
182 /* This is the global area used by concat_copy2.  */
183
184 extern char *libiberty_concat_ptr;
185
186 /* Concatenate an arbitrary number of strings.  You must pass NULL as
187    the last argument of this function, to terminate the list of
188    strings.  Allocates memory using alloca.  The arguments are
189    evaluated twice!  */
190 #define ACONCAT(ACONCAT_PARAMS) \
191   (libiberty_concat_ptr = (char *) alloca (concat_length ACONCAT_PARAMS + 1), \
192    concat_copy2 ACONCAT_PARAMS)
193
194 /* Check whether two file descriptors refer to the same file.  */
195
196 extern int fdmatch (int fd1, int fd2);
197
198 /* Return the position of the first bit set in the argument.  */
199 /* Prototypes vary from system to system, so we only provide a
200    prototype on systems where we know that we need it.  */
201 #if defined (HAVE_DECL_FFS) && !HAVE_DECL_FFS
202 extern int ffs(int);
203 #endif
204
205 /* Get the working directory.  The result is cached, so don't call
206    chdir() between calls to getpwd().  */
207
208 extern char * getpwd (void);
209
210 /* Get the current time.  */
211 /* Prototypes vary from system to system, so we only provide a
212    prototype on systems where we know that we need it.  */
213 #ifdef __MINGW32__
214 /* Forward declaration to avoid #include <sys/time.h>.   */
215 struct timeval;
216 extern int gettimeofday (struct timeval *, void *); 
217 #endif
218
219 /* Get the amount of time the process has run, in microseconds.  */
220
221 extern long get_run_time (void);
222
223 /* Generate a relocated path to some installation directory.  Allocates
224    return value using malloc.  */
225
226 extern char *make_relative_prefix (const char *, const char *,
227                                    const char *) ATTRIBUTE_MALLOC;
228
229 /* Generate a relocated path to some installation directory without
230    attempting to follow any soft links.  Allocates
231    return value using malloc.  */
232
233 extern char *make_relative_prefix_ignore_links (const char *, const char *,
234                                                 const char *) ATTRIBUTE_MALLOC;
235
236 /* Choose a temporary directory to use for scratch files.  */
237
238 extern char *choose_temp_base (void) ATTRIBUTE_MALLOC;
239
240 /* Return a temporary file name or NULL if unable to create one.  */
241
242 extern char *make_temp_file (const char *) ATTRIBUTE_MALLOC;
243
244 /* Remove a link to a file unless it is special. */
245
246 extern int unlink_if_ordinary (const char *);
247
248 /* Allocate memory filled with spaces.  Allocates using malloc.  */
249
250 extern const char *spaces (int count);
251
252 /* Return the maximum error number for which strerror will return a
253    string.  */
254
255 extern int errno_max (void);
256
257 /* Return the name of an errno value (e.g., strerrno (EINVAL) returns
258    "EINVAL").  */
259
260 extern const char *strerrno (int);
261
262 /* Given the name of an errno value, return the value.  */
263
264 extern int strtoerrno (const char *);
265
266 /* ANSI's strerror(), but more robust.  */
267
268 extern char *xstrerror (int);
269
270 /* Return the maximum signal number for which strsignal will return a
271    string.  */
272
273 extern int signo_max (void);
274
275 /* Return a signal message string for a signal number
276    (e.g., strsignal (SIGHUP) returns something like "Hangup").  */
277 /* This is commented out as it can conflict with one in system headers.
278    We still document its existence though.  */
279
280 /*extern const char *strsignal (int);*/
281
282 /* Return the name of a signal number (e.g., strsigno (SIGHUP) returns
283    "SIGHUP").  */
284
285 extern const char *strsigno (int);
286
287 /* Given the name of a signal, return its number.  */
288
289 extern int strtosigno (const char *);
290
291 /* Register a function to be run by xexit.  Returns 0 on success.  */
292
293 extern int xatexit (void (*fn) (void));
294
295 /* Exit, calling all the functions registered with xatexit.  */
296
297 extern void xexit (int status) ATTRIBUTE_NORETURN;
298
299 /* Set the program name used by xmalloc.  */
300
301 extern void xmalloc_set_program_name (const char *);
302
303 /* Report an allocation failure.  */
304 extern void xmalloc_failed (size_t) ATTRIBUTE_NORETURN;
305
306 /* Allocate memory without fail.  If malloc fails, this will print a
307    message to stderr (using the name set by xmalloc_set_program_name,
308    if any) and then call xexit.  */
309
310 extern void *xmalloc (size_t) ATTRIBUTE_MALLOC;
311
312 /* Reallocate memory without fail.  This works like xmalloc.  Note,
313    realloc type functions are not suitable for attribute malloc since
314    they may return the same address across multiple calls. */
315
316 extern void *xrealloc (void *, size_t);
317
318 /* Allocate memory without fail and set it to zero.  This works like
319    xmalloc.  */
320
321 extern void *xcalloc (size_t, size_t) ATTRIBUTE_MALLOC;
322
323 /* Copy a string into a memory buffer without fail.  */
324
325 extern char *xstrdup (const char *) ATTRIBUTE_MALLOC;
326
327 /* Copy at most N characters from string into a buffer without fail.  */
328
329 extern char *xstrndup (const char *, size_t) ATTRIBUTE_MALLOC;
330
331 /* Copy an existing memory buffer to a new memory buffer without fail.  */
332
333 extern void *xmemdup (const void *, size_t, size_t) ATTRIBUTE_MALLOC;
334
335 /* Physical memory routines.  Return values are in BYTES.  */
336 extern double physmem_total (void);
337 extern double physmem_available (void);
338
339 /* Compute the 32-bit CRC of a block of memory.  */
340 extern unsigned int xcrc32 (const unsigned char *, int, unsigned int);
341
342 /* These macros provide a K&R/C89/C++-friendly way of allocating structures
343    with nice encapsulation.  The XDELETE*() macros are technically
344    superfluous, but provided here for symmetry.  Using them consistently
345    makes it easier to update client code to use different allocators such
346    as new/delete and new[]/delete[].  */
347
348 /* Scalar allocators.  */
349
350 #define XALLOCA(T)              ((T *) alloca (sizeof (T)))
351 #define XNEW(T)                 ((T *) xmalloc (sizeof (T)))
352 #define XCNEW(T)                ((T *) xcalloc (1, sizeof (T)))
353 #define XDUP(T, P)              ((T *) xmemdup ((P), sizeof (T), sizeof (T)))
354 #define XDELETE(P)              free ((void*) (P))
355
356 /* Array allocators.  */
357
358 #define XALLOCAVEC(T, N)        ((T *) alloca (sizeof (T) * (N)))
359 #define XNEWVEC(T, N)           ((T *) xmalloc (sizeof (T) * (N)))
360 #define XCNEWVEC(T, N)          ((T *) xcalloc ((N), sizeof (T)))
361 #define XDUPVEC(T, P, N)        ((T *) xmemdup ((P), sizeof (T) * (N), sizeof (T) * (N)))
362 #define XRESIZEVEC(T, P, N)     ((T *) xrealloc ((void *) (P), sizeof (T) * (N)))
363 #define XDELETEVEC(P)           free ((void*) (P))
364
365 /* Allocators for variable-sized structures and raw buffers.  */
366
367 #define XALLOCAVAR(T, S)        ((T *) alloca ((S)))
368 #define XNEWVAR(T, S)           ((T *) xmalloc ((S)))
369 #define XCNEWVAR(T, S)          ((T *) xcalloc (1, (S)))
370 #define XDUPVAR(T, P, S1, S2)   ((T *) xmemdup ((P), (S1), (S2)))
371 #define XRESIZEVAR(T, P, S)     ((T *) xrealloc ((P), (S)))
372
373 /* Type-safe obstack allocator.  */
374
375 #define XOBNEW(O, T)            ((T *) obstack_alloc ((O), sizeof (T)))
376 #define XOBNEWVEC(O, T, N)      ((T *) obstack_alloc ((O), sizeof (T) * (N)))
377 #define XOBNEWVAR(O, T, S)      ((T *) obstack_alloc ((O), (S)))
378 #define XOBFINISH(O, T)         ((T) obstack_finish ((O)))
379
380 /* hex character manipulation routines */
381
382 #define _hex_array_size 256
383 #define _hex_bad        99
384 extern const unsigned char _hex_value[_hex_array_size];
385 extern void hex_init (void);
386 #define hex_p(c)        (hex_value (c) != _hex_bad)
387 /* If you change this, note well: Some code relies on side effects in
388    the argument being performed exactly once.  */
389 #define hex_value(c)    ((unsigned int) _hex_value[(unsigned char) (c)])
390
391 /* Flags for pex_init.  These are bits to be or'ed together.  */
392
393 /* Record subprocess times, if possible.  */
394 #define PEX_RECORD_TIMES        0x1
395
396 /* Use pipes for communication between processes, if possible.  */
397 #define PEX_USE_PIPES           0x2
398
399 /* Save files used for communication between processes.  */
400 #define PEX_SAVE_TEMPS          0x4
401
402 /* Prepare to execute one or more programs, with standard output of
403    each program fed to standard input of the next.
404    FLAGS        As above.
405    PNAME        The name of the program to report in error messages.
406    TEMPBASE     A base name to use for temporary files; may be NULL to
407                 use a random name.
408    Returns NULL on error.  */
409
410 extern struct pex_obj *pex_init (int flags, const char *pname,
411                                  const char *tempbase);
412
413 /* Flags for pex_run.  These are bits to be or'ed together.  */
414
415 /* Last program in pipeline.  Standard output of program goes to
416    OUTNAME, or, if OUTNAME is NULL, to standard output of caller.  Do
417    not set this if you want to call pex_read_output.  After this is
418    set, pex_run may no longer be called with the same struct
419    pex_obj.  */
420 #define PEX_LAST                0x1
421
422 /* Search for program in executable search path.  */
423 #define PEX_SEARCH              0x2
424
425 /* OUTNAME is a suffix.  */
426 #define PEX_SUFFIX              0x4
427
428 /* Send program's standard error to standard output.  */
429 #define PEX_STDERR_TO_STDOUT    0x8
430
431 /* Input file should be opened in binary mode.  This flag is ignored
432    on Unix.  */
433 #define PEX_BINARY_INPUT        0x10
434
435 /* Output file should be opened in binary mode.  This flag is ignored
436    on Unix.  For proper behaviour PEX_BINARY_INPUT and
437    PEX_BINARY_OUTPUT have to match appropriately--i.e., a call using
438    PEX_BINARY_OUTPUT should be followed by a call using
439    PEX_BINARY_INPUT.  */
440 #define PEX_BINARY_OUTPUT       0x20
441
442 /* Capture stderr to a pipe.  The output can be read by
443    calling pex_read_err and reading from the returned
444    FILE object.  This flag may be specified only for
445    the last program in a pipeline.  
446
447    This flag is supported only on Unix and Windows.  */
448 #define PEX_STDERR_TO_PIPE      0x40
449
450 /* Capture stderr in binary mode.  This flag is ignored
451    on Unix.  */
452 #define PEX_BINARY_ERROR        0x80
453
454
455 /* Execute one program.  Returns NULL on success.  On error returns an
456    error string (typically just the name of a system call); the error
457    string is statically allocated.
458
459    OBJ          Returned by pex_init.
460
461    FLAGS        As above.
462
463    EXECUTABLE   The program to execute.
464
465    ARGV         NULL terminated array of arguments to pass to the program.
466
467    OUTNAME      Sets the output file name as follows:
468
469                 PEX_SUFFIX set (OUTNAME may not be NULL):
470                   TEMPBASE parameter to pex_init not NULL:
471                     Output file name is the concatenation of TEMPBASE
472                     and OUTNAME.
473                   TEMPBASE is NULL:
474                     Output file name is a random file name ending in
475                     OUTNAME.
476                 PEX_SUFFIX not set:
477                   OUTNAME not NULL:
478                     Output file name is OUTNAME.
479                   OUTNAME NULL, TEMPBASE not NULL:
480                     Output file name is randomly chosen using
481                     TEMPBASE.
482                   OUTNAME NULL, TEMPBASE NULL:
483                     Output file name is randomly chosen.
484
485                 If PEX_LAST is not set, the output file name is the
486                 name to use for a temporary file holding stdout, if
487                 any (there will not be a file if PEX_USE_PIPES is set
488                 and the system supports pipes).  If a file is used, it
489                 will be removed when no longer needed unless
490                 PEX_SAVE_TEMPS is set.
491
492                 If PEX_LAST is set, and OUTNAME is not NULL, standard
493                 output is written to the output file name.  The file
494                 will not be removed.  If PEX_LAST and PEX_SUFFIX are
495                 both set, TEMPBASE may not be NULL.
496
497    ERRNAME      If not NULL, this is the name of a file to which
498                 standard error is written.  If NULL, standard error of
499                 the program is standard error of the caller.
500
501    ERR          On an error return, *ERR is set to an errno value, or
502                 to 0 if there is no relevant errno.
503 */
504
505 extern const char *pex_run (struct pex_obj *obj, int flags,
506                             const char *executable, char * const *argv,
507                             const char *outname, const char *errname,
508                             int *err);
509
510 /* As for pex_run (), but takes an extra parameter to enable the
511    environment for the child process to be specified.
512
513    ENV          The environment for the child process, specified as
514                 an array of character pointers.  Each element of the
515                 array should point to a string of the form VAR=VALUE,
516                 with the exception of the last element which must be
517                 a null pointer.
518 */
519
520 extern const char *pex_run_in_environment (struct pex_obj *obj, int flags,
521                                            const char *executable,
522                                            char * const *argv,
523                                            char * const *env,
524                                            const char *outname,
525                                            const char *errname, int *err);
526
527 /* Return a stream for a temporary file to pass to the first program
528    in the pipeline as input.  The file name is chosen as for pex_run.
529    pex_run closes the file automatically; don't close it yourself.  */
530
531 extern FILE *pex_input_file (struct pex_obj *obj, int flags,
532                              const char *in_name);
533
534 /* Return a stream for a pipe connected to the standard input of the
535    first program in the pipeline.  You must have passed
536    `PEX_USE_PIPES' to `pex_init'.  Close the returned stream
537    yourself.  */
538
539 extern FILE *pex_input_pipe (struct pex_obj *obj, int binary);
540
541 /* Read the standard output of the last program to be executed.
542    pex_run can not be called after this.  BINARY should be non-zero if
543    the file should be opened in binary mode; this is ignored on Unix.
544    Returns NULL on error.  Don't call fclose on the returned FILE; it
545    will be closed by pex_free.  */
546
547 extern FILE *pex_read_output (struct pex_obj *, int binary);
548
549 /* Read the standard error of the last program to be executed.
550    pex_run can not be called after this.  BINARY should be non-zero if
551    the file should be opened in binary mode; this is ignored on Unix.
552    Returns NULL on error.  Don't call fclose on the returned FILE; it
553    will be closed by pex_free.  */
554
555 extern FILE *pex_read_err (struct pex_obj *, int binary);
556
557 /* Return exit status of all programs in VECTOR.  COUNT indicates the
558    size of VECTOR.  The status codes in the vector are in the order of
559    the calls to pex_run.  Returns 0 on error, 1 on success.  */
560
561 extern int pex_get_status (struct pex_obj *, int count, int *vector);
562
563 /* Return times of all programs in VECTOR.  COUNT indicates the size
564    of VECTOR.  struct pex_time is really just struct timeval, but that
565    is not portable to all systems.  Returns 0 on error, 1 on
566    success.  */
567
568 struct pex_time
569 {
570   unsigned long user_seconds;
571   unsigned long user_microseconds;
572   unsigned long system_seconds;
573   unsigned long system_microseconds;
574 };
575
576 extern int pex_get_times (struct pex_obj *, int count,
577                           struct pex_time *vector);
578
579 /* Clean up a pex_obj.  If you have not called pex_get_times or
580    pex_get_status, this will try to kill the subprocesses.  */
581
582 extern void pex_free (struct pex_obj *);
583
584 /* Just execute one program.  Return value is as for pex_run.
585    FLAGS        Combination of PEX_SEARCH and PEX_STDERR_TO_STDOUT.
586    EXECUTABLE   As for pex_run.
587    ARGV         As for pex_run.
588    PNAME        As for pex_init.
589    OUTNAME      As for pex_run when PEX_LAST is set.
590    ERRNAME      As for pex_run.
591    STATUS       Set to exit status on success.
592    ERR          As for pex_run.
593 */
594
595 extern const char *pex_one (int flags, const char *executable,
596                             char * const *argv, const char *pname,
597                             const char *outname, const char *errname,
598                             int *status, int *err);
599
600 /* pexecute and pwait are the old pexecute interface, still here for
601    backward compatibility.  Don't use these for new code.  Instead,
602    use pex_init/pex_run/pex_get_status/pex_free, or pex_one.  */
603
604 /* Definitions used by the pexecute routine.  */
605
606 #define PEXECUTE_FIRST   1
607 #define PEXECUTE_LAST    2
608 #define PEXECUTE_ONE     (PEXECUTE_FIRST + PEXECUTE_LAST)
609 #define PEXECUTE_SEARCH  4
610 #define PEXECUTE_VERBOSE 8
611
612 /* Execute a program.  */
613
614 extern int pexecute (const char *, char * const *, const char *,
615                      const char *, char **, char **, int);
616
617 /* Wait for pexecute to finish.  */
618
619 extern int pwait (int, int *, int);
620
621 #if !HAVE_DECL_ASPRINTF
622 /* Like sprintf but provides a pointer to malloc'd storage, which must
623    be freed by the caller.  */
624
625 extern int asprintf (char **, const char *, ...) ATTRIBUTE_PRINTF_2;
626 #endif
627
628 #if !HAVE_DECL_VASPRINTF
629 /* Like vsprintf but provides a pointer to malloc'd storage, which
630    must be freed by the caller.  */
631
632 extern int vasprintf (char **, const char *, va_list) ATTRIBUTE_PRINTF(2,0);
633 #endif
634
635 #if defined(HAVE_DECL_SNPRINTF) && !HAVE_DECL_SNPRINTF
636 /* Like sprintf but prints at most N characters.  */
637 extern int snprintf (char *, size_t, const char *, ...) ATTRIBUTE_PRINTF_3;
638 #endif
639
640 #if defined(HAVE_DECL_VSNPRINTF) && !HAVE_DECL_VSNPRINTF
641 /* Like vsprintf but prints at most N characters.  */
642 extern int vsnprintf (char *, size_t, const char *, va_list) ATTRIBUTE_PRINTF(3,0);
643 #endif
644
645 #if defined(HAVE_DECL_STRVERSCMP) && !HAVE_DECL_STRVERSCMP
646 /* Compare version strings.  */
647 extern int strverscmp (const char *, const char *);
648 #endif
649
650 /* Set the title of a process */
651 extern void setproctitle (const char *name, ...);
652
653 /* Increase stack limit if possible.  */
654 extern void stack_limit_increase (unsigned long);
655
656 #define ARRAY_SIZE(a) (sizeof (a) / sizeof ((a)[0]))
657
658 /* Drastically simplified alloca configurator.  If we're using GCC,
659    we use __builtin_alloca; otherwise we use the C alloca.  The C
660    alloca is always available.  You can override GCC by defining
661    USE_C_ALLOCA yourself.  The canonical autoconf macro C_ALLOCA is
662    also set/unset as it is often used to indicate whether code needs
663    to call alloca(0).  */
664 extern void *C_alloca (size_t) ATTRIBUTE_MALLOC;
665 #undef alloca
666 #if GCC_VERSION >= 2000 && !defined USE_C_ALLOCA
667 # define alloca(x) __builtin_alloca(x)
668 # undef C_ALLOCA
669 # define ASTRDUP(X) \
670   (__extension__ ({ const char *const libiberty_optr = (X); \
671    const unsigned long libiberty_len = strlen (libiberty_optr) + 1; \
672    char *const libiberty_nptr = (char *const) alloca (libiberty_len); \
673    (char *) memcpy (libiberty_nptr, libiberty_optr, libiberty_len); }))
674 #else
675 # define alloca(x) C_alloca(x)
676 # undef USE_C_ALLOCA
677 # define USE_C_ALLOCA 1
678 # undef C_ALLOCA
679 # define C_ALLOCA 1
680 extern const char *libiberty_optr;
681 extern char *libiberty_nptr;
682 extern unsigned long libiberty_len;
683 # define ASTRDUP(X) \
684   (libiberty_optr = (X), \
685    libiberty_len = strlen (libiberty_optr) + 1, \
686    libiberty_nptr = (char *) alloca (libiberty_len), \
687    (char *) memcpy (libiberty_nptr, libiberty_optr, libiberty_len))
688 #endif
689
690 #ifdef __cplusplus
691 }
692 #endif
693
694
695 #endif /* ! defined (LIBIBERTY_H) */