1/* Function declarations for libiberty. 2 Written by Cygnus Support, 1994. 3 4 The libiberty library provides a number of functions which are 5 missing on some operating systems. We do not declare those here, 6 to avoid conflicts with the system header files on operating 7 systems that do support those functions. In this file we only 8 declare those functions which are specific to libiberty. */ 9 10#ifndef LIBIBERTY_H 11#define LIBIBERTY_H 12 13#ifdef __cplusplus 14extern "C" { 15#endif 16 17#include "ansidecl.h" 18 19/* Build an argument vector from a string. Allocates memory using 20 malloc. Use freeargv to free the vector. */ 21 22extern char **buildargv PARAMS ((char *)); 23 24/* Free a vector returned by buildargv. */ 25 26extern void freeargv PARAMS ((char **)); 27 28/* Duplicate an argument vector. Allocates memory using malloc. Use 29 freeargv to free the vector. */ 30 31extern char **dupargv PARAMS ((char **)); 32 33 34/* Return the last component of a path name. Note that we can't use a 35 prototype here because the parameter is declared inconsistently 36 across different systems, sometimes as "char *" and sometimes as 37 "const char *" */ 38 39#if defined (__GNU_LIBRARY__ ) || defined (__linux__) || defined (__FreeBSD__) || defined (__CYGWIN__) || defined (__CYGWIN32__) 40extern char *basename PARAMS ((const char *)); 41#else 42extern char *basename (); 43#endif 44 45/* Concatenate an arbitrary number of strings, up to (char *) NULL. 46 Allocates memory using xmalloc. */ 47 48extern char *concat PARAMS ((const char *, ...)); 49 50/* Check whether two file descriptors refer to the same file. */ 51 52extern int fdmatch PARAMS ((int fd1, int fd2)); 53 54/* Get the amount of time the process has run, in microseconds. */ 55 56extern long get_run_time PARAMS ((void)); 57 58/* Choose a temporary directory to use for scratch files. */ 59 60extern char *choose_temp_base PARAMS ((void)); 61 62/* Allocate memory filled with spaces. Allocates using malloc. */ 63 64extern const char *spaces PARAMS ((int count)); 65 66/* Return the maximum error number for which strerror will return a 67 string. */ 68 69extern int errno_max PARAMS ((void)); 70 71/* Return the name of an errno value (e.g., strerrno (EINVAL) returns 72 "EINVAL"). */ 73 74extern const char *strerrno PARAMS ((int)); 75 76/* Given the name of an errno value, return the value. */ 77 78extern int strtoerrno PARAMS ((const char *)); 79 80/* ANSI's strerror(), but more robust. */ 81 82extern char *xstrerror PARAMS ((int)); 83 84/* Return the maximum signal number for which strsignal will return a 85 string. */ 86 87extern int signo_max PARAMS ((void)); 88 89/* Return a signal message string for a signal number 90 (e.g., strsignal (SIGHUP) returns something like "Hangup"). */ 91/* This is commented out as it can conflict with one in system headers. 92 We still document its existence though. */ 93 94/*extern const char *strsignal PARAMS ((int));*/ 95 96/* Return the name of a signal number (e.g., strsigno (SIGHUP) returns 97 "SIGHUP"). */ 98 99extern const char *strsigno PARAMS ((int)); 100 101/* Given the name of a signal, return its number. */ 102 103extern int strtosigno PARAMS ((const char *)); 104 105/* Register a function to be run by xexit. Returns 0 on success. */ 106 107extern int xatexit PARAMS ((void (*fn) (void))); 108 109/* Exit, calling all the functions registered with xatexit. */ 110 111#ifndef __GNUC__ 112extern void xexit PARAMS ((int status)); 113#else 114void xexit PARAMS ((int status)) __attribute__ ((noreturn)); 115#endif 116 117/* Set the program name used by xmalloc. */ 118 119extern void xmalloc_set_program_name PARAMS ((const char *)); 120 121/* Allocate memory without fail. If malloc fails, this will print a 122 message to stderr (using the name set by xmalloc_set_program_name, 123 if any) and then call xexit. */ 124 125#ifdef ANSI_PROTOTYPES 126/* Get a definition for size_t. */ 127#include <stddef.h> 128#endif 129extern PTR xmalloc PARAMS ((size_t)); 130 131/* Reallocate memory without fail. This works like xmalloc. 132 133 FIXME: We do not declare the parameter types for the same reason as 134 xmalloc. */ 135 136extern PTR xrealloc PARAMS ((PTR, size_t)); 137 138/* Allocate memory without fail and set it to zero. This works like 139 xmalloc. */ 140 141extern PTR xcalloc PARAMS ((size_t, size_t)); 142 143/* Copy a string into a memory buffer without fail. */ 144 145extern char *xstrdup PARAMS ((const char *)); 146 147/* hex character manipulation routines */ 148 149#define _hex_array_size 256 150#define _hex_bad 99 151extern char _hex_value[_hex_array_size]; 152extern void hex_init PARAMS ((void)); 153#define hex_p(c) (hex_value (c) != _hex_bad) 154/* If you change this, note well: Some code relies on side effects in 155 the argument being performed exactly once. */ 156#define hex_value(c) (_hex_value[(unsigned char) (c)]) 157 158/* Definitions used by the pexecute routine. */ 159 160#define PEXECUTE_FIRST 1 161#define PEXECUTE_LAST 2 162#define PEXECUTE_ONE (PEXECUTE_FIRST + PEXECUTE_LAST) 163#define PEXECUTE_SEARCH 4 164#define PEXECUTE_VERBOSE 8 165 166/* Execute a program. */ 167 168extern int pexecute PARAMS ((const char *, char * const *, const char *, 169 const char *, char **, char **, int)); 170 171/* Wait for pexecute to finish. */ 172 173extern int pwait PARAMS ((int, int *, int)); 174 175#ifdef __cplusplus 176} 177#endif 178 179 180#endif /* ! defined (LIBIBERTY_H) */ 181