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) */