libiberty.h
上传用户:nvosite88
上传日期:2007-01-17
资源大小:4983k
文件大小:8k
- /* Function declarations for libiberty.
- Copyright 2001 Free Software Foundation, Inc.
-
- Note - certain prototypes declared in this header file are for
- functions whoes implementation copyright does not belong to the
- FSF. Those prototypes are present in this file for reference
- purposes only and their presence in this file should not construed
- as an indication of ownership by the FSF of the implementation of
- those functions in any way or form whatsoever.
- This program is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2, or (at your option)
- any later version.
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
- You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
-
- 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"
- #ifdef ANSI_PROTOTYPES
- /* Get a definition for size_t. */
- #include <stddef.h>
- /* Get a definition for va_list. */
- #include <stdarg.h>
- #endif
- /* Build an argument vector from a string. Allocates memory using
- malloc. Use freeargv to free the vector. */
- extern char **buildargv PARAMS ((char *)) ATTRIBUTE_MALLOC;
- /* 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. */
- extern char **dupargv PARAMS ((char **)) ATTRIBUTE_MALLOC;
- /* 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 *" */
- /* HAVE_DECL_* is a three-state macro: undefined, 0 or 1. If it is
- undefined, we haven't run the autoconf check so provide the
- declaration without arguments. If it is 0, we checked and failed
- to find the declaration so provide a fully prototyped one. If it
- is 1, we found it so don't provide any declaration at all. */
- #if defined (__GNU_LIBRARY__ ) || defined (__linux__) || defined (__FreeBSD__) || defined (__OpenBSD__) || defined (__CYGWIN__) || defined (__CYGWIN32__) || (defined (HAVE_DECL_BASENAME) && !HAVE_DECL_BASENAME)
- extern char *basename PARAMS ((const char *));
- #else
- # if !defined (HAVE_DECL_BASENAME)
- extern char *basename ();
- # endif
- #endif
- /* Concatenate an arbitrary number of strings, up to (char *) NULL.
- Allocates memory using xmalloc. */
- extern char *concat PARAMS ((const char *, ...)) ATTRIBUTE_MALLOC;
- /* Check whether two file descriptors refer to the same file. */
- extern int fdmatch PARAMS ((int fd1, int fd2));
- /* Get the working directory. The result is cached, so don't call
- chdir() between calls to getpwd(). */
- extern char * getpwd PARAMS ((void));
- /* 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. */
- 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;
- /* 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. */
- extern void xexit PARAMS ((int status)) ATTRIBUTE_NORETURN;
- /* Set the program name used by xmalloc. */
- extern void xmalloc_set_program_name PARAMS ((const char *));
- /* Report an allocation failure. */
- extern void xmalloc_failed PARAMS ((size_t)) ATTRIBUTE_NORETURN;
- /* 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. */
- extern PTR xmalloc PARAMS ((size_t)) ATTRIBUTE_MALLOC;
- /* 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. */
- extern PTR xrealloc PARAMS ((PTR, size_t));
- /* Allocate memory without fail and set it to zero. This works like
- xmalloc. */
- extern PTR xcalloc PARAMS ((size_t, size_t)) ATTRIBUTE_MALLOC;
- /* Copy a string into a memory buffer without fail. */
- 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;
- /* 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));
- /* 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);
- #define ARRAY_SIZE(a) (sizeof (a) / sizeof ((a)[0]))
- #ifdef __cplusplus
- }
- #endif
- #endif /* ! defined (LIBIBERTY_H) */