binutils-gdb/libiberty
John Ericson ab4f385b3c Deprecate a.out support for NetBSD targets.
As discussed previously, a.out support is now quite deprecated, and in
some cases removed, in both Binutils itself and NetBSD, so this legacy
default makes little sense. `netbsdelf*` and `netbsdaout*` still work
allowing the user to be explicit about there choice. Additionally, the
configure script warns about the change as Nick Clifton requested.

One possible concern was the status of NetBSD on NS32K, where only a.out
was supported. But per [1] NetBSD has removed support, and if it were to
come back, it would be with ELF. The binutils implementation is
therefore marked obsolete, per the instructions in the last message.

With that patch and this one applied, I have confirmed the following:

--target=i686-unknown-netbsd
--target=i686-unknown-netbsdelf
  builds completely

--target=i686-unknown-netbsdaout
  properly fails because target is deprecated.

--target=vax-unknown-netbsdaout builds completely except for gas, where
the target is deprecated.

[1]: https://mail-index.netbsd.org/tech-toolchain/2021/07/19/msg004025.html
---
 bfd/config.bfd                             | 43 +++++++++++++--------
 bfd/configure.ac                           |  5 +--
 binutils/testsuite/binutils-all/nm.exp     |  2 +-
 binutils/testsuite/lib/binutils-common.exp |  7 +---
 config/picflag.m4                          |  4 +-
 gas/configure.tgt                          |  9 +++--
 gas/testsuite/gas/arm/blx-bl-convert.d     |  2 +-
 gas/testsuite/gas/arm/blx-local-thumb.d    |  2 +-
 gas/testsuite/gas/sh/basic.exp             |  2 +-
 gdb/configure.host                         | 34 +++++++----------
 gdb/configure.tgt                          |  2 +-
 gdb/testsuite/gdb.asm/asm-source.exp       |  6 +--
 intl/configure                             |  2 +-
 ld/configure.tgt                           | 44 +++++++++++-----------
 ld/testsuite/ld-arm/arm-elf.exp            |  4 +-
 ld/testsuite/ld-elf/elf.exp                |  2 +-
 ld/testsuite/ld-elf/shared.exp             |  4 +-
 libiberty/configure                        |  4 +-
2021-08-11 13:17:54 +01:00
..
config
testsuite Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
_doprnt.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
.gitignore
acinclude.m4 Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
aclocal.m4 Restore the libiberty component of commit 50ad1254d5. 2021-07-05 16:21:42 +01:00
alloca.c
argv.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
asprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
at-file.texi
atexit.c
basename.c
bcmp.c
bcopy.c
bsearch_r.c
bsearch.c
bzero.c
calloc.c
ChangeLog Update version number and regenerate files 2021-07-03 15:16:48 +01:00
ChangeLog.jit
choose-temp.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
clock.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
concat.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
config.h-vms
config.in
configure Deprecate a.out support for NetBSD targets. 2021-08-11 13:17:54 +01:00
configure.ac Restore the libiberty component of commit 50ad1254d5. 2021-07-05 16:21:42 +01:00
configure.com
copying-lib.texi Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
COPYING.LIB
copysign.c
cp-demangle.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
cp-demangle.h Update libiberty with latest sources from gcc mainline 2021-01-05 12:36:09 +00:00
cp-demint.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
cplus-dem.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
crc32.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
d-demangle.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
dwarfnames.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
dyn-string.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
fdmatch.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ffs.c
fibheap.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
filedescriptor.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
filename_cmp.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
floatformat.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
fnmatch.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
fnmatch.txh
fopen_unlocked.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
functions.texi
gather-docs Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
getcwd.c
getopt1.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
getopt.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
getpagesize.c
getpwd.c
getruntime.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
gettimeofday.c
hashtab.c libiberty: add htab_eq_string 2021-05-07 11:17:11 +01:00
hex.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
index.c
insque.c
lbasename.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
libiberty.texi Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
lrealpath.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
maint-tool Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
make-relative-prefix.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
make-temp-file.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
Makefile.in Restore the libiberty component of commit 50ad1254d5. 2021-07-05 16:21:42 +01:00
makefile.vms
md5.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
memchr.c
memcmp.c
memcpy.c
memmem.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
memmove.c
mempcpy.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
memset.c
mkstemps.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
msdos.c
objalloc.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
obstack.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
obstacks.texi
partition.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-common.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-common.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-djgpp.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-msdos.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-one.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-unix.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pex-win32.c Update libiberty with latest sources from gcc mainline 2021-01-05 12:36:09 +00:00
pexecute.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pexecute.txh
physmem.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
putenv.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
random.c
README
regex.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
rename.c
rindex.c
rust-demangle.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
safe-ctype.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
setenv.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
setproctitle.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
sha1.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
sigsetmask.c
simple-object-coff.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
simple-object-common.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
simple-object-elf.c Update libiberty with latest sources from gcc mainline 2021-01-05 12:36:09 +00:00
simple-object-mach-o.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
simple-object-xcoff.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
simple-object.c Synchronize libiberty sources (and include/demangle.h) with GCC master version 2021-07-03 14:00:33 +01:00
simple-object.txh
snprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
sort.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
spaces.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
splay-tree.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
stack-limit.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
stpcpy.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
stpncpy.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
strcasecmp.c
strchr.c
strdup.c
strerror.c
strncasecmp.c
strncmp.c
strndup.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
strnlen.c
strrchr.c
strsignal.c
strstr.c Update libiberty with latest sources from gcc mainline 2021-01-05 12:36:09 +00:00
strtod.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
strtol.c
strtoll.c
strtoul.c
strtoull.c
strverscmp.c Update libiberty with latest sources from gcc mainline 2021-01-05 12:36:09 +00:00
timeval-utils.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
tmpnam.c
unlink-if-ordinary.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vasprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vfork.c
vfprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vprintf-support.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vprintf-support.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vprintf.c
vsnprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
vsprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
waitpid.c
xasprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
xatexit.c
xexit.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
xmalloc.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
xmemdup.c
xstrdup.c
xstrerror.c
xstrndup.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
xvasprintf.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30

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.