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