binutils-gdb/libiberty
Nick Clifton af03af8f55 Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling.
This patch addresses the multitude of bug reports about resource exhaustion
in libiberty's name demangling code.  It adds a limit to the amount of
recursion that is allowed, before an error is triggered.  It also adds a
new demangling option to disable this limit.  (The limit is enabled by
default).

	PR 87681
	PR 87675
	PR 87636
	PR 87335
libiberty * cp-demangle.h (struct d_info): Add recursion_limit field.
	* cp-demangle.c (d_function_type): If the recursion limit is
	enabled and reached, return with a failure result.
        (d_demangle_callback): If the recursion limit is enabled, check
	for a mangled string that is so long that there is not enough
	stack space for the local arrays.
        * cplus-dem.c (struct work): Add recursion_level field.
	(demangle_nested_args): If the recursion limit is enabled and
	reached, return with a failure result.

include	* demangle.h (DMGL_RECURSE_LIMIT): Define.
        (DEMANGLE_RECURSION_LIMIT): Prototype.

binutuils * addr2line.c (demangle_flags): New static variable.
        (long_options): Add --recurse-limit and --no-recurse-limit.
        (translate_address): Pass demangle_flags to bfd_demangle.
        (main): Handle --recurse-limit and --no-recurse-limit options.
        * cxxfilt.c (flags): Add DMGL_RECURSE_LIMIT.
        (long_options): Add --recurse-limit and --no-recurse-limit.
        (main): Handle new options.
        * dlltool.c (gen_def_file): Include DMGL_RECURSE_LIMIT in flags
        passed to cplus_demangle.
        * nm.c (demangle_flags): New static variable.
        (long_options): Add --recurse-limit and --no-recurse-limit.
        (main): Handle new options.
        * objdump.c (demangle_flags): New static variable.
        (usage): Add --recurse-limit and --no-recurse-limit.
        (long_options): Likewise.
        (objdump_print_symname): Pass demangle_flags to bfd_demangle.
        (disassemble_section): Likewise.
        (dump_dymbols): Likewise.
        (main): Handle new options.
        * prdbg.c (demangle_flags): New static variable.
        (tg_variable): Pass demangle_flags to demangler.
        (tg_start_function): Likewise.
        * stabs.c (demangle_flags): New static variable.
        (stab_demangle_template): Pass demangle_flags to demangler.
        (stab_demangle_v3_argtypes): Likewise.
        (stab_demangle_v3_arg): Likewise.
	* doc/binutuls.texi: Document new command line options.
	* NEWS: Mention the new feature.
        * testsuite/config/default.exp (CXXFILT): Define if not already
        defined.
        (CXXFILTFLAGS): Likewise.
        * testsuite/binutils-all/cxxfilt.exp: New file.  Runs a few
        simple tests of the cxxfilt program.
2018-12-07 11:32:55 +00:00
..
config
testsuite Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
.gitignore bfd/binutils/gas/gprof/ld/libiberty/opcodes: add .gitignore 2010-12-09 09:03:18 +00:00
COPYING.LIB Update the address and phone number of the FSF organization. 2005-05-10 15:33:34 +00:00
ChangeLog Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
ChangeLog.jit Sync libiberty from GCC 2014-11-17 03:30:13 +01:00
Makefile.in Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
README * README: Mention changes to Makefile.in and functions.texi. 2009-11-25 04:35:01 +00:00
_doprnt.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
aclocal.m4 merge from gcc 2011-12-20 19:02:08 +00:00
alloca.c merge from gcc 2005-05-24 21:01:33 +00:00
argv.c * argv.c (expandargv): Fix memory leak for expanded arguments. 2018-05-31 10:12:00 +01:00
asprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
at-file.texi * at-file.texi: Fix typo. 2005-10-07 14:20:47 +00:00
atexit.c merge from gcc 2005-03-27 05:28:42 +00:00
basename.c merge from gcc 2005-04-16 01:05:05 +00:00
bcmp.c merge from gcc 2005-04-03 04:41:10 +00:00
bcopy.c merge from gcc 2006-10-26 04:18:42 +00:00
bsearch.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
bzero.c merge from gcc 2005-04-03 04:41:10 +00:00
calloc.c merge from gcc 2005-03-27 05:28:42 +00:00
choose-temp.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
clock.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
concat.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
config.h-vms merge from gcc 2009-09-15 15:21:58 +00:00
config.in Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
configure Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
configure.ac Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
configure.com 2009-09-01 Tristan Gingold <gingold@adacore.com> 2009-09-01 13:16:53 +00:00
copying-lib.texi Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
copysign.c merge from gcc 2005-03-27 05:28:42 +00:00
cp-demangle.c Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
cp-demangle.h Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
cp-demint.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
cplus-dem.c Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
crc32.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
d-demangle.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
dwarfnames.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
dyn-string.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
fdmatch.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
ffs.c merge from gcc 2005-03-28 02:09:01 +00:00
fibheap.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
filename_cmp.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
floatformat.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
fnmatch.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
fnmatch.txh libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
fopen_unlocked.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
functions.texi libiberty: {count,dup,write}argv: constify argv input slightly 2016-01-05 15:25:13 -05:00
gather-docs Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
getcwd.c merge from gcc 2005-03-28 02:09:01 +00:00
getopt.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
getopt1.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
getpagesize.c merge from gcc 2005-03-28 02:09:01 +00:00
getpwd.c merge from gcc 2005-05-24 21:01:33 +00:00
getruntime.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
gettimeofday.c merge from gcc 2005-03-31 17:03:35 +00:00
hashtab.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
hex.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
index.c merge from gcc 2005-04-02 20:20:01 +00:00
insque.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
lbasename.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
libiberty.texi Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
lrealpath.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
maint-tool Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
make-relative-prefix.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
make-temp-file.c Copy from GCC: Add linker_output as prefix for LTO temps (PR lto/86548). 2018-08-01 14:23:10 +01:00
makefile.vms 2013-07-09 Tristan Gingold <gingold@adacore.com> 2013-07-09 07:44:25 +00:00
md5.c Improve boostrap-ubsan config (PR bootstrap/64914). 2018-05-31 10:13:26 +01:00
memchr.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
memcmp.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
memcpy.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
memmem.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
memmove.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
mempcpy.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
memset.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
mkstemps.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
msdos.c
objalloc.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
obstack.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
obstacks.texi Modify obstack.[hc] to avoid having to include other gnulib files 2015-11-09 15:18:35 +10:30
partition.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-common.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-common.h Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-djgpp.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-msdos.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-one.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pex-unix.c Synchronize libiberty with gcc and add --no-recruse-limit option to tools that support name demangling. 2018-12-07 11:32:55 +00:00
pex-win32.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pexecute.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
pexecute.txh libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
physmem.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
putenv.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
random.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
regex.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
rename.c merge from gcc 2005-03-28 05:07:08 +00:00
rindex.c merge from gcc 2005-04-02 20:20:01 +00:00
rust-demangle.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
safe-ctype.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
setenv.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
setproctitle.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
sha1.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
sigsetmask.c Fix gnu11 fallout on Solaris 10+ 2014-11-05 15:07:38 +01:00
simple-object-coff.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
simple-object-common.h Resync libiberty sources with master version in GCC repository. 2018-04-17 13:53:38 +01:00
simple-object-elf.c Fix GDB build using mingw.org's MinGW 2018-07-19 16:54:06 +03:00
simple-object-mach-o.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
simple-object-xcoff.c Resync libiberty sources with master version in GCC repository. 2018-04-17 13:53:38 +01:00
simple-object.c libiberty: Sync with GCC 2018-06-18 09:34:12 -04:00
simple-object.txh libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
snprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
sort.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
spaces.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
splay-tree.c include: 2018-05-28 Bernd Edlinger <bernd.edlinger@hotmail.de> 2018-05-31 10:17:13 +01:00
stack-limit.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
stpcpy.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
stpncpy.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
strcasecmp.c merge from gcc 2005-03-28 05:07:08 +00:00
strchr.c merge from gcc 2005-03-28 05:07:08 +00:00
strdup.c merge from gcc 2005-03-28 05:07:08 +00:00
strerror.c strerror.c: Do not declare sys_nerr or sys_errlist if already macros 2015-01-19 16:29:07 +01:00
strncasecmp.c merge from gcc 2005-03-28 02:09:01 +00:00
strncmp.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
strndup.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
strnlen.c merge from gcc 2012-10-10 03:11:33 +00:00
strrchr.c merge from gcc 2005-03-28 02:09:01 +00:00
strsignal.c merge from gcc 2011-06-13 16:37:46 +00:00
strstr.c merge from gcc 2005-04-02 20:20:01 +00:00
strtod.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
strtol.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
strtoll.c Sync libiberty from GCC 2014-11-17 03:30:13 +01:00
strtoul.c merge from gcc 2005-03-28 02:09:01 +00:00
strtoull.c Sync libiberty from GCC 2014-11-17 03:30:13 +01:00
strverscmp.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
timeval-utils.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
tmpnam.c merge from gcc 2005-03-28 02:09:01 +00:00
unlink-if-ordinary.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vasprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vfork.c merge from gcc 2005-03-28 02:09:01 +00:00
vfprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vprintf-support.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vprintf-support.h Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vprintf.c libiberty: documentation markup and order fixes. 2011-02-03 07:23:59 +00:00
vsnprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
vsprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
waitpid.c Make libiberty/waitpid.c compile without warnings on MinGW 2017-05-31 09:37:48 +03:00
xasprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
xatexit.c merge from gcc 2005-04-16 01:05:05 +00:00
xexit.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
xmalloc.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
xmemdup.c Don't needlessly clear xmemdup allocated memory. 2016-05-31 20:34:47 +09:30
xstrdup.c * xstrdup.c: Include <sys/types.h> after "config.h". 2008-10-08 16:53:29 +00:00
xstrerror.c merge from gcc 2005-05-24 21:01:33 +00:00
xstrndup.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00
xvasprintf.c Update the libiberty sources with the latest patches found in the master sources. 2018-01-10 13:57:48 +00:00

README

This directory contains the -liberty library of free software.
It is a collection of subroutines used by various GNU programs.
Current members include:

	getopt -- get options from command line
	obstack -- stacks of arbitrarily-sized objects
	strerror -- error message strings corresponding to errno
	strtol -- string-to-long conversion
	strtoul -- string-to-unsigned-long conversion

We expect many of the GNU subroutines that are floating around to
eventually arrive here.

The library must be configured from the top source directory.  Don't
try to run configure in this directory.  Follow the configuration
instructions in ../README.

Please report bugs to "gcc-bugs@gcc.gnu.org" and send fixes to
"gcc-patches@gcc.gnu.org".  Thank you.

ADDING A NEW FILE
=================

There are two sets of files:  Those that are "required" will be
included in the library for all configurations, while those
that are "optional" will be included in the library only if "needed."

To add a new required file, edit Makefile.in to add the source file
name to CFILES and the object file to REQUIRED_OFILES.

To add a new optional file, it must provide a single function, and the
name of the function must be the same as the name of the file.

    * Add the source file name to CFILES in Makefile.in and the object
      file to CONFIGURED_OFILES.

    * Add the function to name to the funcs shell variable in
      configure.ac.

    * Add the function to the AC_CHECK_FUNCS lists just after the
      setting of the funcs shell variable.  These AC_CHECK_FUNCS calls
      are never executed; they are there to make autoheader work
      better.

    * Consider the special cases of building libiberty; as of this
      writing, the special cases are newlib and VxWorks.  If a
      particular special case provides the function, you do not need
      to do anything.  If it does not provide the function, add the
      object file to LIBOBJS, and add the function name to the case
      controlling whether to define HAVE_func.

Finally, in the build directory of libiberty, configure with
"--enable-maintainer-mode", run "make maint-deps" to update
Makefile.in, and run 'make stamp-functions' to regenerate
functions.texi.

The optional file you've added (e.g. getcwd.c) should compile and work
on all hosts where it is needed.  It does not have to work or even
compile on hosts where it is not needed.

ADDING A NEW CONFIGURATION
==========================

On most hosts you should be able to use the scheme for automatically
figuring out which files are needed.  In that case, you probably
don't need a special Makefile stub for that configuration.

If the fully automatic scheme doesn't work, you may be able to get
by with defining EXTRA_OFILES in your Makefile stub.  This is
a list of object file names that should be treated as required
for this configuration - they will be included in libiberty.a,
regardless of whatever might be in the C library.