1 /* Function declarations for libiberty.
2 Written by Cygnus Support, 1994.
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. */
15 /* Build an argument vector from a string. Allocates memory using
16 malloc. Use freeargv to free the vector. */
18 extern char **buildargv
PARAMS ((char *));
20 /* Free a vector returned by buildargv. */
22 extern void freeargv
PARAMS ((char **));
24 /* Return the last component of a path name. */
26 extern char *basename
PARAMS ((char *));
28 /* Concatenate an arbitrary number of strings, up to (char *) NULL.
29 Allocates memory using xmalloc. */
31 extern char *concat
PARAMS ((const char *, ...));
33 /* Check whether two file descriptors refer to the same file. */
35 extern int fdmatch
PARAMS ((int fd1
, int fd2
));
37 /* Get the amount of time the process has run, in microseconds. */
39 extern long get_run_time
PARAMS ((void));
41 /* Allocate memory filled with spaces. Allocates using malloc. */
43 extern const char *spaces
PARAMS ((int count
));
45 /* Return the maximum error number for which strerror will return a
48 extern int errno_max
PARAMS ((void));
50 /* Return the name of an errno value (e.g., strerrno (EINVAL) returns
53 extern const char *strerrno
PARAMS ((int));
55 /* Given the name of an errno value, return the value. */
57 extern int strtoerrno
PARAMS ((const char *));
59 /* Return the maximum signal number for which strsignal will return a
62 extern int signo_max
PARAMS ((void));
64 /* Return a signal message string for a signal number
65 (e.g., strsignal (SIGHUP) returns something like "Hangup"). */
66 /* This is commented out as it can conflict with one in system headers.
67 We still document its existence though. */
69 /*extern const char *strsignal PARAMS ((int));*/
71 /* Return the name of a signal number (e.g., strsigno (SIGHUP) returns
74 extern const char *strsigno
PARAMS ((int));
76 /* Given the name of a signal, return its number. */
78 extern int strtosigno
PARAMS ((const char *));
80 /* Register a function to be run by xexit. Returns 0 on success. */
82 extern int xatexit
PARAMS ((void (*fn
) (void)));
84 /* Exit, calling all the functions registered with xatexit. */
87 extern void xexit
PARAMS ((int status
));
89 typedef void libiberty_voidfn
PARAMS ((int status
));
90 __volatile__ libiberty_voidfn xexit
;
93 /* Set the program name used by xmalloc. */
95 extern void xmalloc_set_program_name
PARAMS ((const char *));
97 /* Allocate memory without fail. If malloc fails, this will print a
98 message to stderr (using the name set by xmalloc_set_program_name,
99 if any) and then call xexit.
101 FIXME: We do not declare the parameter type (size_t) in order to
102 avoid conflicts with other declarations of xmalloc that exist in
103 programs which use libiberty. */
105 extern PTR
xmalloc ();
107 /* Reallocate memory without fail. This works like xmalloc.
109 FIXME: We do not declare the parameter types for the same reason as
112 extern PTR
xrealloc ();
114 /* hex character manipulation routines */
116 #define _hex_array_size 256
118 extern char _hex_value
[_hex_array_size
];
119 extern void hex_init
PARAMS ((void));
120 #define hex_p(c) (hex_value (c) == _hex_bad)
121 /* If you change this, note well: Some code relies on side effects in
122 the argument being performed exactly once. */
123 #define hex_value(c) (_hex_value[(unsigned char) (c)])
125 #endif /* ! defined (LIBIBERTY_H) */