1999-05-03 15:29:11 +08:00
/* Function declarations for libiberty.
Written by Cygnus Support , 1994.
The libiberty library provides a number of functions which are
missing on some operating systems . We do not declare those here ,
to avoid conflicts with the system header files on operating
systems that do support those functions . In this file we only
declare those functions which are specific to libiberty . */
# ifndef LIBIBERTY_H
# define LIBIBERTY_H
# ifdef __cplusplus
extern " C " {
# endif
# include "ansidecl.h"
/* Build an argument vector from a string. Allocates memory using
malloc . Use freeargv to free the vector . */
2000-02-23 00:18:13 +08:00
extern char * * buildargv PARAMS ( ( char * ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* Free a vector returned by buildargv. */
extern void freeargv PARAMS ( ( char * * ) ) ;
/* Duplicate an argument vector. Allocates memory using malloc. Use
freeargv to free the vector . */
2000-02-23 00:18:13 +08:00
extern char * * dupargv PARAMS ( ( char * * ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* Return the last component of a path name. Note that we can't use a
prototype here because the parameter is declared inconsistently
across different systems , sometimes as " char * " and sometimes as
" const char * " */
2000-02-23 00:18:13 +08:00
# if defined (__GNU_LIBRARY__ ) || defined (__linux__) || defined (__FreeBSD__) || defined (__OpenBSD__) || defined (__CYGWIN__) || defined (__CYGWIN32__)
1999-05-03 15:29:11 +08:00
extern char * basename PARAMS ( ( const char * ) ) ;
# else
extern char * basename ( ) ;
# endif
/* Concatenate an arbitrary number of strings, up to (char *) NULL.
Allocates memory using xmalloc . */
2000-02-23 00:18:13 +08:00
extern char * concat PARAMS ( ( const char * , . . . ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* Check whether two file descriptors refer to the same file. */
extern int fdmatch PARAMS ( ( int fd1 , int fd2 ) ) ;
2000-02-23 00:18:13 +08:00
/* Get the working directory. The result is cached, so don't call
chdir ( ) between calls to getpwd ( ) . */
extern char * getpwd PARAMS ( ( void ) ) ;
1999-05-03 15:29:11 +08:00
/* Get the amount of time the process has run, in microseconds. */
extern long get_run_time PARAMS ( ( void ) ) ;
/* Choose a temporary directory to use for scratch files. */
2000-02-23 00:18:13 +08:00
extern char * choose_temp_base PARAMS ( ( void ) ) ATTRIBUTE_MALLOC ;
/* Return a temporary file name or NULL if unable to create one. */
extern char * make_temp_file PARAMS ( ( const char * ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* Allocate memory filled with spaces. Allocates using malloc. */
extern const char * spaces PARAMS ( ( int count ) ) ;
/* Return the maximum error number for which strerror will return a
string . */
extern int errno_max PARAMS ( ( void ) ) ;
/* Return the name of an errno value (e.g., strerrno (EINVAL) returns
" EINVAL " ) . */
extern const char * strerrno PARAMS ( ( int ) ) ;
/* Given the name of an errno value, return the value. */
extern int strtoerrno PARAMS ( ( const char * ) ) ;
/* ANSI's strerror(), but more robust. */
extern char * xstrerror PARAMS ( ( int ) ) ;
/* Return the maximum signal number for which strsignal will return a
string . */
extern int signo_max PARAMS ( ( void ) ) ;
/* Return a signal message string for a signal number
( e . g . , strsignal ( SIGHUP ) returns something like " Hangup " ) . */
/* This is commented out as it can conflict with one in system headers.
We still document its existence though . */
/*extern const char *strsignal PARAMS ((int));*/
/* Return the name of a signal number (e.g., strsigno (SIGHUP) returns
" SIGHUP " ) . */
extern const char * strsigno PARAMS ( ( int ) ) ;
/* Given the name of a signal, return its number. */
extern int strtosigno PARAMS ( ( const char * ) ) ;
/* Register a function to be run by xexit. Returns 0 on success. */
extern int xatexit PARAMS ( ( void ( * fn ) ( void ) ) ) ;
/* Exit, calling all the functions registered with xatexit. */
2000-02-23 00:18:13 +08:00
extern void xexit PARAMS ( ( int status ) ) ATTRIBUTE_NORETURN ;
1999-05-03 15:29:11 +08:00
/* Set the program name used by xmalloc. */
extern void xmalloc_set_program_name PARAMS ( ( const char * ) ) ;
/* Allocate memory without fail. If malloc fails, this will print a
message to stderr ( using the name set by xmalloc_set_program_name ,
if any ) and then call xexit . */
# ifdef ANSI_PROTOTYPES
/* Get a definition for size_t. */
# include <stddef.h>
2000-02-23 00:18:13 +08:00
/* Get a definition for va_list. */
# include <stdarg.h>
1999-05-03 15:29:11 +08:00
# endif
2000-02-23 00:18:13 +08:00
extern PTR xmalloc PARAMS ( ( size_t ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
2000-02-23 00:18:13 +08:00
/* Reallocate memory without fail. This works like xmalloc. Note,
realloc type functions are not suitable for attribute malloc since
they may return the same address across multiple calls . */
1999-05-03 15:29:11 +08:00
extern PTR xrealloc PARAMS ( ( PTR , size_t ) ) ;
/* Allocate memory without fail and set it to zero. This works like
xmalloc . */
2000-02-23 00:18:13 +08:00
extern PTR xcalloc PARAMS ( ( size_t , size_t ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* Copy a string into a memory buffer without fail. */
2000-02-23 00:18:13 +08:00
extern char * xstrdup PARAMS ( ( const char * ) ) ATTRIBUTE_MALLOC ;
/* Copy an existing memory buffer to a new memory buffer without fail. */
extern PTR xmemdup PARAMS ( ( const PTR , size_t , size_t ) ) ATTRIBUTE_MALLOC ;
1999-05-03 15:29:11 +08:00
/* hex character manipulation routines */
# define _hex_array_size 256
# define _hex_bad 99
extern char _hex_value [ _hex_array_size ] ;
extern void hex_init PARAMS ( ( void ) ) ;
# define hex_p(c) (hex_value (c) != _hex_bad)
/* If you change this, note well: Some code relies on side effects in
the argument being performed exactly once . */
# define hex_value(c) (_hex_value[(unsigned char) (c)])
/* Definitions used by the pexecute routine. */
# define PEXECUTE_FIRST 1
# define PEXECUTE_LAST 2
# define PEXECUTE_ONE (PEXECUTE_FIRST + PEXECUTE_LAST)
# define PEXECUTE_SEARCH 4
# define PEXECUTE_VERBOSE 8
/* Execute a program. */
extern int pexecute PARAMS ( ( const char * , char * const * , const char * ,
const char * , char * * , char * * , int ) ) ;
/* Wait for pexecute to finish. */
extern int pwait PARAMS ( ( int , int * , int ) ) ;
2000-02-23 00:18:13 +08:00
/* Like sprintf but provides a pointer to malloc'd storage, which must
be freed by the caller . */
extern int asprintf PARAMS ( ( char * * , const char * , . . . ) ) ATTRIBUTE_PRINTF_2 ;
/* Like vsprintf but provides a pointer to malloc'd storage, which
must be freed by the caller . */
extern int vasprintf PARAMS ( ( char * * , const char * , va_list ) )
ATTRIBUTE_PRINTF ( 2 , 0 ) ;
1999-05-03 15:29:11 +08:00
# ifdef __cplusplus
}
# endif
# endif /* ! defined (LIBIBERTY_H) */