diff options
| author | jdp <jdp@FreeBSD.org> | 1998-09-06 22:57:45 +0000 |
|---|---|---|
| committer | jdp <jdp@FreeBSD.org> | 1998-09-06 22:57:45 +0000 |
| commit | effee09f856ecc81feb91290459a2cda49d20287 (patch) | |
| tree | 5c46ac1ee102130859f788aeb927e8086985cfe7 /contrib/binutils/bfd/doc | |
| parent | 31cb88078db5bdc51eb451c5a61e31a426fb8ae6 (diff) | |
| download | FreeBSD-src-effee09f856ecc81feb91290459a2cda49d20287.zip FreeBSD-src-effee09f856ecc81feb91290459a2cda49d20287.tar.gz | |
Import GNU binutils-2.9.1. This will break things for a few minutes
until I've made the commits to resolve the conflicts.
Submitted by: Doug Rabson <dfr>
Diffstat (limited to 'contrib/binutils/bfd/doc')
24 files changed, 1931 insertions, 685 deletions
diff --git a/contrib/binutils/bfd/doc/ChangeLog b/contrib/binutils/bfd/doc/ChangeLog index 7e46efc..871299c 100644 --- a/contrib/binutils/bfd/doc/ChangeLog +++ b/contrib/binutils/bfd/doc/ChangeLog @@ -1,3 +1,78 @@ +Mon Apr 6 14:06:55 1998 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.am (STAGESTUFF): Remove variable. + (CLEANFILES): Don't remove $(STAGESTUFF). + (DISTCLEANFILES, MAINTAINERCLEANFILES): New variables. + * Makefile.in: Rebuild. + +Fri Mar 27 16:25:25 1998 Ian Lance Taylor <ian@cygnus.com> + + * chew.c (skip_white_and_starts): Remove unused declaration. + (skip_white_and_stars): Add casts to avoid warnings. + (skip_trailing_newlines, paramstuff, courierize): Likewise. + (bulletize, do_fancy_stuff, iscommand): Likewise. + (kill_bogus_lines, nextword, main): Likewise. + (manglecomments): Comment out. + (outputdots, kill_bogus_lines): Remove unused local variables. + (perform, compile): Likewise. + (courierize): Fully parenthesize expression. + (copy_past_newline): Declare return value. + (print): Change printf format string. + (main): Call usage for an unrecognized option. + +Fri Feb 13 14:37:14 1998 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.am (AUTOMAKE_OPTIONS): Define. + * Makefile.in: Rebuild. + +Mon Jan 26 15:38:36 1998 Andreas Schwab <schwab@issan.informatik.uni-dortmund.de> + + * doc.str (bodytext): Don't output @* at the end. + * chew.c (kill_bogus_lines): Make sure that a period at the + beginning is recognized. + (indent): Don't put indentation at the end. + (copy_past_newline): Expand tabs. + * Makefile.am (s-reloc, s-syms): Depend on doc.str. + * Makefile.in: Rebuild. + +Wed Oct 1 14:41:28 1997 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.am (libbfd.h): Don't use cpu-h8300.c, cpu-i960.c, or + elfcode.h as input files; they don't contribute anything. + * Makefile.in: Rebuild. + +Fri Aug 15 04:55:15 1997 Doug Evans <dje@canuck.cygnus.com> + + * Makefile.am (libbfd.h, libcoff.h): Invoke $(MKDOC) as ./$(MKDOC). + * Makefile.in: Rebuild. + +Fri Aug 1 12:59:58 1997 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.am (CC_FOR_BUILD): Don't set explicitly. + * Makefile.in: Rebuild. + +Thu Jul 31 20:00:12 1997 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.am: New file, based on old Makefile.in. + * Makefile.in: Now built with automake. + +Tue Jul 22 14:44:00 1997 Robert Hoehne <robert.hoehne@Mathematik.TU-Chemnitz.DE> + + * Makefile.in: Change stamp-* files to s-* files. Use bfdt.texi + rather than bfd.texi. + (DOCFILES): Change bfd.texi to bfdt.texi. + * bfd.texinfo: Include bfdt.texi, not bfd.texi. + +Mon Jun 16 15:33:15 1997 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.in (CC, CFLAGS): Substitute from configure script. + From Jeff Makey <jeff@cts.com>. + +Tue Apr 15 12:37:41 1997 Ian Lance Taylor <ian@cygnus.com> + + * Makefile.in (install-info): Use mkinstalldirs to build + $(infodir). + Tue Apr 8 12:49:46 1997 Ian Lance Taylor <ian@cygnus.com> * Makefile.in (install-info): Permit info files to be in srcdir. diff --git a/contrib/binutils/bfd/doc/Makefile.am b/contrib/binutils/bfd/doc/Makefile.am new file mode 100644 index 0000000..7588273 --- /dev/null +++ b/contrib/binutils/bfd/doc/Makefile.am @@ -0,0 +1,248 @@ +## Process this file with automake to generate Makefile.in + +AUTOMAKE_OPTIONS = cygnus + +DOCFILES = aoutx.texi archive.texi archures.texi \ + bfdt.texi cache.texi coffcode.texi \ + core.texi elf.texi elfcode.texi format.texi libbfd.texi \ + opncls.texi reloc.texi section.texi \ + syms.texi targets.texi init.texi hash.texi linker.texi + +PROTOS = archive.p archures.p bfd.p \ + core.p format.p \ + libbfd.p opncls.p reloc.p \ + section.p syms.p targets.p \ + format.p core.p init.p + +IPROTOS = cache.ip libbfd.ip reloc.ip init.ip archures.ip coffcode.ip + +# SRCDOC, SRCPROT, SRCIPROT only used to sidestep Sun Make bug in interaction +# between VPATH and suffix rules. If you use GNU Make, perhaps other Makes, +# you don't need these three: +SRCDOC = $(srcdir)/../aoutx.h $(srcdir)/../archive.c \ + $(srcdir)/../archures.c $(srcdir)/../bfd.c \ + $(srcdir)/../cache.c $(srcdir)/../coffcode.h \ + $(srcdir)/../corefile.c $(srcdir)/../elf.c \ + $(srcdir)/../elfcode.h $(srcdir)/../format.c \ + $(srcdir)/../libbfd.c $(srcdir)/../opncls.c \ + $(srcdir)/../reloc.c $(srcdir)/../section.c \ + $(srcdir)/../syms.c $(srcdir)/../targets.c \ + $(srcdir)/../hash.c $(srcdir)/../linker.c + +SRCPROT = $(srcdir)/../archive.c $(srcdir)/../archures.c \ + $(srcdir)/../bfd.c $(srcdir)/../coffcode.h $(srcdir)/../corefile.c \ + $(srcdir)/../format.c $(srcdir)/../libbfd.c \ + $(srcdir)/../opncls.c $(srcdir)/../reloc.c \ + $(srcdir)/../section.c $(srcdir)/../syms.c \ + $(srcdir)/../targets.c $(srcdir)/../init.c + +SRCIPROT = $(srcdir)/../cache.c $(srcdir)/../libbfd.c \ + $(srcdir)/../reloc.c $(srcdir)/../cpu-h8300.c \ + $(srcdir)/../cpu-i960.c $(srcdir)/../archures.c \ + $(srcdir)/../init.c + +TEXIDIR = $(srcdir)/../../texinfo/fsf + +info_TEXINFOS = bfd.texinfo + +MKDOC = chew$(EXEEXT_FOR_BUILD) + +$(MKDOC): chew.o + $(CC_FOR_BUILD) -o $(MKDOC) chew.o $(LOADLIBES) $(LDFLAGS) + +chew.o: chew.c + $(CC_FOR_BUILD) -c -I.. -I$(srcdir)/.. -I$(srcdir)/../../include $(H_CFLAGS) $(CFLAGS) $(srcdir)/chew.c + +protos: libbfd.h libcoff.h bfd.h + +bfd.info bfd.dvi: $(DOCFILES) bfdsumm.texi bfd.texinfo + +# We can't replace these rules with an implicit rule, because +# makes without VPATH support couldn't find the .h files in `..'. + +# We use s-XXX targets so that we can distribute the info files, +# and permit people to rebuild them, without requiring the makeinfo +# program. If somebody tries to rebuild info, but none of the .texi +# files have changed, then this Makefile will build chew, and will +# build all of the stamp files, but will not actually have to rebuild +# bfd.info. + +s-aoutx: $(MKDOC) $(srcdir)/../aoutx.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../aoutx.h >aoutx.tmp + $(srcdir)/../../move-if-change aoutx.tmp aoutx.texi + touch s-aoutx +aoutx.texi: s-aoutx + +s-archive: $(MKDOC) $(srcdir)/../archive.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../archive.c >archive.tmp + $(srcdir)/../../move-if-change archive.tmp archive.texi + touch s-archive +archive.texi: s-archive + +s-archures: $(MKDOC) $(srcdir)/../archures.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../archures.c >archures.tmp + $(srcdir)/../../move-if-change archures.tmp archures.texi + touch s-archures +archures.texi: s-archures + +# We use bfdt.texi, rather than bfd.texi, to avoid conflicting with +# bfd.texinfo on an 8.3 filesystem. +s-bfd: $(MKDOC) $(srcdir)/../bfd.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../bfd.c >bfd.tmp + $(srcdir)/../../move-if-change bfd.tmp bfdt.texi + touch s-bfd +bfdt.texi: s-bfd + +s-cache: $(MKDOC) $(srcdir)/../cache.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../cache.c >cache.tmp + $(srcdir)/../../move-if-change cache.tmp cache.texi + touch s-cache +cache.texi: s-cache + +s-coffcode: $(MKDOC) $(srcdir)/../coffcode.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../coffcode.h >coffcode.tmp + $(srcdir)/../../move-if-change coffcode.tmp coffcode.texi + touch s-coffcode +coffcode.texi: s-coffcode + +s-core: $(MKDOC) $(srcdir)/../corefile.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../corefile.c >core.tmp + $(srcdir)/../../move-if-change core.tmp core.texi + touch s-core +core.texi: s-core + +s-elf: $(MKDOC) $(srcdir)/../elf.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elf.c >elf.tmp + $(srcdir)/../../move-if-change elf.tmp elf.texi + touch s-elf +elf.texi: s-elf + +s-elfcode: $(MKDOC) $(srcdir)/../elfcode.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elfcode.h >elfcode.tmp + $(srcdir)/../../move-if-change elfcode.tmp elfcode.texi + touch s-elfcode +elfcode.texi: s-elfcode + +s-format: $(MKDOC) $(srcdir)/../format.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../format.c >format.tmp + $(srcdir)/../../move-if-change format.tmp format.texi + touch s-format +format.texi: s-format + +s-libbfd: $(MKDOC) $(srcdir)/../libbfd.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../libbfd.c >libbfd.tmp + $(srcdir)/../../move-if-change libbfd.tmp libbfd.texi + touch s-libbfd +libbfd.texi: s-libbfd + +s-opncls: $(MKDOC) $(srcdir)/../opncls.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../opncls.c >opncls.tmp + $(srcdir)/../../move-if-change opncls.tmp opncls.texi + touch s-opncls +opncls.texi: s-opncls + +s-reloc: $(MKDOC) $(srcdir)/../reloc.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../reloc.c >reloc.tmp + $(srcdir)/../../move-if-change reloc.tmp reloc.texi + touch s-reloc +reloc.texi: s-reloc + +s-section: $(MKDOC) $(srcdir)/../section.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../section.c >section.tmp + $(srcdir)/../../move-if-change section.tmp section.texi + touch s-section +section.texi: s-section + +s-syms: $(MKDOC) $(srcdir)/../syms.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../syms.c >syms.tmp + $(srcdir)/../../move-if-change syms.tmp syms.texi + touch s-syms +syms.texi: s-syms + +s-targets: $(MKDOC) $(srcdir)/../targets.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../targets.c >targets.tmp + $(srcdir)/../../move-if-change targets.tmp targets.texi + touch s-targets +targets.texi: s-targets + +s-init: $(MKDOC) $(srcdir)/../init.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../init.c >init.tmp + $(srcdir)/../../move-if-change init.tmp init.texi + touch s-init +init.texi: s-init + +s-hash: $(MKDOC) $(srcdir)/../hash.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../hash.c >hash.tmp + $(srcdir)/../../move-if-change hash.tmp hash.texi + touch s-hash +hash.texi: s-hash + +s-linker: $(MKDOC) $(srcdir)/../linker.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../linker.c >linker.tmp + $(srcdir)/../../move-if-change linker.tmp linker.texi + touch s-linker +linker.texi: s-linker + +libbfd.h: $(srcdir)/../libbfd-in.h \ + $(srcdir)/../init.c \ + $(srcdir)/../libbfd.c \ + $(srcdir)/../cache.c \ + $(srcdir)/../reloc.c \ + $(srcdir)/../archures.c \ + $(srcdir)/proto.str \ + $(MKDOC) + cat $(srcdir)/../libbfd-in.h >libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../init.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../libbfd.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../cache.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../reloc.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../archures.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../elf.c >>libbfd.h + +libcoff.h: $(srcdir)/../libcoff-in.h \ + $(srcdir)/../coffcode.h \ + $(srcdir)/proto.str \ + $(MKDOC) + cat $(srcdir)/../libcoff-in.h >libcoff.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../coffcode.h >>libcoff.h + +bfd.h: $(srcdir)/../bfd-in.h \ + $(srcdir)/../init.c \ + $(srcdir)/../opncls.c \ + $(srcdir)/../libbfd.c \ + $(srcdir)/../section.c \ + $(srcdir)/../archures.c \ + $(srcdir)/../reloc.c \ + $(srcdir)/../syms.c \ + $(srcdir)/../bfd.c \ + $(srcdir)/../archive.c \ + $(srcdir)/../corefile.c \ + $(srcdir)/../targets.c \ + $(srcdir)/../format.c \ + $(srcdir)/proto.str \ + $(MKDOC) + cat $(srcdir)/../bfd-in.h >bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../init.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../opncls.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../libbfd.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../section.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archures.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../reloc.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../syms.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../bfd.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archive.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../corefile.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../targets.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../format.c >>bfd.h + echo "#ifdef __cplusplus" >>bfd.h + echo "}" >>bfd.h + echo "#endif" >>bfd.h + echo "#endif" >>bfd.h + +MOSTLYCLEANFILES = $(MKDOC) *.o + +CLEANFILES = s-* *.p *.ip + +DISTCLEANFILES = bfd.?? bfd.??? bfd.h libbfd.h libcoff.h texput.log + +MAINTAINERCLEANFILES = $(DOCFILES) diff --git a/contrib/binutils/bfd/doc/Makefile.in b/contrib/binutils/bfd/doc/Makefile.in index b7ecd8e..cc1a092 100644 --- a/contrib/binutils/bfd/doc/Makefile.in +++ b/contrib/binutils/bfd/doc/Makefile.in @@ -1,66 +1,98 @@ -# -# Makefile -# Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation -# -# This file 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 of the License, or -# (at your option) any later version. -# +# Makefile.in generated automatically by automake 1.2e from Makefile.am + +# Copyright (C) 1994, 1995, 1996, 1997, 1998 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + # 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. */ -# +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. -VPATH = @srcdir@ -srcdir = @srcdir@ -prefix = @prefix@ +SHELL = @SHELL@ +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +prefix = @prefix@ exec_prefix = @exec_prefix@ -bindir = @bindir@ -libdir = @libdir@ +bindir = @bindir@ +sbindir = @sbindir@ +libexecdir = @libexecdir@ datadir = @datadir@ -mandir = @mandir@ -man1dir = $(mandir)/man1 -man2dir = $(mandir)/man2 -man3dir = $(mandir)/man3 -man4dir = $(mandir)/man4 -man5dir = $(mandir)/man5 -man6dir = $(mandir)/man6 -man7dir = $(mandir)/man7 -man8dir = $(mandir)/man8 -man9dir = $(mandir)/man9 +sysconfdir = @sysconfdir@ +sharedstatedir = @sharedstatedir@ +localstatedir = @localstatedir@ +libdir = @libdir@ infodir = @infodir@ +mandir = @mandir@ includedir = @includedir@ +oldincludedir = /usr/include + +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ -MKDOC=./chew -SHELL = /bin/sh +top_builddir = .. + +ACLOCAL = @ACLOCAL@ +AUTOCONF = @AUTOCONF@ +AUTOMAKE = @AUTOMAKE@ +AUTOHEADER = @AUTOHEADER@ INSTALL = @INSTALL@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_DATA = @INSTALL_DATA@ - -MAKEINFO = makeinfo -TEXI2DVI = texi2dvi -CFLAGS = -g - -CC_FOR_BUILD = $(CC) - -#### Host, target, and site specific Makefile fragments come in here. -### - -.c.o: - $(CC) -c -I.. -I$(srcdir)/.. -I$(srcdir)/../../include $(H_CFLAGS) $(CFLAGS) $< +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +transform = @program_transform_name@ + +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_alias = @build_alias@ +build_triplet = @build@ +host_alias = @host_alias@ +host_triplet = @host@ +target_alias = @target_alias@ +target_triplet = @target@ +AR = @AR@ +BFD_HOST_64BIT_LONG = @BFD_HOST_64BIT_LONG@ +BFD_HOST_64_BIT = @BFD_HOST_64_BIT@ +BFD_HOST_64_BIT_DEFINED = @BFD_HOST_64_BIT_DEFINED@ +BFD_HOST_U_64_BIT = @BFD_HOST_U_64_BIT@ +CC = @CC@ +CC_FOR_BUILD = @CC_FOR_BUILD@ +COREFILE = @COREFILE@ +COREFLAG = @COREFLAG@ +EXEEXT = @EXEEXT@ +EXEEXT_FOR_BUILD = @EXEEXT_FOR_BUILD@ +HDEFINES = @HDEFINES@ +LD = @LD@ +LIBTOOL = @LIBTOOL@ +LN_S = @LN_S@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +NM = @NM@ +PACKAGE = @PACKAGE@ +RANLIB = @RANLIB@ +TDEFINES = @TDEFINES@ +VERSION = @VERSION@ +all_backends = @all_backends@ +bfd_backends = @bfd_backends@ +bfd_machines = @bfd_machines@ +tdefaults = @tdefaults@ +wordsize = @wordsize@ + +AUTOMAKE_OPTIONS = cygnus DOCFILES = aoutx.texi archive.texi archures.texi \ - bfd.texi cache.texi coffcode.texi \ + bfdt.texi cache.texi coffcode.texi \ core.texi elf.texi elfcode.texi format.texi libbfd.texi \ opncls.texi reloc.texi section.texi \ syms.texi targets.texi init.texi hash.texi linker.texi @@ -98,27 +130,213 @@ SRCIPROT = $(srcdir)/../cache.c $(srcdir)/../libbfd.c \ $(srcdir)/../cpu-i960.c $(srcdir)/../archures.c \ $(srcdir)/../init.c -STAGESTUFF = $(DOCFILES) *.info* - TEXIDIR = $(srcdir)/../../texinfo/fsf -all install: +info_TEXINFOS = bfd.texinfo + +MKDOC = chew$(EXEEXT_FOR_BUILD) + +MOSTLYCLEANFILES = $(MKDOC) *.o -info: bfd.info +CLEANFILES = s-* *.p *.ip -dvi: bfd.dvi +DISTCLEANFILES = bfd.?? bfd.??? bfd.h libbfd.h libcoff.h texput.log -install-info: info - if [ -r bfd.info ]; then \ - dir=.; \ - else \ - dir=$(srcdir); \ - fi; \ - for i in `cd $$dir; echo *.info*`; do \ - $(INSTALL_DATA) $$dir/$$i $(infodir)/$$i; \ +MAINTAINERCLEANFILES = $(DOCFILES) +mkinstalldirs = $(SHELL) $(top_srcdir)/../mkinstalldirs +CONFIG_HEADER = ../config.h +CONFIG_CLEAN_FILES = +TEXI2DVI = `if test -f $(top_srcdir)/../texinfo/util/texi2dvi; then echo $(top_srcdir)/../texinfo/util/texi2dvi; else echo texi2dvi; fi` +TEXINFO_TEX = $(top_srcdir)/../texinfo/texinfo.tex +INFO_DEPS = bfd.info +DVIS = bfd.dvi +TEXINFOS = bfd.texinfo +DIST_COMMON = ChangeLog Makefile.am Makefile.in + + +DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST) + +TAR = tar +GZIP = --best +default: all + +.SUFFIXES: +.SUFFIXES: .dvi .info .ps .texi .texinfo +$(srcdir)/Makefile.in: @MAINT@ Makefile.am $(top_srcdir)/configure.in $(ACLOCAL_M4) + cd $(top_srcdir) && $(AUTOMAKE) --cygnus doc/Makefile + +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + cd $(top_builddir) \ + && CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status + + +bfd.info: bfd.texinfo +bfd.dvi: bfd.texinfo + + +DVIPS = dvips + +.texi.info: + @rm -f $@ $@-[0-9] $@-[0-9][0-9] + $(MAKEINFO) -I $(srcdir) $< + +.texi.dvi: + TEXINPUTS=$(top_srcdir)/../texinfo:$$TEXINPUTS \ + MAKEINFO='$(MAKEINFO) -I $(srcdir)' $(TEXI2DVI) $< + +.texi: + @rm -f $@ $@-[0-9] $@-[0-9][0-9] + $(MAKEINFO) -I $(srcdir) $< + +.texinfo.info: + @rm -f $@ $@-[0-9] $@-[0-9][0-9] + $(MAKEINFO) -I $(srcdir) $< + +.texinfo: + @rm -f $@ $@-[0-9] $@-[0-9][0-9] + $(MAKEINFO) -I $(srcdir) $< + +.texinfo.dvi: + TEXINPUTS=$(top_srcdir)/../texinfo:$$TEXINPUTS \ + MAKEINFO='$(MAKEINFO) -I $(srcdir)' $(TEXI2DVI) $< +.dvi.ps: + $(DVIPS) $< -o $@ + +install-info-am: $(INFO_DEPS) + @$(NORMAL_INSTALL) + $(mkinstalldirs) $(infodir) + @for file in $(INFO_DEPS); do \ + if test -f $$file; then d=.; else d=$(srcdir); fi; \ + for ifile in `cd $$d && echo $$file $$file-[0-9] $$file-[0-9][0-9]`; do \ + if test -f $$d/$$ifile; then \ + echo " $(INSTALL_DATA) $$d/$$ifile $(infodir)/$$ifile"; \ + $(INSTALL_DATA) $$d/$$ifile $(infodir)/$$ifile; \ + else : ; fi; \ + done; \ + done + @$(POST_INSTALL) + @if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \ + for file in $(INFO_DEPS); do \ + echo " install-info --info-dir=$(infodir) $(infodir)/$$file";\ + install-info --info-dir=$(infodir) $(infodir)/$$file || :;\ + done; \ + else : ; fi + +uninstall-info: + $(PRE_UNINSTALL) + @if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \ + ii=yes; \ + else ii=; fi; \ + for file in $(INFO_DEPS); do \ + test -z "$ii" \ + || install-info --info-dir=$(infodir) --remove $$file; \ done + $(NORMAL_UNINSTALL) + for file in $(INFO_DEPS); do \ + (cd $(infodir) && rm -f $$file $$file-[0-9] $$file-[0-9][0-9]); \ + done + +dist-info: $(INFO_DEPS) + for base in $(INFO_DEPS); do \ + if test -f $$base; then d=.; else d=$(srcdir); fi; \ + for file in `cd $$d && eval echo $$base*`; do \ + test -f $(distdir)/$$file \ + || ln $$d/$$file $(distdir)/$$file 2> /dev/null \ + || cp -p $$d/$$file $(distdir)/$$file; \ + done; \ + done + +mostlyclean-aminfo: + -rm -f bfd.aux bfd.cp bfd.cps bfd.dvi bfd.fn bfd.fns bfd.ky bfd.kys \ + bfd.ps bfd.log bfd.pg bfd.toc bfd.tp bfd.tps bfd.vr bfd.vrs \ + bfd.op bfd.tr bfd.cv bfd.cn + +clean-aminfo: + +distclean-aminfo: + +maintainer-clean-aminfo: + for i in $(INFO_DEPS); do \ + rm -f $$i; \ + if test "`echo $$i-[0-9]*`" != "$$i-[0-9]*"; then \ + rm -f $$i-[0-9]*; \ + fi; \ + done +clean-info: mostlyclean-aminfo +tags: TAGS +TAGS: + + +distdir = $(top_builddir)/$(PACKAGE)-$(VERSION)/$(subdir) + +subdir = doc + +distdir: $(DISTFILES) + @for file in $(DISTFILES); do \ + if test -f $$file; then d=.; else d=$(srcdir); fi; \ + test -f $(distdir)/$$file \ + || ln $$d/$$file $(distdir)/$$file 2> /dev/null \ + || cp -p $$d/$$file $(distdir)/$$file; \ + done + $(MAKE) top_distdir="$(top_distdir)" distdir="$(distdir)" dist-info +info: $(INFO_DEPS) +dvi: $(DVIS) +check: + $(MAKE) +installcheck: +install-info: install-info-am +install-exec: + @$(NORMAL_INSTALL) + +install-data: + @$(NORMAL_INSTALL) + +install: install-exec install-data all + @: + +uninstall: + +all: Makefile + +install-strip: + $(MAKE) INSTALL_PROGRAM='$(INSTALL_PROGRAM) -s' INSTALL_SCRIPT='$(INSTALL_PROGRAM)' install +installdirs: + + +mostlyclean-generic: + -test -z "$(MOSTLYCLEANFILES)" || rm -f $(MOSTLYCLEANFILES) + +clean-generic: + -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) + +distclean-generic: + -rm -f Makefile $(DISTCLEANFILES) + -rm -f config.cache config.log stamp-h stamp-h[0-9]* + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + -test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES) + -test -z "$(BUILT_SOURCES)" || rm -f $(BUILT_SOURCES) +mostlyclean: mostlyclean-aminfo mostlyclean-generic + +clean: clean-aminfo clean-generic mostlyclean + +distclean: distclean-aminfo distclean-generic clean + -rm -f config.status + -rm -f libtool + +maintainer-clean: maintainer-clean-aminfo maintainer-clean-generic \ + distclean + @echo "This command is intended for maintainers to use;" + @echo "it deletes files that may require special tools to rebuild." + +.PHONY: default install-info-am uninstall-info mostlyclean-aminfo \ +distclean-aminfo clean-aminfo maintainer-clean-aminfo tags distdir info \ +dvi installcheck install-info install-exec install-data install \ +uninstall all installdirs mostlyclean-generic distclean-generic \ +clean-generic maintainer-clean-generic clean mostlyclean distclean \ +maintainer-clean -docs: $(MKDOC) protos bfd.info bfd.dvi bfd.ps $(MKDOC): chew.o $(CC_FOR_BUILD) -o $(MKDOC) chew.o $(LOADLIBES) $(LDFLAGS) @@ -128,159 +346,156 @@ chew.o: chew.c protos: libbfd.h libcoff.h bfd.h +bfd.info bfd.dvi: $(DOCFILES) bfdsumm.texi bfd.texinfo # We can't replace these rules with an implicit rule, because # makes without VPATH support couldn't find the .h files in `..'. -# We use stamp-XXX targets so that we can distribute the info files, +# We use s-XXX targets so that we can distribute the info files, # and permit people to rebuild them, without requiring the makeinfo # program. If somebody tries to rebuild info, but none of the .texi # files have changed, then this Makefile will build chew, and will # build all of the stamp files, but will not actually have to rebuild # bfd.info. -stamp-aoutx: $(MKDOC) $(srcdir)/../aoutx.h $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../aoutx.h >aoutx.tmp +s-aoutx: $(MKDOC) $(srcdir)/../aoutx.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../aoutx.h >aoutx.tmp $(srcdir)/../../move-if-change aoutx.tmp aoutx.texi - touch stamp-aoutx -aoutx.texi: stamp-aoutx + touch s-aoutx +aoutx.texi: s-aoutx -stamp-archive: $(MKDOC) $(srcdir)/../archive.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../archive.c >archive.tmp +s-archive: $(MKDOC) $(srcdir)/../archive.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../archive.c >archive.tmp $(srcdir)/../../move-if-change archive.tmp archive.texi - touch stamp-archive -archive.texi: stamp-archive + touch s-archive +archive.texi: s-archive -stamp-archures: $(MKDOC) $(srcdir)/../archures.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../archures.c >archures.tmp +s-archures: $(MKDOC) $(srcdir)/../archures.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../archures.c >archures.tmp $(srcdir)/../../move-if-change archures.tmp archures.texi - touch stamp-archures -archures.texi: stamp-archures - -stamp-bfd: $(MKDOC) $(srcdir)/../bfd.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../bfd.c >bfd.tmp - $(srcdir)/../../move-if-change bfd.tmp bfd.texi - touch stamp-bfd -bfd.texi: stamp-bfd - -stamp-cache: $(MKDOC) $(srcdir)/../cache.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../cache.c >cache.tmp + touch s-archures +archures.texi: s-archures + +# We use bfdt.texi, rather than bfd.texi, to avoid conflicting with +# bfd.texinfo on an 8.3 filesystem. +s-bfd: $(MKDOC) $(srcdir)/../bfd.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../bfd.c >bfd.tmp + $(srcdir)/../../move-if-change bfd.tmp bfdt.texi + touch s-bfd +bfdt.texi: s-bfd + +s-cache: $(MKDOC) $(srcdir)/../cache.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../cache.c >cache.tmp $(srcdir)/../../move-if-change cache.tmp cache.texi - touch stamp-cache -cache.texi: stamp-cache + touch s-cache +cache.texi: s-cache -stamp-coffcode: $(MKDOC) $(srcdir)/../coffcode.h $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../coffcode.h >coffcode.tmp +s-coffcode: $(MKDOC) $(srcdir)/../coffcode.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../coffcode.h >coffcode.tmp $(srcdir)/../../move-if-change coffcode.tmp coffcode.texi - touch stamp-coffcode -coffcode.texi: stamp-coffcode + touch s-coffcode +coffcode.texi: s-coffcode -stamp-core: $(MKDOC) $(srcdir)/../corefile.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../corefile.c >core.tmp +s-core: $(MKDOC) $(srcdir)/../corefile.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../corefile.c >core.tmp $(srcdir)/../../move-if-change core.tmp core.texi - touch stamp-core -core.texi: stamp-core + touch s-core +core.texi: s-core -stamp-elf: $(MKDOC) $(srcdir)/../elf.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elf.c >elf.tmp +s-elf: $(MKDOC) $(srcdir)/../elf.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elf.c >elf.tmp $(srcdir)/../../move-if-change elf.tmp elf.texi - touch stamp-elf -elf.texi: stamp-elf + touch s-elf +elf.texi: s-elf -stamp-elfcode: $(MKDOC) $(srcdir)/../elfcode.h $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elfcode.h >elfcode.tmp +s-elfcode: $(MKDOC) $(srcdir)/../elfcode.h $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../elfcode.h >elfcode.tmp $(srcdir)/../../move-if-change elfcode.tmp elfcode.texi - touch stamp-elfcode -elfcode.texi: stamp-elfcode + touch s-elfcode +elfcode.texi: s-elfcode -stamp-format: $(MKDOC) $(srcdir)/../format.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../format.c >format.tmp +s-format: $(MKDOC) $(srcdir)/../format.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../format.c >format.tmp $(srcdir)/../../move-if-change format.tmp format.texi - touch stamp-format -format.texi: stamp-format + touch s-format +format.texi: s-format -stamp-libbfd: $(MKDOC) $(srcdir)/../libbfd.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../libbfd.c >libbfd.tmp +s-libbfd: $(MKDOC) $(srcdir)/../libbfd.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str < $(srcdir)/../libbfd.c >libbfd.tmp $(srcdir)/../../move-if-change libbfd.tmp libbfd.texi - touch stamp-libbfd -libbfd.texi: stamp-libbfd + touch s-libbfd +libbfd.texi: s-libbfd -stamp-opncls: $(MKDOC) $(srcdir)/../opncls.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../opncls.c >opncls.tmp +s-opncls: $(MKDOC) $(srcdir)/../opncls.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../opncls.c >opncls.tmp $(srcdir)/../../move-if-change opncls.tmp opncls.texi - touch stamp-opncls -opncls.texi: stamp-opncls + touch s-opncls +opncls.texi: s-opncls -stamp-reloc: $(MKDOC) $(srcdir)/../reloc.c - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../reloc.c >reloc.tmp +s-reloc: $(MKDOC) $(srcdir)/../reloc.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../reloc.c >reloc.tmp $(srcdir)/../../move-if-change reloc.tmp reloc.texi - touch stamp-reloc -reloc.texi: stamp-reloc + touch s-reloc +reloc.texi: s-reloc -stamp-section: $(MKDOC) $(srcdir)/../section.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../section.c >section.tmp +s-section: $(MKDOC) $(srcdir)/../section.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../section.c >section.tmp $(srcdir)/../../move-if-change section.tmp section.texi - touch stamp-section -section.texi: stamp-section + touch s-section +section.texi: s-section -stamp-syms: $(MKDOC) $(srcdir)/../syms.c - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../syms.c >syms.tmp +s-syms: $(MKDOC) $(srcdir)/../syms.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../syms.c >syms.tmp $(srcdir)/../../move-if-change syms.tmp syms.texi - touch stamp-syms -syms.texi: stamp-syms + touch s-syms +syms.texi: s-syms -stamp-targets: $(MKDOC) $(srcdir)/../targets.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../targets.c >targets.tmp +s-targets: $(MKDOC) $(srcdir)/../targets.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../targets.c >targets.tmp $(srcdir)/../../move-if-change targets.tmp targets.texi - touch stamp-targets -targets.texi: stamp-targets + touch s-targets +targets.texi: s-targets -stamp-init: $(MKDOC) $(srcdir)/../init.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../init.c >init.tmp +s-init: $(MKDOC) $(srcdir)/../init.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../init.c >init.tmp $(srcdir)/../../move-if-change init.tmp init.texi - touch stamp-init -init.texi: stamp-init + touch s-init +init.texi: s-init -stamp-hash: $(MKDOC) $(srcdir)/../hash.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../hash.c >hash.tmp +s-hash: $(MKDOC) $(srcdir)/../hash.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../hash.c >hash.tmp $(srcdir)/../../move-if-change hash.tmp hash.texi - touch stamp-hash -hash.texi: stamp-hash + touch s-hash +hash.texi: s-hash -stamp-linker: $(MKDOC) $(srcdir)/../linker.c $(srcdir)/doc.str - $(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../linker.c >linker.tmp +s-linker: $(MKDOC) $(srcdir)/../linker.c $(srcdir)/doc.str + ./$(MKDOC) -f $(srcdir)/doc.str <$(srcdir)/../linker.c >linker.tmp $(srcdir)/../../move-if-change linker.tmp linker.texi - touch stamp-linker -linker.texi: stamp-linker + touch s-linker +linker.texi: s-linker libbfd.h: $(srcdir)/../libbfd-in.h \ $(srcdir)/../init.c \ $(srcdir)/../libbfd.c \ $(srcdir)/../cache.c \ $(srcdir)/../reloc.c \ - $(srcdir)/../cpu-h8300.c \ - $(srcdir)/../cpu-i960.c \ $(srcdir)/../archures.c \ - $(srcdir)/../elfcode.h \ $(srcdir)/proto.str \ $(MKDOC) cat $(srcdir)/../libbfd-in.h >libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../init.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../libbfd.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../cache.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../reloc.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../cpu-h8300.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../cpu-i960.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../archures.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../elf.c >>libbfd.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../elfcode.h >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../init.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../libbfd.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../cache.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../reloc.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../archures.c >>libbfd.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../elf.c >>libbfd.h libcoff.h: $(srcdir)/../libcoff-in.h \ $(srcdir)/../coffcode.h \ $(srcdir)/proto.str \ $(MKDOC) cat $(srcdir)/../libcoff-in.h >libcoff.h - $(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../coffcode.h >>libcoff.h + ./$(MKDOC) -i -f $(srcdir)/proto.str < $(srcdir)/../coffcode.h >>libcoff.h bfd.h: $(srcdir)/../bfd-in.h \ $(srcdir)/../init.c \ @@ -298,84 +513,23 @@ bfd.h: $(srcdir)/../bfd-in.h \ $(srcdir)/proto.str \ $(MKDOC) cat $(srcdir)/../bfd-in.h >bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../init.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../opncls.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../libbfd.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../section.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archures.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../reloc.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../syms.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../bfd.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archive.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../corefile.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../targets.c >>bfd.h - $(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../format.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../init.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../opncls.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../libbfd.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../section.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archures.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../reloc.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../syms.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../bfd.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../archive.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../corefile.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../targets.c >>bfd.h + ./$(MKDOC) -f $(srcdir)/proto.str<$(srcdir)/../format.c >>bfd.h echo "#ifdef __cplusplus" >>bfd.h echo "}" >>bfd.h echo "#endif" >>bfd.h echo "#endif" >>bfd.h - -clean-info: clean - -mostlyclean: - rm -rf *.log *.ps *~* *.dvi *# $(MKDOC) *.o - -clean: mostlyclean - rm -rf $(STAGESTUFF) stamp-* - rm -f *.p *.ip bfd.?? bfd.??? bfd.h libbfd.h libcoff.h texput.log - -distclean: mostlyclean - rm -f *.p *.ip bfd.?? bfd.??? bfd.h libbfd.h libcoff.h texput.log - rm -f stamp-* - rm -f Makefile config.status - -maintainer-clean realclean: clean - rm -f Makefile config.status - -bfd.info: $(DOCFILES) bfdsumm.texi bfd.texinfo - $(MAKEINFO) -I$(srcdir) -o bfd.info $(srcdir)/bfd.texinfo - -bfd.dvi: $(DOCFILES) bfdsumm.texi bfd.texinfo - $(TEXI2DVI) $(srcdir)/bfd.texinfo - -bfd.ps: bfd.dvi - dvips bfd -o - -quickdoc: $(DOCFILES) bfdsumm.texi bfd.texinfo - TEXINPUTS=${TEXIDIR}:.:$$TEXINPUTS tex bfd.texinfo - -stage1: force - - mkdir stage1 - - mv -f $(STAGESTUFF) stage1 - -stage2: force - - mkdir stage2 - - mv -f $(STAGESTUFF) stage2 - -stage3: force - - mkdir stage3 - - mv -f $(STAGESTUFF) stage3 - -against=stage2 - -comparison: force - for i in $(STAGESTUFF) ; do cmp $$i $(against)/$$i || exit 1 ; done - -de-stage1: force - - (cd stage1 ; mv -f $(STAGESTUFF) ..) - - rmdir stage1 - -de-stage2: force - - (cd stage2 ; mv -f $(STAGESTUFF) ..) - - rmdir stage2 - -de-stage3: force - - (cd stage3 ; mv -f $(STAGESTUFF) ..) - - rmdir stage3 - -force: - -Makefile: $(srcdir)/Makefile.in - cd .. && CONFIG_FILES=doc/$@ CONFIG_HEADERS= $(SHELL) ./config.status - +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/contrib/binutils/bfd/doc/aoutx.texi b/contrib/binutils/bfd/doc/aoutx.texi index a35fe9b..d97e96a 100644 --- a/contrib/binutils/bfd/doc/aoutx.texi +++ b/contrib/binutils/bfd/doc/aoutx.texi @@ -1,6 +1,6 @@ @section a.out backends -@* + @strong{Description}@* BFD supports a number of different flavours of a.out format, though the major differences are only the sizes of the @@ -29,33 +29,33 @@ As an example, this is what goes on to make the back end for a sun4, from @file{aout32.c}: @example - #define ARCH_SIZE 32 - #include "aoutx.h" + #define ARCH_SIZE 32 + #include "aoutx.h" @end example Which exports names: @example - ... - aout_32_canonicalize_reloc - aout_32_find_nearest_line - aout_32_get_lineno - aout_32_get_reloc_upper_bound - ... + ... + aout_32_canonicalize_reloc + aout_32_find_nearest_line + aout_32_get_lineno + aout_32_get_reloc_upper_bound + ... @end example from @file{sunos.c}: @example - #define TARGET_NAME "a.out-sunos-big" - #define VECNAME sunos_big_vec - #include "aoutf1.h" + #define TARGET_NAME "a.out-sunos-big" + #define VECNAME sunos_big_vec + #include "aoutf1.h" @end example requires all the names from @file{aout32.c}, and produces the jump vector @example - sunos_big_vec + sunos_big_vec @end example The file @file{host-aout.c} is a special case. It is for a large set @@ -86,18 +86,18 @@ ordinary a.out files on your host. To configure a new machine to use @file{host-aout.c}, specify: @example - TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec - TDEPFILES= host-aout.o trad-core.o + TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec + TDEPFILES= host-aout.o trad-core.o @end example in the @file{config/@var{XXX}.mt} file, and modify @file{configure.in} to use the @file{@var{XXX}.mt} file (by setting "@code{bfd_target=XXX}") when your configuration is selected. -@* + @subsection Relocations -@* + @strong{Description}@* The file @file{aoutx.h} provides for both the @emph{standard} and @emph{extended} forms of a.out relocation records. @@ -106,15 +106,15 @@ The standard records contain only an address, a symbol index, and a type field. The extended records (used on 29ks and sparcs) also have a full integer for an addend. -@* + @subsection Internal entry points -@* + @strong{Description}@* @file{aoutx.h} exports several routines for accessing the contents of an a.out file, which are gathered and exported in turn by various format specific files (eg sunos.c). -@* + @findex aout_@var{size}_swap_exec_header_in @subsubsection @code{aout_@var{size}_swap_exec_header_in} @strong{Synopsis} @@ -128,7 +128,7 @@ void aout_@var{size}_swap_exec_header_in, Swap the information in an executable header @var{raw_bytes} taken from a raw byte stream memory image into the internal exec header structure @var{execp}. -@* + @findex aout_@var{size}_swap_exec_header_out @subsubsection @code{aout_@var{size}_swap_exec_header_out} @strong{Synopsis} @@ -141,7 +141,7 @@ void aout_@var{size}_swap_exec_header_out @strong{Description}@* Swap the information in an internal exec header structure @var{execp} into the buffer @var{raw_bytes} ready for writing to disk. -@* + @findex aout_@var{size}_some_aout_object_p @subsubsection @code{aout_@var{size}_some_aout_object_p} @strong{Synopsis} @@ -156,7 +156,7 @@ checking is an a.out file. Do some more checking, and set up for access if it really is. Call back to the calling environment's "finish up" function just before returning, to handle any last-minute setup. -@* + @findex aout_@var{size}_mkobject @subsubsection @code{aout_@var{size}_mkobject} @strong{Synopsis} @@ -165,7 +165,7 @@ boolean aout_@var{size}_mkobject, (bfd *abfd); @end example @strong{Description}@* Initialize BFD @var{abfd} for use with a.out files. -@* + @findex aout_@var{size}_machine_type @subsubsection @code{aout_@var{size}_machine_type} @strong{Synopsis} @@ -173,7 +173,7 @@ Initialize BFD @var{abfd} for use with a.out files. enum machine_type aout_@var{size}_machine_type (enum bfd_architecture arch, unsigned long machine)); - @end example +@end example @strong{Description}@* Keep track of machine architecture and machine type for a.out's. Return the @code{machine_type} for a particular @@ -182,7 +182,7 @@ and machine can't be represented in a.out format. If the architecture is understood, machine type 0 (default) is always understood. -@* + @findex aout_@var{size}_set_arch_mach @subsubsection @code{aout_@var{size}_set_arch_mach} @strong{Synopsis} @@ -191,12 +191,12 @@ boolean aout_@var{size}_set_arch_mach, (bfd *, enum bfd_architecture arch, unsigned long machine)); - @end example +@end example @strong{Description}@* Set the architecture and the machine of the BFD @var{abfd} to the values @var{arch} and @var{machine}. Verify that @var{abfd}'s format can support the architecture required. -@* + @findex aout_@var{size}_new_section_hook @subsubsection @code{aout_@var{size}_new_section_hook} @strong{Synopsis} @@ -204,8 +204,8 @@ can support the architecture required. boolean aout_@var{size}_new_section_hook, (bfd *abfd, asection *newsect)); - @end example +@end example @strong{Description}@* Called by the BFD in response to a @code{bfd_make_section} request. -@* + diff --git a/contrib/binutils/bfd/doc/archive.texi b/contrib/binutils/bfd/doc/archive.texi index f8d6b89..7e91a16 100644 --- a/contrib/binutils/bfd/doc/archive.texi +++ b/contrib/binutils/bfd/doc/archive.texi @@ -1,6 +1,6 @@ @section Archives -@* + @strong{Description}@* An archive (or library) is just another BFD. It has a symbol table, although there's not much a user program will do with it. @@ -49,7 +49,7 @@ spaces and such in filenames anyway, so this shouldn't be much of a restriction. Archives are supported in BFD in @code{archive.c}. -@* + @findex bfd_get_next_mapent @subsubsection @code{bfd_get_next_mapent} @strong{Synopsis} @@ -68,7 +68,7 @@ got the last one. A @code{carsym} is a canonical archive symbol. The only user-visible element is its name, a null-terminated string. -@* + @findex bfd_set_archive_head @subsubsection @code{bfd_set_archive_head} @strong{Synopsis} @@ -78,7 +78,7 @@ boolean bfd_set_archive_head(bfd *output, bfd *new_head); @strong{Description}@* Set the head of the chain of BFDs contained in the archive @var{output} to @var{new_head}. -@* + @findex bfd_openr_next_archived_file @subsubsection @code{bfd_openr_next_archived_file} @strong{Synopsis} @@ -92,4 +92,4 @@ Subsequent calls should pass the archive and the previous return value to return a created BFD to the next contained element. NULL is returned when there are no more. -@* + diff --git a/contrib/binutils/bfd/doc/archures.texi b/contrib/binutils/bfd/doc/archures.texi index 2dcc074..c555ea7 100644 --- a/contrib/binutils/bfd/doc/archures.texi +++ b/contrib/binutils/bfd/doc/archures.texi @@ -19,11 +19,11 @@ insert as many items into the list of architectures as it wants to; generally this would be one for each machine and one for the default case (an item with a machine field of 0). -BFD's idea of an architecture is implemented in @file{archures.c}. -@* +BFD's idea of an architecture is implemented in @file{archures.c}. + @subsection bfd_architecture -@* + @strong{Description}@* This enum gives the object file's CPU architecture, in a global sense---i.e., what processor family does it belong to? @@ -38,6 +38,13 @@ enum bfd_architecture bfd_arch_unknown, /* File arch not known */ bfd_arch_obscure, /* Arch known, not one of these */ bfd_arch_m68k, /* Motorola 68xxx */ +#define bfd_mach_m68000 1 +#define bfd_mach_m68008 2 +#define bfd_mach_m68010 3 +#define bfd_mach_m68020 4 +#define bfd_mach_m68030 5 +#define bfd_mach_m68040 6 +#define bfd_mach_m68060 7 bfd_arch_vax, /* DEC Vax */ bfd_arch_i960, /* Intel 960 */ /* The order of the following is important. @@ -54,23 +61,37 @@ enum bfd_architecture #define bfd_mach_i960_mc 4 #define bfd_mach_i960_xa 5 #define bfd_mach_i960_ca 6 -#define bfd_mach_i960_jx 7 +#define bfd_mach_i960_jx 7 #define bfd_mach_i960_hx 8 bfd_arch_a29k, /* AMD 29000 */ bfd_arch_sparc, /* SPARC */ -#define bfd_mach_sparc 1 +#define bfd_mach_sparc 1 /* The difference between v8plus and v9 is that v9 is a true 64 bit env. */ -#define bfd_mach_sparc_sparclet 2 -#define bfd_mach_sparc_sparclite 3 -#define bfd_mach_sparc_v8plus 4 -#define bfd_mach_sparc_v8plusa 5 /* with ultrasparc add'ns */ -#define bfd_mach_sparc_v9 6 -#define bfd_mach_sparc_v9a 7 /* with ultrasparc add'ns */ +#define bfd_mach_sparc_sparclet 2 +#define bfd_mach_sparc_sparclite 3 +#define bfd_mach_sparc_v8plus 4 +#define bfd_mach_sparc_v8plusa 5 /* with ultrasparc add'ns */ +#define bfd_mach_sparc_v9 6 +#define bfd_mach_sparc_v9a 7 /* with ultrasparc add'ns */ /* Nonzero if MACH has the v9 instruction set. */ #define bfd_mach_sparc_v9_p(mach) \ ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9a) bfd_arch_mips, /* MIPS Rxxxx */ +#define bfd_mach_mips3000 3000 +#define bfd_mach_mips3900 3900 +#define bfd_mach_mips4000 4000 +#define bfd_mach_mips4010 4010 +#define bfd_mach_mips4100 4100 +#define bfd_mach_mips4300 4300 +#define bfd_mach_mips4400 4400 +#define bfd_mach_mips4600 4600 +#define bfd_mach_mips4650 4650 +#define bfd_mach_mips5000 5000 +#define bfd_mach_mips6000 6000 +#define bfd_mach_mips8000 8000 +#define bfd_mach_mips10000 10000 +#define bfd_mach_mips16 16 bfd_arch_i386, /* Intel 386 */ #define bfd_mach_i386_i386 0 #define bfd_mach_i386_i8086 1 @@ -91,24 +112,40 @@ enum bfd_architecture bfd_arch_hppa, /* HP PA RISC */ bfd_arch_d10v, /* Mitsubishi D10V */ bfd_arch_z8k, /* Zilog Z8000 */ -#define bfd_mach_z8001 1 -#define bfd_mach_z8002 2 +#define bfd_mach_z8001 1 +#define bfd_mach_z8002 2 bfd_arch_h8500, /* Hitachi H8/500 */ bfd_arch_sh, /* Hitachi SH */ +#define bfd_mach_sh 0 +#define bfd_mach_sh3 0x30 +#define bfd_mach_sh3e 0x3e +#define bfd_mach_sh4 0x40 bfd_arch_alpha, /* Dec Alpha */ bfd_arch_arm, /* Advanced Risc Machines ARM */ +#define bfd_mach_arm_2 1 +#define bfd_mach_arm_2a 2 +#define bfd_mach_arm_3 3 +#define bfd_mach_arm_3M 4 +#define bfd_mach_arm_4 5 +#define bfd_mach_arm_4T 6 bfd_arch_ns32k, /* National Semiconductors ns32000 */ bfd_arch_w65, /* WDC 65816 */ + bfd_arch_tic30, /* Texas Instruments TMS320C30 */ + bfd_arch_v850, /* NEC V850 */ +#define bfd_mach_v850 0 + bfd_arch_arc, /* Argonaut RISC Core */ +#define bfd_mach_arc_base 0 bfd_arch_m32r, /* Mitsubishi M32R/D */ +#define bfd_mach_m32r 0 /* backwards compatibility */ bfd_arch_mn10200, /* Matsushita MN10200 */ bfd_arch_mn10300, /* Matsushita MN10300 */ bfd_arch_last @}; @end example -@* + @subsection bfd_arch_info -@* + @strong{Description}@* This structure contains information on architectures for use within BFD. @@ -125,17 +162,17 @@ typedef struct bfd_arch_info const char *printable_name; unsigned int section_align_power; /* true if this is the default machine for the architecture */ - boolean the_default; + boolean the_default; const struct bfd_arch_info * (*compatible) - PARAMS ((const struct bfd_arch_info *a, - const struct bfd_arch_info *b)); + PARAMS ((const struct bfd_arch_info *a, + const struct bfd_arch_info *b)); boolean (*scan) PARAMS ((const struct bfd_arch_info *, const char *)); const struct bfd_arch_info *next; @} bfd_arch_info_type; @end example -@* + @findex bfd_printable_name @subsubsection @code{bfd_printable_name} @strong{Synopsis} @@ -145,7 +182,7 @@ const char *bfd_printable_name(bfd *abfd); @strong{Description}@* Return a printable string representing the architecture and machine from the pointer to the architecture info structure. -@* + @findex bfd_scan_arch @subsubsection @code{bfd_scan_arch} @strong{Synopsis} @@ -156,7 +193,17 @@ const bfd_arch_info_type *bfd_scan_arch(const char *string); Figure out if BFD supports any cpu which could be described with the name @var{string}. Return a pointer to an @code{arch_info} structure if a machine is found, otherwise NULL. -@* + +@findex bfd_arch_list +@subsubsection @code{bfd_arch_list} +@strong{Synopsis} +@example +const char **bfd_arch_list(void); +@end example +@strong{Description}@* +Return a freshly malloced NULL-terminated vector of the names +of all the valid BFD architectures. Do not modify the names. + @findex bfd_arch_get_compatible @subsubsection @code{bfd_arch_get_compatible} @strong{Synopsis} @@ -171,7 +218,7 @@ architectures and machine types are compatible. Calculates the lowest common denominator between the two architectures and machine types implied by the BFDs and returns a pointer to an @code{arch_info} structure describing the compatible machine. -@* + @findex bfd_default_arch_struct @subsubsection @code{bfd_default_arch_struct} @strong{Description}@* @@ -183,7 +230,7 @@ architecture of the file. @example extern const bfd_arch_info_type bfd_default_arch_struct; @end example -@* + @findex bfd_set_arch_info @subsubsection @code{bfd_set_arch_info} @strong{Synopsis} @@ -192,7 +239,7 @@ void bfd_set_arch_info(bfd *abfd, const bfd_arch_info_type *arg); @end example @strong{Description}@* Set the architecture info of @var{abfd} to @var{arg}. -@* + @findex bfd_default_set_arch_mach @subsubsection @code{bfd_default_set_arch_mach} @strong{Synopsis} @@ -206,7 +253,7 @@ Set the architecture and machine type in BFD @var{abfd} to @var{arch} and @var{mach}. Find the correct pointer to a structure and insert it into the @code{arch_info} pointer. -@* + @findex bfd_get_arch @subsubsection @code{bfd_get_arch} @strong{Synopsis} @@ -216,7 +263,7 @@ enum bfd_architecture bfd_get_arch(bfd *abfd); @strong{Description}@* Return the enumerated type which describes the BFD @var{abfd}'s architecture. -@* + @findex bfd_get_mach @subsubsection @code{bfd_get_mach} @strong{Synopsis} @@ -226,7 +273,7 @@ unsigned long bfd_get_mach(bfd *abfd); @strong{Description}@* Return the long type which describes the BFD @var{abfd}'s machine. -@* + @findex bfd_arch_bits_per_byte @subsubsection @code{bfd_arch_bits_per_byte} @strong{Synopsis} @@ -236,7 +283,7 @@ unsigned int bfd_arch_bits_per_byte(bfd *abfd); @strong{Description}@* Return the number of bits in one of the BFD @var{abfd}'s architecture's bytes. -@* + @findex bfd_arch_bits_per_address @subsubsection @code{bfd_arch_bits_per_address} @strong{Synopsis} @@ -246,7 +293,7 @@ unsigned int bfd_arch_bits_per_address(bfd *abfd); @strong{Description}@* Return the number of bits in one of the BFD @var{abfd}'s architecture's addresses. -@* + @findex bfd_default_compatible @subsubsection @code{bfd_default_compatible} @strong{Synopsis} @@ -257,7 +304,7 @@ const bfd_arch_info_type *bfd_default_compatible @end example @strong{Description}@* The default function for testing for compatibility. -@* + @findex bfd_default_scan @subsubsection @code{bfd_default_scan} @strong{Synopsis} @@ -267,7 +314,7 @@ boolean bfd_default_scan(const struct bfd_arch_info *info, const char *string); @strong{Description}@* The default function for working out whether this is an architecture hit and a machine hit. -@* + @findex bfd_get_arch_info @subsubsection @code{bfd_get_arch_info} @strong{Synopsis} @@ -276,7 +323,7 @@ const bfd_arch_info_type * bfd_get_arch_info(bfd *abfd); @end example @strong{Description}@* Return the architecture info struct in @var{abfd}. -@* + @findex bfd_lookup_arch @subsubsection @code{bfd_lookup_arch} @strong{Synopsis} @@ -291,7 +338,7 @@ Look for the architecure info structure which matches the arguments @var{arch} and @var{machine}. A machine of 0 matches the machine/architecture structure which marks itself as the default. -@* + @findex bfd_printable_arch_mach @subsubsection @code{bfd_printable_arch_mach} @strong{Synopsis} @@ -304,4 +351,4 @@ Return a printable string representing the architecture and machine type. This routine is depreciated. -@* + diff --git a/contrib/binutils/bfd/doc/bfd.texinfo b/contrib/binutils/bfd/doc/bfd.texinfo index af7bc10..dc0f96c 100644 --- a/contrib/binutils/bfd/doc/bfd.texinfo +++ b/contrib/binutils/bfd/doc/bfd.texinfo @@ -1,6 +1,6 @@ \input texinfo.tex @setfilename bfd.info -@c $Id: bfd.texinfo,v 1.28 1995/11/10 20:04:12 victoria Exp $ +@c $Id: bfd.texinfo,v 1.29 1997/07/22 18:47:29 ian Exp $ @tex % NOTE LOCAL KLUGE TO AVOID TOO MUCH WHITESPACE \global\long\def\example{% @@ -67,7 +67,7 @@ into another language, under the above conditions for modified versions. @tex \def\$#1${{#1}} % Kluge: collect RCS revision info without $...$ -\xdef\manvers{\$Revision: 1.28 $} % For use in headers, footers too +\xdef\manvers{\$Revision: 1.29 $} % For use in headers, footers too {\parskip=0pt \hfill Cygnus Support\par \hfill sac\@cygnus.com\par @@ -213,7 +213,7 @@ IEEE-695. @node BFD front end, BFD back ends, Overview, Top @chapter BFD front end -@include bfd.texi +@include bfdt.texi @menu * Memory Usage:: diff --git a/contrib/binutils/bfd/doc/bfdt.texi b/contrib/binutils/bfd/doc/bfdt.texi new file mode 100644 index 0000000..6013d6a --- /dev/null +++ b/contrib/binutils/bfd/doc/bfdt.texi @@ -0,0 +1,597 @@ +@section @code{typedef bfd} +A BFD has type @code{bfd}; objects of this type are the +cornerstone of any application using BFD. Using BFD +consists of making references though the BFD and to data in the BFD. + +Here is the structure that defines the type @code{bfd}. It +contains the major data about the file and pointers +to the rest of the data. + + +@example + +struct _bfd +@{ + /* The filename the application opened the BFD with. */ + CONST char *filename; + + /* A pointer to the target jump table. */ + const struct bfd_target *xvec; + + /* To avoid dragging too many header files into every file that + includes `@code{bfd.h}', IOSTREAM has been declared as a "char + *", and MTIME as a "long". Their correct types, to which they + are cast when used, are "FILE *" and "time_t". The iostream + is the result of an fopen on the filename. However, if the + BFD_IN_MEMORY flag is set, then iostream is actually a pointer + to a bfd_in_memory struct. */ + PTR iostream; + + /* Is the file descriptor being cached? That is, can it be closed as + needed, and re-opened when accessed later? */ + + boolean cacheable; + + /* Marks whether there was a default target specified when the + BFD was opened. This is used to select which matching algorithm + to use to choose the back end. */ + + boolean target_defaulted; + + /* The caching routines use these to maintain a + least-recently-used list of BFDs */ + + struct _bfd *lru_prev, *lru_next; + + /* When a file is closed by the caching routines, BFD retains + state information on the file here: */ + + file_ptr where; + + /* and here: (``once'' means at least once) */ + + boolean opened_once; + + /* Set if we have a locally maintained mtime value, rather than + getting it from the file each time: */ + + boolean mtime_set; + + /* File modified time, if mtime_set is true: */ + + long mtime; + + /* Reserved for an unimplemented file locking extension.*/ + + int ifd; + + /* The format which belongs to the BFD. (object, core, etc.) */ + + bfd_format format; + + /* The direction the BFD was opened with*/ + + enum bfd_direction @{no_direction = 0, + read_direction = 1, + write_direction = 2, + both_direction = 3@} direction; + + /* Format_specific flags*/ + + flagword flags; + + /* Currently my_archive is tested before adding origin to + anything. I believe that this can become always an add of + origin, with origin set to 0 for non archive files. */ + + file_ptr origin; + + /* Remember when output has begun, to stop strange things + from happening. */ + boolean output_has_begun; + + /* Pointer to linked list of sections*/ + struct sec *sections; + + /* The number of sections */ + unsigned int section_count; + + /* Stuff only useful for object files: + The start address. */ + bfd_vma start_address; + + /* Used for input and output*/ + unsigned int symcount; + + /* Symbol table for output BFD (with symcount entries) */ + struct symbol_cache_entry **outsymbols; + + /* Pointer to structure which contains architecture information*/ + const struct bfd_arch_info *arch_info; + + /* Stuff only useful for archives:*/ + PTR arelt_data; + struct _bfd *my_archive; /* The containing archive BFD. */ + struct _bfd *next; /* The next BFD in the archive. */ + struct _bfd *archive_head; /* The first BFD in the archive. */ + boolean has_armap; + + /* A chain of BFD structures involved in a link. */ + struct _bfd *link_next; + + /* A field used by _bfd_generic_link_add_archive_symbols. This will + be used only for archive elements. */ + int archive_pass; + + /* Used by the back end to hold private data. */ + + union + @{ + struct aout_data_struct *aout_data; + struct artdata *aout_ar_data; + struct _oasys_data *oasys_obj_data; + struct _oasys_ar_data *oasys_ar_data; + struct coff_tdata *coff_obj_data; + struct pe_tdata *pe_obj_data; + struct xcoff_tdata *xcoff_obj_data; + struct ecoff_tdata *ecoff_obj_data; + struct ieee_data_struct *ieee_data; + struct ieee_ar_data_struct *ieee_ar_data; + struct srec_data_struct *srec_data; + struct ihex_data_struct *ihex_data; + struct tekhex_data_struct *tekhex_data; + struct elf_obj_tdata *elf_obj_data; + struct nlm_obj_tdata *nlm_obj_data; + struct bout_data_struct *bout_data; + struct sun_core_struct *sun_core_data; + struct trad_core_struct *trad_core_data; + struct som_data_struct *som_data; + struct hpux_core_struct *hpux_core_data; + struct hppabsd_core_struct *hppabsd_core_data; + struct sgi_core_struct *sgi_core_data; + struct lynx_core_struct *lynx_core_data; + struct osf_core_struct *osf_core_data; + struct cisco_core_struct *cisco_core_data; + struct versados_data_struct *versados_data; + struct netbsd_core_struct *netbsd_core_data; + PTR any; + @} tdata; + + /* Used by the application to hold private data*/ + PTR usrdata; + + /* Where all the allocated stuff under this BFD goes. This is a + struct objalloc *, but we use PTR to avoid requiring the inclusion of + objalloc.h. */ + PTR memory; +@}; + +@end example +@section Error reporting +Most BFD functions return nonzero on success (check their +individual documentation for precise semantics). On an error, +they call @code{bfd_set_error} to set an error condition that callers +can check by calling @code{bfd_get_error}. +If that returns @code{bfd_error_system_call}, then check +@code{errno}. + +The easiest way to report a BFD error to the user is to +use @code{bfd_perror}. + +@subsection Type @code{bfd_error_type} +The values returned by @code{bfd_get_error} are defined by the +enumerated type @code{bfd_error_type}. + + +@example + +typedef enum bfd_error +@{ + bfd_error_no_error = 0, + bfd_error_system_call, + bfd_error_invalid_target, + bfd_error_wrong_format, + bfd_error_invalid_operation, + bfd_error_no_memory, + bfd_error_no_symbols, + bfd_error_no_armap, + bfd_error_no_more_archived_files, + bfd_error_malformed_archive, + bfd_error_file_not_recognized, + bfd_error_file_ambiguously_recognized, + bfd_error_no_contents, + bfd_error_nonrepresentable_section, + bfd_error_no_debug_section, + bfd_error_bad_value, + bfd_error_file_truncated, + bfd_error_file_too_big, + bfd_error_invalid_error_code +@} bfd_error_type; + +@end example +@findex bfd_get_error +@subsubsection @code{bfd_get_error} +@strong{Synopsis} +@example +bfd_error_type bfd_get_error (void); +@end example +@strong{Description}@* +Return the current BFD error condition. + +@findex bfd_set_error +@subsubsection @code{bfd_set_error} +@strong{Synopsis} +@example +void bfd_set_error (bfd_error_type error_tag); +@end example +@strong{Description}@* +Set the BFD error condition to be @var{error_tag}. + +@findex bfd_errmsg +@subsubsection @code{bfd_errmsg} +@strong{Synopsis} +@example +CONST char *bfd_errmsg (bfd_error_type error_tag); +@end example +@strong{Description}@* +Return a string describing the error @var{error_tag}, or +the system error if @var{error_tag} is @code{bfd_error_system_call}. + +@findex bfd_perror +@subsubsection @code{bfd_perror} +@strong{Synopsis} +@example +void bfd_perror (CONST char *message); +@end example +@strong{Description}@* +Print to the standard error stream a string describing the +last BFD error that occurred, or the last system error if +the last BFD error was a system call failure. If @var{message} +is non-NULL and non-empty, the error string printed is preceded +by @var{message}, a colon, and a space. It is followed by a newline. + +@subsection BFD error handler +Some BFD functions want to print messages describing the +problem. They call a BFD error handler function. This +function may be overriden by the program. + +The BFD error handler acts like printf. + + +@example + +typedef void (*bfd_error_handler_type) PARAMS ((const char *, ...)); + +@end example +@findex bfd_set_error_handler +@subsubsection @code{bfd_set_error_handler} +@strong{Synopsis} +@example +bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type); +@end example +@strong{Description}@* +Set the BFD error handler function. Returns the previous +function. + +@findex bfd_set_error_program_name +@subsubsection @code{bfd_set_error_program_name} +@strong{Synopsis} +@example +void bfd_set_error_program_name (const char *); +@end example +@strong{Description}@* +Set the program name to use when printing a BFD error. This +is printed before the error message followed by a colon and +space. The string must not be changed after it is passed to +this function. + +@findex bfd_get_error_handler +@subsubsection @code{bfd_get_error_handler} +@strong{Synopsis} +@example +bfd_error_handler_type bfd_get_error_handler (void); +@end example +@strong{Description}@* +Return the BFD error handler function. + +@section Symbols + + +@findex bfd_get_reloc_upper_bound +@subsubsection @code{bfd_get_reloc_upper_bound} +@strong{Synopsis} +@example +long bfd_get_reloc_upper_bound(bfd *abfd, asection *sect); +@end example +@strong{Description}@* +Return the number of bytes required to store the +relocation information associated with section @var{sect} +attached to bfd @var{abfd}. If an error occurs, return -1. + +@findex bfd_canonicalize_reloc +@subsubsection @code{bfd_canonicalize_reloc} +@strong{Synopsis} +@example +long bfd_canonicalize_reloc + (bfd *abfd, + asection *sec, + arelent **loc, + asymbol **syms); +@end example +@strong{Description}@* +Call the back end associated with the open BFD +@var{abfd} and translate the external form of the relocation +information attached to @var{sec} into the internal canonical +form. Place the table into memory at @var{loc}, which has +been preallocated, usually by a call to +@code{bfd_get_reloc_upper_bound}. Returns the number of relocs, or +-1 on error. + +The @var{syms} table is also needed for horrible internal magic +reasons. + +@findex bfd_set_reloc +@subsubsection @code{bfd_set_reloc} +@strong{Synopsis} +@example +void bfd_set_reloc + (bfd *abfd, asection *sec, arelent **rel, unsigned int count) +@end example +@strong{Description}@* +Set the relocation pointer and count within +section @var{sec} to the values @var{rel} and @var{count}. +The argument @var{abfd} is ignored. + +@findex bfd_set_file_flags +@subsubsection @code{bfd_set_file_flags} +@strong{Synopsis} +@example +boolean bfd_set_file_flags(bfd *abfd, flagword flags); +@end example +@strong{Description}@* +Set the flag word in the BFD @var{abfd} to the value @var{flags}. + +Possible errors are: +@itemize @bullet + +@item +@code{bfd_error_wrong_format} - The target bfd was not of object format. +@item +@code{bfd_error_invalid_operation} - The target bfd was open for reading. +@item +@code{bfd_error_invalid_operation} - +The flag word contained a bit which was not applicable to the +type of file. E.g., an attempt was made to set the @code{D_PAGED} bit +on a BFD format which does not support demand paging. +@end itemize + +@findex bfd_set_start_address +@subsubsection @code{bfd_set_start_address} +@strong{Synopsis} +@example +boolean bfd_set_start_address(bfd *abfd, bfd_vma vma); +@end example +@strong{Description}@* +Make @var{vma} the entry point of output BFD @var{abfd}. + +@strong{Returns}@* +Returns @code{true} on success, @code{false} otherwise. + +@findex bfd_get_mtime +@subsubsection @code{bfd_get_mtime} +@strong{Synopsis} +@example +long bfd_get_mtime(bfd *abfd); +@end example +@strong{Description}@* +Return the file modification time (as read from the file system, or +from the archive header for archive members). + +@findex bfd_get_size +@subsubsection @code{bfd_get_size} +@strong{Synopsis} +@example +long bfd_get_size(bfd *abfd); +@end example +@strong{Description}@* +Return the file size (as read from file system) for the file +associated with BFD @var{abfd}. + +The initial motivation for, and use of, this routine is not +so we can get the exact size of the object the BFD applies to, since +that might not be generally possible (archive members for example). +It would be ideal if someone could eventually modify +it so that such results were guaranteed. + +Instead, we want to ask questions like "is this NNN byte sized +object I'm about to try read from file offset YYY reasonable?" +As as example of where we might do this, some object formats +use string tables for which the first @code{sizeof(long)} bytes of the +table contain the size of the table itself, including the size bytes. +If an application tries to read what it thinks is one of these +string tables, without some way to validate the size, and for +some reason the size is wrong (byte swapping error, wrong location +for the string table, etc.), the only clue is likely to be a read +error when it tries to read the table, or a "virtual memory +exhausted" error when it tries to allocate 15 bazillon bytes +of space for the 15 bazillon byte table it is about to read. +This function at least allows us to answer the quesion, "is the +size reasonable?". + +@findex bfd_get_gp_size +@subsubsection @code{bfd_get_gp_size} +@strong{Synopsis} +@example +int bfd_get_gp_size(bfd *abfd); +@end example +@strong{Description}@* +Return the maximum size of objects to be optimized using the GP +register under MIPS ECOFF. This is typically set by the @code{-G} +argument to the compiler, assembler or linker. + +@findex bfd_set_gp_size +@subsubsection @code{bfd_set_gp_size} +@strong{Synopsis} +@example +void bfd_set_gp_size(bfd *abfd, int i); +@end example +@strong{Description}@* +Set the maximum size of objects to be optimized using the GP +register under ECOFF or MIPS ELF. This is typically set by +the @code{-G} argument to the compiler, assembler or linker. + +@findex bfd_scan_vma +@subsubsection @code{bfd_scan_vma} +@strong{Synopsis} +@example +bfd_vma bfd_scan_vma(CONST char *string, CONST char **end, int base); +@end example +@strong{Description}@* +Convert, like @code{strtoul}, a numerical expression +@var{string} into a @code{bfd_vma} integer, and return that integer. +(Though without as many bells and whistles as @code{strtoul}.) +The expression is assumed to be unsigned (i.e., positive). +If given a @var{base}, it is used as the base for conversion. +A base of 0 causes the function to interpret the string +in hex if a leading "0x" or "0X" is found, otherwise +in octal if a leading zero is found, otherwise in decimal. + +Overflow is not detected. + +@findex bfd_copy_private_bfd_data +@subsubsection @code{bfd_copy_private_bfd_data} +@strong{Synopsis} +@example +boolean bfd_copy_private_bfd_data(bfd *ibfd, bfd *obfd); +@end example +@strong{Description}@* +Copy private BFD information from the BFD @var{ibfd} to the +the BFD @var{obfd}. Return @code{true} on success, @code{false} on error. +Possible error returns are: + +@itemize @bullet + +@item +@code{bfd_error_no_memory} - +Not enough memory exists to create private data for @var{obfd}. +@end itemize +@example +#define bfd_copy_private_bfd_data(ibfd, obfd) \ + BFD_SEND (obfd, _bfd_copy_private_bfd_data, \ + (ibfd, obfd)) +@end example + +@findex bfd_merge_private_bfd_data +@subsubsection @code{bfd_merge_private_bfd_data} +@strong{Synopsis} +@example +boolean bfd_merge_private_bfd_data(bfd *ibfd, bfd *obfd); +@end example +@strong{Description}@* +Merge private BFD information from the BFD @var{ibfd} to the +the output file BFD @var{obfd} when linking. Return @code{true} +on success, @code{false} on error. Possible error returns are: + +@itemize @bullet + +@item +@code{bfd_error_no_memory} - +Not enough memory exists to create private data for @var{obfd}. +@end itemize +@example +#define bfd_merge_private_bfd_data(ibfd, obfd) \ + BFD_SEND (obfd, _bfd_merge_private_bfd_data, \ + (ibfd, obfd)) +@end example + +@findex bfd_set_private_flags +@subsubsection @code{bfd_set_private_flags} +@strong{Synopsis} +@example +boolean bfd_set_private_flags(bfd *abfd, flagword flags); +@end example +@strong{Description}@* +Set private BFD flag information in the BFD @var{abfd}. +Return @code{true} on success, @code{false} on error. Possible error +returns are: + +@itemize @bullet + +@item +@code{bfd_error_no_memory} - +Not enough memory exists to create private data for @var{obfd}. +@end itemize +@example +#define bfd_set_private_flags(abfd, flags) \ + BFD_SEND (abfd, _bfd_set_private_flags, \ + (abfd, flags)) +@end example + +@findex stuff +@subsubsection @code{stuff} +@strong{Description}@* +Stuff which should be documented: +@example +#define bfd_sizeof_headers(abfd, reloc) \ + BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, reloc)) + +#define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \ + BFD_SEND (abfd, _bfd_find_nearest_line, (abfd, sec, syms, off, file, func, line)) + + /* Do these three do anything useful at all, for any back end? */ +#define bfd_debug_info_start(abfd) \ + BFD_SEND (abfd, _bfd_debug_info_start, (abfd)) + +#define bfd_debug_info_end(abfd) \ + BFD_SEND (abfd, _bfd_debug_info_end, (abfd)) + +#define bfd_debug_info_accumulate(abfd, section) \ + BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section)) + + +#define bfd_stat_arch_elt(abfd, stat) \ + BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat)) + +#define bfd_update_armap_timestamp(abfd) \ + BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd)) + +#define bfd_set_arch_mach(abfd, arch, mach)\ + BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach)) + +#define bfd_relax_section(abfd, section, link_info, again) \ + BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again)) + +#define bfd_link_hash_table_create(abfd) \ + BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd)) + +#define bfd_link_add_symbols(abfd, info) \ + BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info)) + +#define bfd_final_link(abfd, info) \ + BFD_SEND (abfd, _bfd_final_link, (abfd, info)) + +#define bfd_free_cached_info(abfd) \ + BFD_SEND (abfd, _bfd_free_cached_info, (abfd)) + +#define bfd_get_dynamic_symtab_upper_bound(abfd) \ + BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd)) + +#define bfd_print_private_bfd_data(abfd, file)\ + BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file)) + +#define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \ + BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols)) + +#define bfd_get_dynamic_reloc_upper_bound(abfd) \ + BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd)) + +#define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \ + BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms)) + +extern bfd_byte *bfd_get_relocated_section_contents + PARAMS ((bfd *, struct bfd_link_info *, + struct bfd_link_order *, bfd_byte *, + boolean, asymbol **)); + +@end example + diff --git a/contrib/binutils/bfd/doc/cache.texi b/contrib/binutils/bfd/doc/cache.texi index badda34..4aafb69 100644 --- a/contrib/binutils/bfd/doc/cache.texi +++ b/contrib/binutils/bfd/doc/cache.texi @@ -9,7 +9,7 @@ limit (often as low as 20 open files). The module in the required BFD is open. If not, then it chooses a file to close, closes it and opens the one wanted, returning its file handle. -@* + @findex BFD_CACHE_MAX_OPEN macro @subsubsection @code{BFD_CACHE_MAX_OPEN macro} @strong{Description}@* @@ -18,7 +18,7 @@ one time. @example #define BFD_CACHE_MAX_OPEN 10 @end example -@* + @findex bfd_last_cache @subsubsection @code{bfd_last_cache} @strong{Synopsis} @@ -29,7 +29,7 @@ extern bfd *bfd_last_cache; Zero, or a pointer to the topmost BFD on the chain. This is used by the @code{bfd_cache_lookup} macro in @file{libbfd.h} to determine when it can avoid a function call. -@* + @findex bfd_cache_lookup @subsubsection @code{bfd_cache_lookup} @strong{Description}@* @@ -43,7 +43,7 @@ otherwise, it has to perform the complicated lookup function. (FILE*)(bfd_last_cache->iostream): \ bfd_cache_lookup_worker(x)) @end example -@* + @findex bfd_cache_init @subsubsection @code{bfd_cache_init} @strong{Synopsis} @@ -52,7 +52,7 @@ boolean bfd_cache_init (bfd *abfd); @end example @strong{Description}@* Add a newly opened BFD to the cache. -@* + @findex bfd_cache_close @subsubsection @code{bfd_cache_close} @strong{Synopsis} @@ -62,11 +62,11 @@ boolean bfd_cache_close (bfd *abfd); @strong{Description}@* Remove the BFD @var{abfd} from the cache. If the attached file is open, then close it too. -@* + @strong{Returns}@* @code{false} is returned if closing the file fails, @code{true} is returned if all is well. -@* + @findex bfd_open_file @subsubsection @code{bfd_open_file} @strong{Synopsis} @@ -79,7 +79,7 @@ Call the OS to open a file for @var{abfd}. Return the @code{FILE *} BFD so that future accesses know the file is open. If the @code{FILE *} returned is @code{NULL}, then it won't have been put in the cache, so it won't have to be removed from it. -@* + @findex bfd_cache_lookup_worker @subsubsection @code{bfd_cache_lookup_worker} @strong{Synopsis} @@ -92,4 +92,4 @@ quick answer. Find a file descriptor for @var{abfd}. If necessary, it open it. If there are already more than @code{BFD_CACHE_MAX_OPEN} files open, it tries to close one first, to avoid running out of file descriptors. -@* + diff --git a/contrib/binutils/bfd/doc/chew.c b/contrib/binutils/bfd/doc/chew.c index 3958f30..eba69c2 100644 --- a/contrib/binutils/bfd/doc/chew.c +++ b/contrib/binutils/bfd/doc/chew.c @@ -1,5 +1,6 @@ /* chew - Copyright (C) 1990-1991 Free Software Foundation, Inc. + Copyright (C) 1990, 91, 92, 93, 94, 95, 96, 1998 + Free Software Foundation, Inc. Contributed by steve chamberlain @cygnus This file is part of BFD, the Binary File Descriptor library. @@ -118,7 +119,6 @@ static void overwrite_string (string_type *, string_type *); static void catbuf (string_type *, char *, unsigned int); static void cattext (string_type *, char *); static void catstr (string_type *, string_type *); -static unsigned int skip_white_and_starts (string_type *, unsigned int); #endif @@ -248,7 +248,7 @@ DEFUN(skip_white_and_stars,(src, idx), { char c; while ((c = at(src,idx)), - isspace (c) + isspace ((unsigned char) c) || (c == '*' /* Don't skip past end-of-comment or star as first character on its line. */ @@ -323,7 +323,7 @@ static void remchar (void), strip_trailing_newlines (void), push_number (void); static void push_text (void); static void remove_noncomments (string_type *, string_type *); static void print_stack_level (void); -static void paramstuff (void), translatecomments (void), manglecomments (void); +static void paramstuff (void), translatecomments (void); static void outputdots (void), courierize (void), bulletize (void); static void do_fancy_stuff (void); static int iscommand (string_type *, unsigned int); @@ -379,7 +379,7 @@ WORD(remchar) static void strip_trailing_newlines () { - while ((isspace (at (tos, tos->write_idx - 1)) + while ((isspace ((unsigned char) at (tos, tos->write_idx - 1)) || at (tos, tos->write_idx - 1) == '\n') && tos->write_idx > 0) tos->write_idx--; @@ -503,9 +503,11 @@ DEFUN_VOID(paramstuff) fname = openp; /* Step back to the fname */ fname--; - while (fname && isspace(at(tos, fname))) + while (fname && isspace((unsigned char) at(tos, fname))) fname --; - while (fname && !isspace(at(tos,fname)) && at(tos,fname) != '*') + while (fname + && !isspace((unsigned char) at(tos,fname)) + && at(tos,fname) != '*') fname--; fname++; @@ -573,6 +575,10 @@ WORD(translatecomments) } +#if 0 + +/* This is not currently used. */ + /* turn everything not starting with a . into a comment */ WORD(manglecomments) @@ -607,6 +613,8 @@ WORD(manglecomments) } +#endif + /* Mod tos so that only lines with leading dots remain */ static void DEFUN_VOID(outputdots) @@ -619,7 +627,7 @@ DEFUN_VOID(outputdots) { if (at(tos, idx) == '\n' && at(tos, idx+1) == '.') { - char c, c2; + char c; idx += 2; while ((c = at(tos, idx)) && c != '\n') @@ -699,7 +707,8 @@ WORD(courierize) { if (at(tos,idx) == '@') command = 1; - else if (isspace(at(tos,idx)) || at(tos,idx) == '}') + else if (isspace((unsigned char) at(tos,idx)) + || at(tos,idx) == '}') command = 0; catchar(&out, at(tos, idx)); idx++; @@ -709,8 +718,9 @@ WORD(courierize) catchar(&out,'\n'); } while (at(tos, idx) == '\n' - && (at(tos, idx+1) == '.') - || (at(tos,idx+1) == '|')); + && ((at(tos, idx+1) == '.') + || (at(tos,idx+1) == '|'))) + ; cattext(&out,"@end example"); } else @@ -746,10 +756,10 @@ WORD(bulletize) idx+=2; } -else + else if (at(tos, idx) == '\n' && at(tos, idx+1) == 'o' && - isspace(at(tos, idx +2))) + isspace((unsigned char) at(tos, idx +2))) { if (!on) { @@ -797,7 +807,7 @@ WORD(do_fancy_stuff) { if (at(tos, idx) == '<' && at(tos, idx+1) == '<' - && !isspace(at(tos,idx + 2))) + && !isspace((unsigned char) at(tos,idx + 2))) { /* This qualifies as a << startup */ idx +=2; @@ -831,7 +841,7 @@ DEFUN( iscommand,(ptr, idx), { unsigned int len = 0; while (at(ptr,idx)) { - if (isupper(at(ptr,idx)) || at(ptr,idx) == ' ' || + if (isupper((unsigned char) at(ptr,idx)) || at(ptr,idx) == ' ' || at(ptr,idx) == '_') { len++; @@ -849,14 +859,29 @@ DEFUN( iscommand,(ptr, idx), } +static int DEFUN(copy_past_newline,(ptr, idx, dst), string_type *ptr AND unsigned int idx AND string_type *dst) { + int column = 0; + while (at(ptr, idx) && at(ptr, idx) != '\n') { - catchar(dst, at(ptr, idx)); + if (at (ptr, idx) == '\t') + { + /* Expand tabs. Neither makeinfo nor TeX can cope well with + them. */ + do + catchar (dst, ' '); + while (++column & 7); + } + else + { + catchar(dst, at(ptr, idx)); + column++; + } idx++; } @@ -883,7 +908,6 @@ WORD(kill_bogus_lines) { int sl ; - int nl = 0; int idx = 0; int c; int dot = 0 ; @@ -897,6 +921,11 @@ WORD(kill_bogus_lines) } c = idx; + /* If the first char is a '.' prepend a newline so that it is + recognized properly later. */ + if (at (tos, idx) == '.') + catchar (&out, '\n'); + /* Find the last char */ while (at(tos,idx)) { @@ -906,7 +935,7 @@ WORD(kill_bogus_lines) /* find the last non white before the nl */ idx--; - while (idx && isspace(at(tos,idx))) + while (idx && isspace((unsigned char) at(tos,idx))) idx--; idx++; @@ -972,7 +1001,7 @@ WORD(indent) case '\n': cattext(&out,"\n"); idx++; - if (tab) + if (tab && at(tos,idx)) { cattext(&out," "); } @@ -1107,7 +1136,7 @@ DEFUN(nextword,(string, word), int length = 0; - while (isspace(*string) || *string == '-') { + while (isspace((unsigned char) *string) || *string == '-') { if (*string == '-') { while (*string && *string != '\n') @@ -1137,7 +1166,7 @@ DEFUN(nextword,(string, word), } else { - while (!isspace(*string)) + while (!isspace((unsigned char) *string)) { string++; length++; @@ -1210,9 +1239,6 @@ static void DEFUN_VOID(perform) /* It's worth looking through the command list */ if (iscommand(ptr, idx)) { - unsigned int i; - int found = 0; - char *next; dict_type *word ; @@ -1305,8 +1331,6 @@ void DEFUN(compile, (string), char *string) { - int jstack[STACK]; - int *jptr = jstack; /* add words to the dictionary */ char *word; string = nextword(string, &word); @@ -1416,7 +1440,7 @@ WORD(print) else if (*isp == 2) write_buffer (tos, stderr); else - fprintf (stderr, "print: illegal print destination `%d'\n", *isp); + fprintf (stderr, "print: illegal print destination `%ld'\n", *isp); isp--; tos--; icheck_range (); @@ -1512,7 +1536,7 @@ char *av[]) read_in(&buffer, stdin); remove_noncomments(&buffer, ptr); - for (i= 1; i < ac; i++) + for (i= 1; i < (unsigned int) ac; i++) { if (av[i][0] == '-') { @@ -1541,6 +1565,8 @@ char *av[]) { warning = 1; } + else + usage (); } } write_buffer(stack+0, stdout); diff --git a/contrib/binutils/bfd/doc/coffcode.texi b/contrib/binutils/bfd/doc/coffcode.texi index 5c3d546..d3bcfa0 100644 --- a/contrib/binutils/bfd/doc/coffcode.texi +++ b/contrib/binutils/bfd/doc/coffcode.texi @@ -18,7 +18,7 @@ The Intel i960 processor version of coff is implemented in @file{coff-i960.c}. This file has the same structure as @file{coff-m88k.c}, except that it includes @file{coff/i960.h} rather than @file{coff-m88k.h}. -@* + @subsection Porting to a new version of coff The recommended method is to select from the existing implementations the version of coff which is most like the one @@ -41,10 +41,10 @@ dump utility, usually called @code{att-dump} or just @code{dump}) are the same. Then clean up your code, and send what you've done to Cygnus. Then your stuff will be in the next release, and you won't have to keep integrating it. -@* + @subsection How the coff backend works -@* + @subsubsection File layout The Coff backend is split into generic routines that are applicable to any Coff target and routines that are specific @@ -75,7 +75,7 @@ types, @file{coff-i960.c} also includes some code to manipulate the i960 relocs. This code is not in @file{coffcode.h} because it would not be used by any other target. -@* + @subsubsection Bit twiddling Each flavour of coff supported in BFD has its own header file describing the external layout of the structures. There is also @@ -108,7 +108,7 @@ saving the internal BFD overhead, but uses BFD to swap things on the way out, making cross ports much safer. Doing so also allows BFD (and thus the linker) to use the same header files as @code{gas}, which makes one avenue to disaster disappear. -@* + @subsubsection Symbol reading The simple canonical form for symbols used by BFD is not rich enough to keep all the information available in a coff symbol @@ -135,7 +135,7 @@ rather than the normal text associated with the symbol At this time the symbol names are moved around. Coff stores all symbols less than nine characters long physically within the symbol table; longer strings are kept at the end of -the file in the string table. This pass moves all strings +the file in the string table. This pass moves all strings into memory and replaces them with pointers to the strings. The symbol table is massaged once again, this time to create @@ -147,7 +147,7 @@ shares strings with the hidden internal symbol table. Any linenumbers are read from the coff file too, and attached to the symbols which own the functions the linenumbers belong to. -@* + @subsubsection Symbol writing Writing a symbol to a coff file which didn't come from a coff file will lose any debugging information. The @code{asymbol} @@ -199,15 +199,16 @@ to a symbol into the index into the symbol table of the asymbol. This routine runs through the symbol table and patches up the symbols from their internal form into the coff way, calls the bit twiddlers, and writes out the table to the file. -@* + @findex coff_symbol_type @subsubsection @code{coff_symbol_type} @strong{Description}@* The hidden information for an @code{asymbol} is described in a @code{combined_entry_type}: -@* -. + + @example + typedef struct coff_ptr_struct @{ @@ -292,43 +293,43 @@ typedef struct Special entry points for gas to swap out coff parts: @example unsigned int (*_bfd_coff_swap_aux_out) PARAMS (( - bfd *abfd, - PTR in, - int type, - int class, + bfd *abfd, + PTR in, + int type, + int class, int indaux, int numaux, - PTR ext)); + PTR ext)); unsigned int (*_bfd_coff_swap_sym_out) PARAMS (( bfd *abfd, - PTR in, - PTR ext)); + PTR in, + PTR ext)); unsigned int (*_bfd_coff_swap_lineno_out) PARAMS (( - bfd *abfd, - PTR in, - PTR ext)); + bfd *abfd, + PTR in, + PTR ext)); unsigned int (*_bfd_coff_swap_reloc_out) PARAMS (( - bfd *abfd, - PTR src, - PTR dst)); + bfd *abfd, + PTR src, + PTR dst)); unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS (( - bfd *abfd, - PTR in, - PTR out)); + bfd *abfd, + PTR in, + PTR out)); unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS (( - bfd *abfd, - PTR in, - PTR out)); + bfd *abfd, + PTR in, + PTR out)); unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS (( - bfd *abfd, - PTR in, - PTR out)); + bfd *abfd, + PTR in, + PTR out)); @end example Special entry points for generic COFF routines to call target @@ -453,6 +454,12 @@ dependent COFF routines: boolean collect, struct bfd_link_hash_entry **hashp)); + boolean (*_bfd_coff_link_output_has_begun) PARAMS (( + bfd * abfd )); + boolean (*_bfd_coff_final_link_postscript) PARAMS (( + bfd * abfd, + struct coff_final_link_info * pfinfo)); + @} bfd_coff_backend_data; #define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data) @@ -498,7 +505,7 @@ dependent COFF routines: #define bfd_coff_long_section_names(abfd) \ (coff_backend_info (abfd)->_bfd_coff_long_section_names) #define bfd_coff_default_section_alignment_power(abfd) \ - (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power) + (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power) #define bfd_coff_swap_filehdr_in(abfd, i,o) \ ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o)) @@ -567,6 +574,11 @@ dependent COFF routines: ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\ (info, abfd, name, flags, section, value, string, cp, coll, hashp)) +#define bfd_coff_link_output_has_begun(a) \ + ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a)) +#define bfd_coff_final_link_postscript(a,p) \ + ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a,p)) + @end example @subsubsection Writing relocations To write relocations, the back end steps though the @@ -578,7 +590,7 @@ address and the relocation offset; the type is dug directly from the howto field. Then the @code{internal_reloc} is swapped into the shape of an @code{external_reloc} and written out to disk. -@* + @subsubsection Reading linenumbers Creating the linenumber table is done by reading in the entire coff linenumber table, and creating another table for internal use. @@ -594,7 +606,7 @@ table, and each symbol which marks a function is marked by pointing its... How does this work ? -@* + @subsubsection Reading relocations Coff relocations are easily transformed into the internal BFD form (@code{arelent}). @@ -624,4 +636,4 @@ and 960 use the @code{r_type} to directly produce an index into a howto table vector; the 88k subtracts a number from the @code{r_type} field and creates an addend field. @end itemize -@* + diff --git a/contrib/binutils/bfd/doc/core.texi b/contrib/binutils/bfd/doc/core.texi index 841daa9..55e369a 100644 --- a/contrib/binutils/bfd/doc/core.texi +++ b/contrib/binutils/bfd/doc/core.texi @@ -1,9 +1,9 @@ @section Core files -@* + @strong{Description}@* These are functions pertaining to core files. -@* + @findex bfd_core_file_failing_command @subsubsection @code{bfd_core_file_failing_command} @strong{Synopsis} @@ -13,7 +13,7 @@ CONST char *bfd_core_file_failing_command(bfd *abfd); @strong{Description}@* Return a read-only string explaining which program was running when it failed and produced the core file @var{abfd}. -@* + @findex bfd_core_file_failing_signal @subsubsection @code{bfd_core_file_failing_signal} @strong{Synopsis} @@ -23,7 +23,7 @@ int bfd_core_file_failing_signal(bfd *abfd); @strong{Description}@* Returns the signal number which caused the core dump which generated the file the BFD @var{abfd} is attached to. -@* + @findex core_file_matches_executable_p @subsubsection @code{core_file_matches_executable_p} @strong{Synopsis} @@ -35,4 +35,4 @@ boolean core_file_matches_executable_p Return @code{true} if the core file attached to @var{core_bfd} was generated by a run of the executable file attached to @var{exec_bfd}, @code{false} otherwise. -@* + diff --git a/contrib/binutils/bfd/doc/doc.str b/contrib/binutils/bfd/doc/doc.str index 9368599..7a276fe 100644 --- a/contrib/binutils/bfd/doc/doc.str +++ b/contrib/binutils/bfd/doc/doc.str @@ -71,7 +71,7 @@ do_fancy_stuff courierize catstr - "@*\n" catstr + "\n" catstr ; : asection diff --git a/contrib/binutils/bfd/doc/elf.texi b/contrib/binutils/bfd/doc/elf.texi index 673654c..4f9434c 100644 --- a/contrib/binutils/bfd/doc/elf.texi +++ b/contrib/binutils/bfd/doc/elf.texi @@ -6,7 +6,7 @@ Currently, the best supported back ends are for sparc and i386 Documentation of the internals of the support code still needs to be written. The code is changing quickly enough that we haven't bothered yet. -@* + @findex bfd_elf_find_section @subsubsection @code{bfd_elf_find_section} @strong{Synopsis} @@ -19,4 +19,4 @@ Since BFD hides string tables from callers, GDB needs to use an internal hook to find them. Sun's .stabstr, in particular, isn't even pointed to by the .stab section, so ordinary mechanisms wouldn't work to find it, even if we had some. -@* + diff --git a/contrib/binutils/bfd/doc/format.texi b/contrib/binutils/bfd/doc/format.texi index d30a41b..3281c36 100644 --- a/contrib/binutils/bfd/doc/format.texi +++ b/contrib/binutils/bfd/doc/format.texi @@ -22,7 +22,7 @@ The BFD contains other BFDs and an optional index. @code{bfd_core} @end itemize The BFD contains the result of an executable core dump. -@* + @findex bfd_check_format @subsubsection @code{bfd_check_format} @strong{Synopsis} @@ -65,7 +65,7 @@ none of the backends recognised the file format. @code{bfd_error_file_ambiguously_recognized} - more than one backend recognised the file format. @end itemize -@* + @findex bfd_check_format_matches @subsubsection @code{bfd_check_format_matches} @strong{Synopsis} @@ -82,7 +82,7 @@ Then the user may choose a format and try again. When done with the list that @var{matching} points to, the caller should free it. -@* + @findex bfd_set_format @subsubsection @code{bfd_set_format} @strong{Synopsis} @@ -94,7 +94,7 @@ This function sets the file format of the BFD @var{abfd} to the format @var{format}. If the target set in the BFD does not support the format requested, the format is invalid, or the BFD is not open for writing, then an error occurs. -@* + @findex bfd_format_string @subsubsection @code{bfd_format_string} @strong{Synopsis} @@ -105,4 +105,4 @@ CONST char *bfd_format_string(bfd_format format); Return a pointer to a const string @code{invalid}, @code{object}, @code{archive}, @code{core}, or @code{unknown}, depending upon the value of @var{format}. -@* + diff --git a/contrib/binutils/bfd/doc/hash.texi b/contrib/binutils/bfd/doc/hash.texi index 4147ce4..45d63e0 100644 --- a/contrib/binutils/bfd/doc/hash.texi +++ b/contrib/binutils/bfd/doc/hash.texi @@ -25,7 +25,7 @@ The basic hash table code is in @code{hash.c}. * Traversing a Hash Table:: * Deriving a New Hash Table Type:: @end menu -@* + @node Creating and Freeing a Hash Table, Looking Up or Entering a String, Hash Tables, Hash Tables @subsection Creating and freeing a hash table @findex bfd_hash_table_init @@ -54,7 +54,7 @@ objalloc using @code{bfd_hash_allocate}. Use @code{bfd_hash_table_free} to free up all the memory that has been allocated for a hash table. This will not free up the @code{struct bfd_hash_table} itself, which you must provide. -@* + @node Looking Up or Entering a String, Traversing a Hash Table, Creating and Freeing a Hash Table, Hash Tables @subsection Looking up or entering a string @findex bfd_hash_lookup @@ -81,7 +81,7 @@ copy the string onto the hash table objalloc or not. If @var{copy} is passed as @code{false}, you must be careful not to deallocate or modify the string as long as the hash table exists. -@* + @node Traversing a Hash Table, Deriving a New Hash Table Type, Looking Up or Entering a String, Hash Tables @subsection Traversing a hash table @findex bfd_hash_traverse @@ -97,7 +97,7 @@ must return a @code{boolean} value, which indicates whether to continue traversing the hash table. If the function returns @code{false}, @code{bfd_hash_traverse} will stop the traversal and return immediately. -@* + @node Deriving a New Hash Table Type, , Traversing a Hash Table, Hash Tables @subsection Deriving a new hash table type Many uses of hash tables want to store additional information @@ -123,7 +123,7 @@ table derived from the linker hash table. * Write the Derived Creation Routine:: * Write Other Derived Routines:: @end menu -@* + @node Define the Derived Structures, Write the Derived Creation Routine, Deriving a New Hash Table Type, Deriving a New Hash Table Type @subsubsection Define the derived structures You must define a structure for an entry in the hash table, @@ -143,7 +143,7 @@ bfd_link_hash_entry} (in @code{bfdlink.h}). The first field, @code{root}, is of type @code{struct bfd_hash_entry}. Similarly, the first field in @code{struct bfd_link_hash_table}, @code{table}, is of type @code{struct bfd_hash_table}. -@* + @node Write the Derived Creation Routine, Write Other Derived Routines, Define the Derived Structures, Deriving a New Hash Table Type @subsubsection Write the derived creation routine You must write a routine which will create and initialize an @@ -174,9 +174,10 @@ Here is a boilerplate example of a creation routine. are creating. @var{base_newfunc} is the name of the creation routine of the hash table type your hash table is derived from. -@* -.struct bfd_hash_entry * + + @example +struct bfd_hash_entry * @var{function_name} (entry, table, string) struct bfd_hash_entry *entry; struct bfd_hash_table *table; @@ -189,14 +190,14 @@ from. if (ret == (@var{entry_type} *) NULL) @{ ret = ((@var{entry_type} *) - bfd_hash_allocate (table, sizeof (@var{entry_type}))); + bfd_hash_allocate (table, sizeof (@var{entry_type}))); if (ret == (@var{entry_type} *) NULL) return NULL; @} /* Call the allocation method of the base class. */ ret = ((@var{entry_type} *) - @var{base_newfunc} ((struct bfd_hash_entry *) ret, table, string)); + @var{base_newfunc} ((struct bfd_hash_entry *) ret, table, string)); /* Initialize the local fields here. */ @@ -214,7 +215,7 @@ routine for a basic hash table. @code{_bfd_link_hash_newfunc} also initializes the local fields in a linker hash table entry: @code{type}, @code{written} and @code{next}. -@* + @node Write Other Derived Routines, , Write the Derived Creation Routine, Deriving a New Hash Table Type @subsubsection Write other derived routines You will want to write other routines for your new hash table, @@ -241,4 +242,4 @@ the a.out backend linker hash table, which is derived from the linker hash table, uses macros for the lookup and traversal routines. These are @code{aout_link_hash_lookup} and @code{aout_link_hash_traverse} in aoutx.h. -@* + diff --git a/contrib/binutils/bfd/doc/init.texi b/contrib/binutils/bfd/doc/init.texi index 2902eac..e561a77 100644 --- a/contrib/binutils/bfd/doc/init.texi +++ b/contrib/binutils/bfd/doc/init.texi @@ -1,6 +1,6 @@ @section Initialization These are the functions that handle initializing a BFD. -@* + @findex bfd_init @subsubsection @code{bfd_init} @strong{Synopsis} @@ -10,4 +10,4 @@ void bfd_init(void); @strong{Description}@* This routine must be called before any other BFD function to initialize magical internal data structures. -@* + diff --git a/contrib/binutils/bfd/doc/libbfd.texi b/contrib/binutils/bfd/doc/libbfd.texi index 002e2f4..6bee5b5 100644 --- a/contrib/binutils/bfd/doc/libbfd.texi +++ b/contrib/binutils/bfd/doc/libbfd.texi @@ -1,11 +1,11 @@ @section Internal functions -@* + @strong{Description}@* These routines are used within BFD. They are not intended for export, but are documented here for completeness. -@* + @findex bfd_write_bigendian_4byte_int @subsubsection @code{bfd_write_bigendian_4byte_int} @strong{Synopsis} @@ -16,7 +16,7 @@ void bfd_write_bigendian_4byte_int(bfd *abfd, int i); Write a 4 byte integer @var{i} to the output BFD @var{abfd}, in big endian order regardless of what else is going on. This is useful in archives. -@* + @findex bfd_put_size @subsubsection @code{bfd_put_size} @findex bfd_get_size @@ -45,41 +45,41 @@ To detect calling these with less than a @code{bfd_vma}, use #define bfd_put_8(abfd, val, ptr) \ (*((unsigned char *)(ptr)) = (unsigned char)(val)) #define bfd_put_signed_8 \ - bfd_put_8 + bfd_put_8 #define bfd_get_8(abfd, ptr) \ (*(unsigned char *)(ptr)) #define bfd_get_signed_8(abfd, ptr) \ - ((*(unsigned char *)(ptr) ^ 0x80) - 0x80) + ((*(unsigned char *)(ptr) ^ 0x80) - 0x80) #define bfd_put_16(abfd, val, ptr) \ BFD_SEND(abfd, bfd_putx16, ((val),(ptr))) #define bfd_put_signed_16 \ - bfd_put_16 + bfd_put_16 #define bfd_get_16(abfd, ptr) \ BFD_SEND(abfd, bfd_getx16, (ptr)) #define bfd_get_signed_16(abfd, ptr) \ - BFD_SEND (abfd, bfd_getx_signed_16, (ptr)) + BFD_SEND (abfd, bfd_getx_signed_16, (ptr)) #define bfd_put_32(abfd, val, ptr) \ BFD_SEND(abfd, bfd_putx32, ((val),(ptr))) #define bfd_put_signed_32 \ - bfd_put_32 + bfd_put_32 #define bfd_get_32(abfd, ptr) \ BFD_SEND(abfd, bfd_getx32, (ptr)) #define bfd_get_signed_32(abfd, ptr) \ - BFD_SEND(abfd, bfd_getx_signed_32, (ptr)) + BFD_SEND(abfd, bfd_getx_signed_32, (ptr)) #define bfd_put_64(abfd, val, ptr) \ BFD_SEND(abfd, bfd_putx64, ((val), (ptr))) #define bfd_put_signed_64 \ - bfd_put_64 + bfd_put_64 #define bfd_get_64(abfd, ptr) \ BFD_SEND(abfd, bfd_getx64, (ptr)) #define bfd_get_signed_64(abfd, ptr) \ - BFD_SEND(abfd, bfd_getx_signed_64, (ptr)) + BFD_SEND(abfd, bfd_getx_signed_64, (ptr)) @end example -@* + @findex bfd_h_put_size @subsubsection @code{bfd_h_put_size} @strong{Description}@* @@ -93,43 +93,43 @@ order and their data in little endian order. /* Byte swapping macros for file header data. */ #define bfd_h_put_8(abfd, val, ptr) \ - bfd_put_8 (abfd, val, ptr) + bfd_put_8 (abfd, val, ptr) #define bfd_h_put_signed_8(abfd, val, ptr) \ - bfd_put_8 (abfd, val, ptr) + bfd_put_8 (abfd, val, ptr) #define bfd_h_get_8(abfd, ptr) \ - bfd_get_8 (abfd, ptr) + bfd_get_8 (abfd, ptr) #define bfd_h_get_signed_8(abfd, ptr) \ - bfd_get_signed_8 (abfd, ptr) + bfd_get_signed_8 (abfd, ptr) #define bfd_h_put_16(abfd, val, ptr) \ BFD_SEND(abfd, bfd_h_putx16,(val,ptr)) #define bfd_h_put_signed_16 \ - bfd_h_put_16 + bfd_h_put_16 #define bfd_h_get_16(abfd, ptr) \ BFD_SEND(abfd, bfd_h_getx16,(ptr)) #define bfd_h_get_signed_16(abfd, ptr) \ - BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr)) + BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr)) #define bfd_h_put_32(abfd, val, ptr) \ BFD_SEND(abfd, bfd_h_putx32,(val,ptr)) #define bfd_h_put_signed_32 \ - bfd_h_put_32 + bfd_h_put_32 #define bfd_h_get_32(abfd, ptr) \ BFD_SEND(abfd, bfd_h_getx32,(ptr)) #define bfd_h_get_signed_32(abfd, ptr) \ - BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr)) + BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr)) #define bfd_h_put_64(abfd, val, ptr) \ BFD_SEND(abfd, bfd_h_putx64,(val, ptr)) #define bfd_h_put_signed_64 \ - bfd_h_put_64 + bfd_h_put_64 #define bfd_h_get_64(abfd, ptr) \ BFD_SEND(abfd, bfd_h_getx64,(ptr)) #define bfd_h_get_signed_64(abfd, ptr) \ - BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr)) + BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr)) @end example -@* + @findex bfd_log2 @subsubsection @code{bfd_log2} @strong{Synopsis} @@ -139,4 +139,4 @@ unsigned int bfd_log2(bfd_vma x); @strong{Description}@* Return the log base 2 of the value supplied, rounded up. E.g., an @var{x} of 1025 returns 11. -@* + diff --git a/contrib/binutils/bfd/doc/linker.texi b/contrib/binutils/bfd/doc/linker.texi index 5cd6268..0de907d 100644 --- a/contrib/binutils/bfd/doc/linker.texi +++ b/contrib/binutils/bfd/doc/linker.texi @@ -30,12 +30,12 @@ ends which have implemented versions of these routines are a.out (in @code{aoutx.h}) and ECOFF (in @code{ecoff.c}). The a.out routines are used as examples throughout this section. -@menu +@menu * Creating a Linker Hash Table:: * Adding Symbols to the Hash Table:: * Performing the Final Link:: @end menu -@* + @node Creating a Linker Hash Table, Adding Symbols to the Hash Table, Linker Functions, Linker Functions @subsection Creating a linker hash table @cindex _bfd_link_hash_table_create in target vector @@ -70,7 +70,7 @@ generally not know exactly which fields will be required until you have finished. You should simply create a new hash table which defines no additional fields, and then simply add fields as they become necessary. -@* + @node Adding Symbols to the Hash Table, Performing the Final Link, Creating a Linker Hash Table, Linker Functions @subsection Adding symbols to the hash table @cindex _bfd_link_add_symbols in target vector @@ -93,7 +93,7 @@ The a.out version of this entry point is * Adding symbols from an object file:: * Adding symbols from an archive:: @end menu -@* + @node Differing file formats, Adding symbols from an object file, Adding Symbols to the Hash Table, Adding Symbols to the Hash Table @subsubsection Differing file formats Normally all the files involved in a link will be of the same @@ -127,7 +127,7 @@ See @code{ecoff_link_add_externals} for an example of how to check the @code{creator} field before saving information (in this case, the ECOFF external symbol debugging information) in a hash table entry. -@* + @node Adding symbols from an object file, Adding symbols from an archive, Differing file formats, Adding Symbols to the Hash Table @subsubsection Adding symbols from an object file When the @code{_bfd_link_add_symbols} routine is passed an object @@ -168,7 +168,7 @@ pointers to the hash tables entries created by @code{_bfd_generic_link_add_one_symbol} indexed by symbol number, so that the @code{_bfd_final_link} routine does not have to call the hash table lookup routine to locate the entry. -@* + @node Adding symbols from an archive, , Adding symbols from an object file, Adding Symbols to the Hash Table @subsubsection Adding symbols from an archive When the @code{_bfd_link_add_symbols} routine is passed an @@ -217,7 +217,7 @@ call @code{_bfd_generic_link_add_archive_symbols}, because ECOFF archives already contain a hash table of symbols. The ECOFF back end searches the archive itself to avoid the overhead of creating a new hash table. -@* + @node Performing the Final Link, , Adding Symbols to the Hash Table, Linker Functions @subsection Performing the final link @cindex _bfd_link_final_link in target vector @@ -246,7 +246,7 @@ the specific object file format. The a.out * Relocating the section contents:: * Writing the symbol table:: @end menu -@* + @node Information provided by the linker, Relocating the section contents, Performing the Final Link, Performing the Final Link @subsubsection Information provided by the linker Before the linker calls the @code{_bfd_final_link} entry point, @@ -267,7 +267,7 @@ types of information. They also describe relocs that must be created by the BFD backend, but do not correspond to any input file; this is used to support -Ur, which builds constructors while generating a relocateable object file. -@* + @node Relocating the section contents, Writing the symbol table, Information provided by the linker, Performing the Final Link @subsubsection Relocating the section contents The @code{_bfd_final_link} function should look through the @@ -302,7 +302,7 @@ The a.out function which handles reading, relocating, and writing section contents is @code{aout_link_input_section}. The actual relocation is done in @code{aout_link_input_section_std} and @code{aout_link_input_section_ext}. -@* + @node Writing the symbol table, , Relocating the section contents, Performing the Final Link @subsubsection Writing the symbol table The @code{_bfd_final_link} function must gather all the symbols @@ -347,7 +347,7 @@ traversing the global hash table with the function @code{aout_link_write_other_symbol}. It builds a string table while writing out the symbols, which is written to the output file at the end of @code{NAME(aout,final_link)}. -@* + @findex bfd_link_split_section @subsubsection @code{bfd_link_split_section} @strong{Synopsis} @@ -362,4 +362,4 @@ reloceatable or final link. BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec)) @end example -@* + diff --git a/contrib/binutils/bfd/doc/opncls.texi b/contrib/binutils/bfd/doc/opncls.texi index 07456d8..4fbb0a7 100644 --- a/contrib/binutils/bfd/doc/opncls.texi +++ b/contrib/binutils/bfd/doc/opncls.texi @@ -1,6 +1,6 @@ @section Opening and closing BFDs -@* + @findex bfd_openr @subsubsection @code{bfd_openr} @strong{Synopsis} @@ -16,7 +16,7 @@ that function. If @code{NULL} is returned then an error has occured. Possible errors are @code{bfd_error_no_memory}, @code{bfd_error_invalid_target} or @code{system_call} error. -@* + @findex bfd_fdopenr @subsubsection @code{bfd_fdopenr} @strong{Synopsis} @@ -40,7 +40,7 @@ assume no cacheing; the file descriptor will remain open until files. Possible errors are @code{bfd_error_no_memory}, @code{bfd_error_invalid_target} and @code{bfd_error_system_call}. -@* + @findex bfd_openstreamr @subsubsection @code{bfd_openstreamr} @strong{Synopsis} @@ -50,7 +50,7 @@ bfd *bfd_openstreamr(const char *, const char *, PTR); @strong{Description}@* Open a BFD for read access on an existing stdio stream. When the BFD is passed to @code{bfd_close}, the stream will be closed. -@* + @findex bfd_openw @subsubsection @code{bfd_openw} @strong{Synopsis} @@ -63,7 +63,7 @@ file format @var{target}, and return a pointer to it. Possible errors are @code{bfd_error_system_call}, @code{bfd_error_no_memory}, @code{bfd_error_invalid_target}. -@* + @findex bfd_close @subsubsection @code{bfd_close} @strong{Synopsis} @@ -80,10 +80,10 @@ All memory attached to the BFD is released. The file descriptor associated with the BFD is closed (even if it was passed in to BFD by @code{bfd_fdopenr}). -@* + @strong{Returns}@* @code{true} is returned if all is ok, otherwise @code{false}. -@* + @findex bfd_close_all_done @subsubsection @code{bfd_close_all_done} @strong{Synopsis} @@ -100,10 +100,10 @@ If the created file is executable, then @code{chmod} is called to mark it as such. All memory attached to the BFD is released. -@* + @strong{Returns}@* @code{true} is returned if all is ok, otherwise @code{false}. -@* + @findex bfd_create @subsubsection @code{bfd_create} @strong{Synopsis} @@ -115,7 +115,7 @@ Create a new BFD in the manner of @code{bfd_openw}, but without opening a file. The new BFD takes the target from the target used by @var{template}. The format is always set to @code{bfd_object}. -@* + @findex bfd_alloc @subsubsection @code{bfd_alloc} @strong{Synopsis} @@ -125,4 +125,4 @@ PTR bfd_alloc (bfd *abfd, size_t wanted); @strong{Description}@* Allocate a block of @var{wanted} bytes of memory attached to @code{abfd} and return a pointer to it. -@* + diff --git a/contrib/binutils/bfd/doc/reloc.texi b/contrib/binutils/bfd/doc/reloc.texi index 63c079e..fc4970d 100644 --- a/contrib/binutils/bfd/doc/reloc.texi +++ b/contrib/binutils/bfd/doc/reloc.texi @@ -16,14 +16,15 @@ in a particular section, and fill in the right bits of the structures. * typedef arelent:: * howto manager:: @end menu -@* + @node typedef arelent, howto manager, Relocations, Relocations @subsection typedef arelent This is the structure of a relocation entry: -@* -. + + @example + typedef enum bfd_reloc_status @{ /* No errors detected */ @@ -219,37 +220,39 @@ information in the reloc record and data section. A back end would normally have a relocation instruction set and turn relocations into pointers to the correct structure on input - but it would be possible to create each howto field on demand. -@* + @subsubsection @code{enum complain_overflow} Indicates what sort of overflow checking should be done when performing a relocation. -@* -. + + @example + enum complain_overflow @{ - /* Do not complain on overflow. */ + /* Do not complain on overflow. */ complain_overflow_dont, - /* Complain if the bitfield overflows, whether it is considered - as signed or unsigned. */ + /* Complain if the bitfield overflows, whether it is considered + as signed or unsigned. */ complain_overflow_bitfield, - /* Complain if the value overflows when considered as signed - number. */ + /* Complain if the value overflows when considered as signed + number. */ complain_overflow_signed, - /* Complain if the value overflows when considered as an - unsigned number. */ + /* Complain if the value overflows when considered as an + unsigned number. */ complain_overflow_unsigned @}; @end example @subsubsection @code{reloc_howto_type} The @code{reloc_howto_type} is a structure which contains all the information that libbfd needs to know to tie up a back end's data. -@* -.struct symbol_cache_entry; /* Forward declaration */ + + @example +struct symbol_cache_entry; /* Forward declaration */ struct reloc_howto_struct @{ @@ -265,13 +268,13 @@ struct reloc_howto_struct unwanted data from the relocation. */ unsigned int rightshift; - /* The size of the item to be relocated. This is *not* a - power-of-two measure. To get the number of bytes operated - on by a type of relocation, use bfd_get_reloc_size. */ + /* The size of the item to be relocated. This is *not* a + power-of-two measure. To get the number of bytes operated + on by a type of relocation, use bfd_get_reloc_size. */ int size; /* The number of bits in the item to be relocated. This is used - when doing overflow checking. */ + when doing overflow checking. */ unsigned int bitsize; /* Notes that the relocation is relative to the location in the @@ -280,12 +283,12 @@ struct reloc_howto_struct being relocated. */ boolean pc_relative; - /* The bit position of the reloc value in the destination. - The relocated value is left shifted by this amount. */ + /* The bit position of the reloc value in the destination. + The relocated value is left shifted by this amount. */ unsigned int bitpos; - /* What type of overflow error should be checked for when - relocating. */ + /* What type of overflow error should be checked for when + relocating. */ enum complain_overflow complain_on_overflow; /* If this field is non null, then the supplied function is @@ -293,8 +296,8 @@ struct reloc_howto_struct strange relocation methods to be accomodated (e.g., i960 callj instructions). */ bfd_reloc_status_type (*special_function) - PARAMS ((bfd *abfd, - arelent *reloc_entry, + PARAMS ((bfd *abfd, + arelent *reloc_entry, struct symbol_cache_entry *symbol, PTR data, asection *input_section, @@ -341,7 +344,7 @@ The HOWTO define is horrible and will go away. #define HOWTO(C, R,S,B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \ @{(unsigned)C,R,S,B, P, BI, O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC@} @end example -@* + @strong{Description}@* And will be replaced with the totally magic way. But for the moment, we are compatible, so do it this way. @@ -349,7 +352,7 @@ moment, we are compatible, so do it this way. #define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,complain_overflow_dont,FUNCTION, NAME,false,0,0,IN) @end example -@* + @strong{Description}@* Helper routine to turn a symbol into a relocation value. @example @@ -365,17 +368,17 @@ Helper routine to turn a symbol into a relocation value. @} \ @} @end example -@* + @findex bfd_get_reloc_size @subsubsection @code{bfd_get_reloc_size} @strong{Synopsis} @example -int bfd_get_reloc_size (reloc_howto_type *); +unsigned int bfd_get_reloc_size (reloc_howto_type *); @end example @strong{Description}@* For a reloc_howto_type that operates on a fixed number of bytes, this returns the number of bytes operated on. -@* + @findex arelent_chain @subsubsection @code{arelent_chain} @strong{Description}@* @@ -386,7 +389,24 @@ typedef struct relent_chain @{ struct relent_chain *next; @} arelent_chain; @end example -@* + +@findex bfd_check_overflow +@subsubsection @code{bfd_check_overflow} +@strong{Synopsis} +@example +bfd_reloc_status_type +bfd_check_overflow + (enum complain_overflow how, + unsigned int bitsize, + unsigned int rightshift, + bfd_vma relocation); +@end example +@strong{Description}@* +Perform overflow checking on @var{relocation} which has @var{bitsize} +significant bits and will be shifted right by @var{rightshift} bits. +The result is either of @code{bfd_reloc_ok} or +@code{bfd_reloc_overflow}. + @findex bfd_perform_relocation @subsubsection @code{bfd_perform_relocation} @strong{Synopsis} @@ -415,7 +435,7 @@ slot will always be big enough for the addend. Complex reloc types with addends were invented to solve just this problem. The @var{error_message} argument is set to an error message if this return @code{bfd_reloc_dangerous}. -@* + @findex bfd_install_relocation @subsubsection @code{bfd_install_relocation} @strong{Synopsis} @@ -436,14 +456,14 @@ a relocation. For now, this function should be considered reserved for the assembler. -@* + @node howto manager, , typedef arelent, Relocations @section The howto manager When an application wants to create a relocation, but doesn't know what the target machine might call it, it can find out by using this bit of code. -@* + @findex bfd_reloc_code_type @subsubsection @code{bfd_reloc_code_type} @strong{Description}@* @@ -455,7 +475,7 @@ return a howto pointer. This does mean that the application must determine the correct enumerator value; you can't get a howto pointer from a random set of attributes. -@* + Here are the possible values for @code{enum bfd_reloc_code_real}: @deffn {} BFD_RELOC_64 @@ -576,11 +596,18 @@ I think these are specific to SPARC a.out (e.g., Sun 4). @deffnx {} BFD_RELOC_SPARC_PC_LM22 @deffnx {} BFD_RELOC_SPARC_WDISP16 @deffnx {} BFD_RELOC_SPARC_WDISP19 -@deffnx {} BFD_RELOC_SPARC_GLOB_JMP @deffnx {} BFD_RELOC_SPARC_7 @deffnx {} BFD_RELOC_SPARC_6 @deffnx {} BFD_RELOC_SPARC_5 -Some relocations we're using for SPARC V9 -- subject to change. +@deffnx {} BFD_RELOC_SPARC_DISP64 +@deffnx {} BFD_RELOC_SPARC_PLT64 +@deffnx {} BFD_RELOC_SPARC_HIX22 +@deffnx {} BFD_RELOC_SPARC_LOX10 +@deffnx {} BFD_RELOC_SPARC_H44 +@deffnx {} BFD_RELOC_SPARC_M44 +@deffnx {} BFD_RELOC_SPARC_L44 +@deffnx {} BFD_RELOC_SPARC_REGISTER +SPARC64 relocations @end deffn @deffn {} BFD_RELOC_ALPHA_GPDISP_HI16 Alpha ECOFF and ELF relocations. Some of these treat the symbol or @@ -790,6 +817,23 @@ These relocs are only used within the ARM assembler. They are not @deffnx {} BFD_RELOC_SH_LABEL Hitachi SH relocs. Not all of these appear in object files. @end deffn +@deffn {} BFD_RELOC_THUMB_PCREL_BRANCH9 +@deffnx {} BFD_RELOC_THUMB_PCREL_BRANCH12 +@deffnx {} BFD_RELOC_THUMB_PCREL_BRANCH23 +Thumb 23-, 12- and 9-bit pc-relative branches. The lowest bit must +be zero and is not stored in the instruction. +@end deffn +@deffn {} BFD_RELOC_ARC_B22_PCREL +Argonaut RISC Core (ARC) relocs. +ARC 22 bit pc-relative branch. The lowest two bits must be zero and are +not stored in the instruction. The high 20 bits are installed in bits 26 +through 7 of the instruction. +@end deffn +@deffn {} BFD_RELOC_ARC_B26 +ARC 26 bit absolute branch. The lowest two bits must be zero and are not +stored in the instruction. The high 24 bits are installed in bits 23 +through 0. +@end deffn @deffn {} BFD_RELOC_D10V_10_PCREL_R Mitsubishi D10V relocs. This is a 10-bit reloc with the right 2 bits @@ -838,6 +882,40 @@ This is a 16-bit reloc containing the lower 16 bits of an address. This is a 16-bit reloc containing the small data area offset for use in add3, load, and store instructions. @end deffn +@deffn {} BFD_RELOC_V850_9_PCREL +This is a 9-bit reloc +@end deffn +@deffn {} BFD_RELOC_V850_22_PCREL +This is a 22-bit reloc +@end deffn +@deffn {} BFD_RELOC_V850_SDA_16_16_OFFSET +This is a 16 bit offset from the short data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_SDA_15_16_OFFSET +This is a 16 bit offset (of which only 15 bits are used) from the +short data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_ZDA_16_16_OFFSET +This is a 16 bit offset from the zero data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_ZDA_15_16_OFFSET +This is a 16 bit offset (of which only 15 bits are used) from the +zero data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_TDA_6_8_OFFSET +This is an 8 bit offset (of which only 6 bits are used) from the +tiny data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_TDA_7_8_OFFSET +This is an 8bit offset (of which only 7 bits are used) from the tiny +data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_TDA_7_7_OFFSET +This is a 7 bit offset from the tiny data area pointer. +@end deffn +@deffn {} BFD_RELOC_V850_TDA_16_16_OFFSET +This is a 16 bit offset from the tiny data area pointer. +@end deffn @deffn {} BFD_RELOC_MN10300_32_PCREL This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the instruction. @@ -846,8 +924,14 @@ instruction. This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the instruction. @end deffn -. +@deffn {} BFD_RELOC_TIC30_LDP +This is a 8bit DP reloc for the tms320c30, where the most +significant 8 bits of a 24 bit word are placed into the least +significant 8 bits of the opcode. +@end deffn + @example + typedef enum bfd_reloc_code_real bfd_reloc_code_real_type; @end example @findex bfd_reloc_type_lookup @@ -861,7 +945,7 @@ bfd_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code); Return a pointer to a howto structure which, when invoked, will perform the relocation @var{code} on data from the architecture noted. -@* + @findex bfd_default_reloc_type_lookup @subsubsection @code{bfd_default_reloc_type_lookup} @strong{Synopsis} @@ -871,7 +955,7 @@ reloc_howto_type *bfd_default_reloc_type_lookup @end example @strong{Description}@* Provides a default relocation lookup routine for any architecture. -@* + @findex bfd_get_reloc_code_name @subsubsection @code{bfd_get_reloc_code_name} @strong{Synopsis} @@ -881,7 +965,7 @@ const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code); @strong{Description}@* Provides a printable name for the supplied relocation code. Useful mainly for printing error messages. -@* + @findex bfd_generic_relax_section @subsubsection @code{bfd_generic_relax_section} @strong{Synopsis} @@ -895,7 +979,7 @@ boolean bfd_generic_relax_section @strong{Description}@* Provides default handling for relaxing for back ends which don't do relaxing -- i.e., does nothing. -@* + @findex bfd_generic_get_relocated_section_contents @subsubsection @code{bfd_generic_get_relocated_section_contents} @strong{Synopsis} @@ -911,4 +995,4 @@ bfd_generic_get_relocated_section_contents (bfd *abfd, @strong{Description}@* Provides default handling of relocation effort for back ends which can't be bothered to do it efficiently. -@* + diff --git a/contrib/binutils/bfd/doc/section.texi b/contrib/binutils/bfd/doc/section.texi index d5ff109..24625c2 100644 --- a/contrib/binutils/bfd/doc/section.texi +++ b/contrib/binutils/bfd/doc/section.texi @@ -12,7 +12,7 @@ Sections are supported in BFD in @code{section.c}. * typedef asection:: * section prototypes:: @end menu -@* + @node Section Input, Section Output, Sections, Sections @subsection Section input When a BFD is opened for reading, the section structures are @@ -42,7 +42,7 @@ size of the data. An IEEE-695 file doesn't contain raw data in sections, but data and relocation expressions intermixed, so the data area has to be parsed to get out the data and relocations. -@* + @node Section Output, typedef asection, Section Input, Sections @subsection Section output To write a new object style BFD, the various sections to be @@ -81,7 +81,7 @@ structures would look like: size 0x103 | output_section --------| @end example -@* + @subsection Link orders The data within a section is stored in a @dfn{link_order}. These are much like the fixups in @code{gas}. The link_order @@ -98,14 +98,15 @@ select whether to relax. Sometimes relaxing takes a lot of time. The linker runs around the relocations to see if any are attached to data which can be shrunk, if so it does it on a link_order by link_order basis. -@* + @node typedef asection, section prototypes, Section Output, Sections @subsection typedef asection Here is the section structure: -@* -. + + @example + typedef struct sec @{ /* The name of the section; the name isn't a copy, the pointer is @@ -201,7 +202,7 @@ typedef struct sec multiple times, the value of a symbol is the amount of space it requires, and the largest symbol value is the one used). Most targets have exactly one of these (which we - translate to bfd_com_section_ptr), but ECOFF has two. */ + translate to bfd_com_section_ptr), but ECOFF has two. */ #define SEC_IS_COMMON 0x8000 /* The section contains only debugging information. For @@ -217,76 +218,76 @@ typedef struct sec #define SEC_IN_MEMORY 0x20000 /* The contents of this section are to be excluded by the - linker for executable and shared objects unless those - objects are to be further relocated. */ + linker for executable and shared objects unless those + objects are to be further relocated. */ #define SEC_EXCLUDE 0x40000 - /* The contents of this section are to be sorted by the - based on the address specified in the associated symbol - table. */ + /* The contents of this section are to be sorted by the + based on the address specified in the associated symbol + table. */ #define SEC_SORT_ENTRIES 0x80000 - /* When linking, duplicate sections of the same name should be - discarded, rather than being combined into a single section as - is usually done. This is similar to how common symbols are - handled. See SEC_LINK_DUPLICATES below. */ + /* When linking, duplicate sections of the same name should be + discarded, rather than being combined into a single section as + is usually done. This is similar to how common symbols are + handled. See SEC_LINK_DUPLICATES below. */ #define SEC_LINK_ONCE 0x100000 - /* If SEC_LINK_ONCE is set, this bitfield describes how the linker - should handle duplicate sections. */ + /* If SEC_LINK_ONCE is set, this bitfield describes how the linker + should handle duplicate sections. */ #define SEC_LINK_DUPLICATES 0x600000 - /* This value for SEC_LINK_DUPLICATES means that duplicate - sections with the same name should simply be discarded. */ + /* This value for SEC_LINK_DUPLICATES means that duplicate + sections with the same name should simply be discarded. */ #define SEC_LINK_DUPLICATES_DISCARD 0x0 - /* This value for SEC_LINK_DUPLICATES means that the linker - should warn if there are any duplicate sections, although - it should still only link one copy. */ + /* This value for SEC_LINK_DUPLICATES means that the linker + should warn if there are any duplicate sections, although + it should still only link one copy. */ #define SEC_LINK_DUPLICATES_ONE_ONLY 0x200000 - /* This value for SEC_LINK_DUPLICATES means that the linker - should warn if any duplicate sections are a different size. */ + /* This value for SEC_LINK_DUPLICATES means that the linker + should warn if any duplicate sections are a different size. */ #define SEC_LINK_DUPLICATES_SAME_SIZE 0x400000 - /* This value for SEC_LINK_DUPLICATES means that the linker - should warn if any duplicate sections contain different - contents. */ + /* This value for SEC_LINK_DUPLICATES means that the linker + should warn if any duplicate sections contain different + contents. */ #define SEC_LINK_DUPLICATES_SAME_CONTENTS 0x600000 - /* This section was created by the linker as part of dynamic - relocation or other arcane processing. It is skipped when - going through the first-pass output, trusting that someone - else up the line will take care of it later. */ + /* This section was created by the linker as part of dynamic + relocation or other arcane processing. It is skipped when + going through the first-pass output, trusting that someone + else up the line will take care of it later. */ #define SEC_LINKER_CREATED 0x800000 - /* End of section flags. */ + /* End of section flags. */ - /* Some internal packed boolean fields. */ + /* Some internal packed boolean fields. */ - /* See the vma field. */ - unsigned int user_set_vma : 1; + /* See the vma field. */ + unsigned int user_set_vma : 1; - /* Whether relocations have been processed. */ - unsigned int reloc_done : 1; + /* Whether relocations have been processed. */ + unsigned int reloc_done : 1; - /* A mark flag used by some of the linker backends. */ - unsigned int linker_mark : 1; + /* A mark flag used by some of the linker backends. */ + unsigned int linker_mark : 1; - /* End of internal packed boolean fields. */ + /* End of internal packed boolean fields. */ /* The virtual memory address of the section - where it will be at run time. The symbols are relocated against this. The - user_set_vma flag is maintained by bfd; if it's not set, the - backend can assign addresses (for example, in @code{a.out}, where - the default address for @code{.data} is dependent on the specific - target and various flags). */ + user_set_vma flag is maintained by bfd; if it's not set, the + backend can assign addresses (for example, in @code{a.out}, where + the default address for @code{.data} is dependent on the specific + target and various flags). */ bfd_vma vma; /* The load address of the section - where it would be in a rom image; really only used for writing section header - information. */ + information. */ bfd_vma lma; @@ -297,8 +298,8 @@ typedef struct sec bfd_size_type _cooked_size; /* The original size on disk of the section, in bytes. Normally this - value is the same as the size, but if some relaxing has - been done, then this value will be bigger. */ + value is the same as the size, but if some relaxing has + been done, then this value will be bigger. */ bfd_size_type _raw_size; @@ -383,7 +384,7 @@ typedef struct sec bfd *owner; - /* A symbol which points at this section only */ + /* A symbol which points at this section only */ struct symbol_cache_entry *symbol; struct symbol_cache_entry **symbol_ptr_ptr; @@ -393,7 +394,7 @@ typedef struct sec /* These sections are global, and are managed by BFD. The application and target back end are not permitted to change the values in - these sections. New code should use the section_ptr macros rather + these sections. New code should use the section_ptr macros rather than referring directly to the const sections. The const sections may eventually vanish. */ #define BFD_ABS_SECTION_NAME "*ABS*" @@ -430,7 +431,7 @@ extern const struct symbol_cache_entry * const bfd_ind_symbol; @node section prototypes, , typedef asection, Sections @subsection Section prototypes These are the functions exported by the section handling part of BFD. -@* + @findex bfd_get_section_by_name @subsubsection @code{bfd_get_section_by_name} @strong{Synopsis} @@ -446,7 +447,7 @@ This should only be used in special cases; the normal way to process all sections of a given name is to use @code{bfd_map_over_sections} and @code{strcmp} on the name (or better yet, base it on the section flags or something else) for each section. -@* + @findex bfd_make_section_old_way @subsubsection @code{bfd_make_section_old_way} @strong{Synopsis} @@ -473,7 +474,7 @@ If output has already started for this BFD. @code{bfd_error_no_memory} - If memory allocation fails. @end itemize -@* + @findex bfd_make_section_anyway @subsubsection @code{bfd_make_section_anyway} @strong{Synopsis} @@ -493,7 +494,7 @@ Return @code{NULL} and set @code{bfd_error} on error; possible errors are: @item @code{bfd_error_no_memory} - If memory allocation fails. @end itemize -@* + @findex bfd_make_section @subsubsection @code{bfd_make_section} @strong{Synopsis} @@ -505,7 +506,7 @@ Like @code{bfd_make_section_anyway}, but return @code{NULL} (without calling bfd_set_error ()) without changing the section chain if there is already a section named @var{name}. If there is an error, return @code{NULL} and set @code{bfd_error}. -@* + @findex bfd_set_section_flags @subsubsection @code{bfd_set_section_flags} @strong{Synopsis} @@ -525,7 +526,7 @@ The section cannot have one or more of the attributes requested. For example, a .bss section in @code{a.out} may not have the @code{SEC_HAS_CONTENTS} field set. @end itemize -@* + @findex bfd_map_over_sections @subsubsection @code{bfd_map_over_sections} @strong{Synopsis} @@ -542,18 +543,18 @@ attached to the BFD @var{abfd}, passing @var{obj} as an argument. The function will be called as if by @example - func(abfd, the_section, obj); + func(abfd, the_section, obj); @end example This is the prefered method for iterating over sections; an alternative would be to use a loop: @example - section *p; - for (p = abfd->sections; p != NULL; p = p->next) - func(abfd, p, ...) + section *p; + for (p = abfd->sections; p != NULL; p = p->next) + func(abfd, p, ...) @end example -@* + @findex bfd_set_section_size @subsubsection @code{bfd_set_section_size} @strong{Synopsis} @@ -571,7 +572,7 @@ Possible error returns: @code{bfd_error_invalid_operation} - Writing has started to the BFD, so setting the size is invalid. @end itemize -@* + @findex bfd_set_section_contents @subsubsection @code{bfd_set_section_contents} @strong{Synopsis} @@ -602,7 +603,7 @@ and some more too @end itemize This routine is front end to the back end function @code{_bfd_set_section_contents}. -@* + @findex bfd_get_section_contents @subsubsection @code{bfd_get_section_contents} @strong{Synopsis} @@ -622,7 +623,7 @@ flag set are requested or if the section does not have the @code{SEC_HAS_CONTENTS} flag set, then the @var{location} is filled with zeroes. If no errors occur, @code{true} is returned, else @code{false}. -@* + @findex bfd_copy_private_section_data @subsubsection @code{bfd_copy_private_section_data} @strong{Synopsis} @@ -644,6 +645,6 @@ Not enough memory exists to create private data for @var{osec}. @example #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \ BFD_SEND (obfd, _bfd_copy_private_section_data, \ - (ibfd, isection, obfd, osection)) + (ibfd, isection, obfd, osection)) @end example -@* + diff --git a/contrib/binutils/bfd/doc/syms.texi b/contrib/binutils/bfd/doc/syms.texi index 034f086..48593f4 100644 --- a/contrib/binutils/bfd/doc/syms.texi +++ b/contrib/binutils/bfd/doc/syms.texi @@ -29,7 +29,7 @@ the scenes'' information will be still available. * typedef asymbol:: * symbol handling functions:: @end menu -@* + @node Reading Symbols, Writing Symbols, Symbols, Symbols @subsection Reading symbols There are two stages to reading a symbol table from a BFD: @@ -37,35 +37,35 @@ allocating storage, and the actual reading process. This is an excerpt from an application which reads the symbol table: @example - long storage_needed; - asymbol **symbol_table; - long number_of_symbols; - long i; + long storage_needed; + asymbol **symbol_table; + long number_of_symbols; + long i; - storage_needed = bfd_get_symtab_upper_bound (abfd); + storage_needed = bfd_get_symtab_upper_bound (abfd); if (storage_needed < 0) FAIL - if (storage_needed == 0) @{ - return ; - @} - symbol_table = (asymbol **) xmalloc (storage_needed); - ... - number_of_symbols = - bfd_canonicalize_symtab (abfd, symbol_table); + if (storage_needed == 0) @{ + return ; + @} + symbol_table = (asymbol **) xmalloc (storage_needed); + ... + number_of_symbols = + bfd_canonicalize_symtab (abfd, symbol_table); if (number_of_symbols < 0) FAIL - for (i = 0; i < number_of_symbols; i++) @{ - process_symbol (symbol_table[i]); - @} + for (i = 0; i < number_of_symbols; i++) @{ + process_symbol (symbol_table[i]); + @} @end example All storage for the symbols themselves is in an objalloc connected to the BFD; it is freed when the BFD is closed. -@* + @node Writing Symbols, Mini Symbols, Reading Symbols, Symbols @subsection Writing symbols Writing of a symbol table is automatic when a BFD open for @@ -79,31 +79,31 @@ which has been created using @code{bfd_make_empty_symbol}. Here is an example showing the creation of a symbol table with only one element: @example - #include "bfd.h" - main() - @{ - bfd *abfd; - asymbol *ptrs[2]; - asymbol *new; - - abfd = bfd_openw("foo","a.out-sunos-big"); - bfd_set_format(abfd, bfd_object); - new = bfd_make_empty_symbol(abfd); - new->name = "dummy_symbol"; - new->section = bfd_make_section_old_way(abfd, ".text"); - new->flags = BSF_GLOBAL; - new->value = 0x12345; - - ptrs[0] = new; - ptrs[1] = (asymbol *)0; - - bfd_set_symtab(abfd, ptrs, 1); - bfd_close(abfd); - @} - - ./makesym - nm foo - 00012345 A dummy_symbol + #include "bfd.h" + main() + @{ + bfd *abfd; + asymbol *ptrs[2]; + asymbol *new; + + abfd = bfd_openw("foo","a.out-sunos-big"); + bfd_set_format(abfd, bfd_object); + new = bfd_make_empty_symbol(abfd); + new->name = "dummy_symbol"; + new->section = bfd_make_section_old_way(abfd, ".text"); + new->flags = BSF_GLOBAL; + new->value = 0x12345; + + ptrs[0] = new; + ptrs[1] = (asymbol *)0; + + bfd_set_symtab(abfd, ptrs, 1); + bfd_close(abfd); + @} + + ./makesym + nm foo + 00012345 A dummy_symbol @end example Many formats cannot represent arbitary symbol information; for @@ -111,7 +111,7 @@ instance, the @code{a.out} object format does not allow an arbitary number of sections. A symbol pointing to a section which is not one of @code{.text}, @code{.data} or @code{.bss} cannot be described. -@* + @node Mini Symbols, typedef asymbol, Writing Symbols, Symbols @subsection Mini Symbols Mini symbols provide read-only access to the symbol table. @@ -130,124 +130,125 @@ to a minisymbol, and a pointer to a structure returned by @code{bfd_make_empty_symbol}, and return a @code{asymbol} structure. The return value may or may not be the same as the value from @code{bfd_make_empty_symbol} which was passed in. -@* + @node typedef asymbol, symbol handling functions, Mini Symbols, Symbols @subsection typedef asymbol An @code{asymbol} has the form: -@* -. + + @example + typedef struct symbol_cache_entry @{ - /* A pointer to the BFD which owns the symbol. This information - is necessary so that a back end can work out what additional - information (invisible to the application writer) is carried - with the symbol. + /* A pointer to the BFD which owns the symbol. This information + is necessary so that a back end can work out what additional + information (invisible to the application writer) is carried + with the symbol. - This field is *almost* redundant, since you can use section->owner - instead, except that some symbols point to the global sections - bfd_@{abs,com,und@}_section. This could be fixed by making - these globals be per-bfd (or per-target-flavor). FIXME. */ + This field is *almost* redundant, since you can use section->owner + instead, except that some symbols point to the global sections + bfd_@{abs,com,und@}_section. This could be fixed by making + these globals be per-bfd (or per-target-flavor). FIXME. */ struct _bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field. */ - /* The text of the symbol. The name is left alone, and not copied; the - application may not alter it. */ + /* The text of the symbol. The name is left alone, and not copied; the + application may not alter it. */ CONST char *name; - /* The value of the symbol. This really should be a union of a + /* The value of the symbol. This really should be a union of a numeric value with a pointer, since some flags indicate that a pointer to another symbol is stored here. */ symvalue value; - /* Attributes of a symbol: */ + /* Attributes of a symbol: */ #define BSF_NO_FLAGS 0x00 - /* The symbol has local scope; @code{static} in @code{C}. The value - is the offset into the section of the data. */ -#define BSF_LOCAL 0x01 + /* The symbol has local scope; @code{static} in @code{C}. The value + is the offset into the section of the data. */ +#define BSF_LOCAL 0x01 - /* The symbol has global scope; initialized data in @code{C}. The - value is the offset into the section of the data. */ -#define BSF_GLOBAL 0x02 + /* The symbol has global scope; initialized data in @code{C}. The + value is the offset into the section of the data. */ +#define BSF_GLOBAL 0x02 - /* The symbol has global scope and is exported. The value is - the offset into the section of the data. */ -#define BSF_EXPORT BSF_GLOBAL /* no real difference */ + /* The symbol has global scope and is exported. The value is + the offset into the section of the data. */ +#define BSF_EXPORT BSF_GLOBAL /* no real difference */ - /* A normal C symbol would be one of: - @code{BSF_LOCAL}, @code{BSF_FORT_COMM}, @code{BSF_UNDEFINED} or - @code{BSF_GLOBAL} */ + /* A normal C symbol would be one of: + @code{BSF_LOCAL}, @code{BSF_FORT_COMM}, @code{BSF_UNDEFINED} or + @code{BSF_GLOBAL} */ - /* The symbol is a debugging record. The value has an arbitary - meaning. */ -#define BSF_DEBUGGING 0x08 + /* The symbol is a debugging record. The value has an arbitary + meaning. */ +#define BSF_DEBUGGING 0x08 - /* The symbol denotes a function entry point. Used in ELF, - perhaps others someday. */ + /* The symbol denotes a function entry point. Used in ELF, + perhaps others someday. */ #define BSF_FUNCTION 0x10 - /* Used by the linker. */ + /* Used by the linker. */ #define BSF_KEEP 0x20 #define BSF_KEEP_G 0x40 - /* A weak global symbol, overridable without warnings by - a regular global symbol of the same name. */ + /* A weak global symbol, overridable without warnings by + a regular global symbol of the same name. */ #define BSF_WEAK 0x80 /* This symbol was created to point to a section, e.g. ELF's - STT_SECTION symbols. */ + STT_SECTION symbols. */ #define BSF_SECTION_SYM 0x100 - /* The symbol used to be a common symbol, but now it is - allocated. */ + /* The symbol used to be a common symbol, but now it is + allocated. */ #define BSF_OLD_COMMON 0x200 - /* The default value for common data. */ + /* The default value for common data. */ #define BFD_FORT_COMM_DEFAULT_VALUE 0 - /* In some files the type of a symbol sometimes alters its - location in an output file - ie in coff a @code{ISFCN} symbol - which is also @code{C_EXT} symbol appears where it was - declared and not at the end of a section. This bit is set - by the target BFD part to convey this information. */ + /* In some files the type of a symbol sometimes alters its + location in an output file - ie in coff a @code{ISFCN} symbol + which is also @code{C_EXT} symbol appears where it was + declared and not at the end of a section. This bit is set + by the target BFD part to convey this information. */ #define BSF_NOT_AT_END 0x400 - /* Signal that the symbol is the label of constructor section. */ + /* Signal that the symbol is the label of constructor section. */ #define BSF_CONSTRUCTOR 0x800 - /* Signal that the symbol is a warning symbol. The name is a - warning. The name of the next symbol is the one to warn about; - if a reference is made to a symbol with the same name as the next - symbol, a warning is issued by the linker. */ + /* Signal that the symbol is a warning symbol. The name is a + warning. The name of the next symbol is the one to warn about; + if a reference is made to a symbol with the same name as the next + symbol, a warning is issued by the linker. */ #define BSF_WARNING 0x1000 - /* Signal that the symbol is indirect. This symbol is an indirect - pointer to the symbol with the same name as the next symbol. */ + /* Signal that the symbol is indirect. This symbol is an indirect + pointer to the symbol with the same name as the next symbol. */ #define BSF_INDIRECT 0x2000 - /* BSF_FILE marks symbols that contain a file name. This is used - for ELF STT_FILE symbols. */ + /* BSF_FILE marks symbols that contain a file name. This is used + for ELF STT_FILE symbols. */ #define BSF_FILE 0x4000 - /* Symbol is from dynamic linking information. */ -#define BSF_DYNAMIC 0x8000 + /* Symbol is from dynamic linking information. */ +#define BSF_DYNAMIC 0x8000 /* The symbol denotes a data object. Used in ELF, and perhaps others someday. */ -#define BSF_OBJECT 0x10000 +#define BSF_OBJECT 0x10000 flagword flags; - /* A pointer to the section to which this symbol is - relative. This will always be non NULL, there are special + /* A pointer to the section to which this symbol is + relative. This will always be non NULL, there are special sections for undefined and absolute symbols. */ struct sec *section; - /* Back end special data. */ + /* Back end special data. */ union @{ PTR p; @@ -260,7 +261,7 @@ typedef struct symbol_cache_entry @node symbol handling functions, , typedef asymbol, Symbols @subsection Symbol handling functions -@* + @findex bfd_get_symtab_upper_bound @subsubsection @code{bfd_get_symtab_upper_bound} @strong{Description}@* @@ -272,7 +273,7 @@ the BFD, then return 0. If an error occurs, return -1. #define bfd_get_symtab_upper_bound(abfd) \ BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd)) @end example -@* + @findex bfd_is_local_label @subsubsection @code{bfd_is_local_label} @strong{Synopsis} @@ -282,7 +283,7 @@ boolean bfd_is_local_label(bfd *abfd, asymbol *sym); @strong{Description}@* Return true if the given symbol @var{sym} in the BFD @var{abfd} is a compiler generated local label, else return false. -@* + @findex bfd_is_local_label_name @subsubsection @code{bfd_is_local_label_name} @strong{Synopsis} @@ -298,7 +299,7 @@ local label. #define bfd_is_local_label_name(abfd, name) \ BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name)) @end example -@* + @findex bfd_canonicalize_symtab @subsubsection @code{bfd_canonicalize_symtab} @strong{Description}@* @@ -312,7 +313,7 @@ including the NULL. BFD_SEND (abfd, _bfd_canonicalize_symtab,\ (abfd, location)) @end example -@* + @findex bfd_set_symtab @subsubsection @code{bfd_set_symtab} @strong{Synopsis} @@ -323,7 +324,7 @@ boolean bfd_set_symtab (bfd *abfd, asymbol **location, unsigned int count); Arrange that when the output BFD @var{abfd} is closed, the table @var{location} of @var{count} pointers to symbols will be written. -@* + @findex bfd_print_symbol_vandf @subsubsection @code{bfd_print_symbol_vandf} @strong{Synopsis} @@ -333,7 +334,7 @@ void bfd_print_symbol_vandf(PTR file, asymbol *symbol); @strong{Description}@* Print the value and flags of the @var{symbol} supplied to the stream @var{file}. -@* + @findex bfd_make_empty_symbol @subsubsection @code{bfd_make_empty_symbol} @strong{Description}@* @@ -348,7 +349,7 @@ information, and will cause problems later on. #define bfd_make_empty_symbol(abfd) \ BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd)) @end example -@* + @findex bfd_make_debug_symbol @subsubsection @code{bfd_make_debug_symbol} @strong{Description}@* @@ -359,13 +360,13 @@ yet to be worked out. #define bfd_make_debug_symbol(abfd,ptr,size) \ BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size)) @end example -@* + @findex bfd_decode_symclass @subsubsection @code{bfd_decode_symclass} @strong{Description}@* Return a character corresponding to the symbol class of @var{symbol}, or '?' for an unknown class. -@* + @strong{Synopsis} @example int bfd_decode_symclass(asymbol *symbol); @@ -376,7 +377,7 @@ int bfd_decode_symclass(asymbol *symbol); Fill in the basic info about symbol that nm needs. Additional info may be added by the back-ends after calling this function. -@* + @strong{Synopsis} @example void bfd_symbol_info(asymbol *symbol, symbol_info *ret); @@ -402,6 +403,6 @@ Not enough memory exists to create private data for @var{osec}. @example #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \ BFD_SEND (obfd, _bfd_copy_private_symbol_data, \ - (ibfd, isymbol, obfd, osymbol)) + (ibfd, isymbol, obfd, osymbol)) @end example -@* + diff --git a/contrib/binutils/bfd/doc/targets.texi b/contrib/binutils/bfd/doc/targets.texi index 05dce15..ccaaf40 100644 --- a/contrib/binutils/bfd/doc/targets.texi +++ b/contrib/binutils/bfd/doc/targets.texi @@ -1,6 +1,6 @@ @section Targets -@* + @strong{Description}@* Each port of BFD to a different machine requries the creation of a target back end. All the back end provides to the root @@ -54,12 +54,12 @@ type is tried to see if it recognizes the specified format. @menu * bfd_target:: @end menu -@* + @node bfd_target, , Targets, Targets @subsection bfd_target -@* + @strong{Description}@* This structure contains everything that BFD knows about a target. It includes things like its byte order, name, and which @@ -253,10 +253,10 @@ CAT(NAME,_bfd_set_private_flags),\ CAT(NAME,_bfd_print_private_bfd_data)\ /* Called to copy BFD general private data from one object file to another. */ - boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); + boolean (*_bfd_copy_private_bfd_data) PARAMS ((bfd *, bfd *)); /* Called to merge BFD general private data from one object file to a common output file when linking. */ - boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *)); + boolean (*_bfd_merge_private_bfd_data) PARAMS ((bfd *, bfd *)); /* Called to copy BFD private section data from one object file to another. */ boolean (*_bfd_copy_private_section_data) PARAMS ((bfd *, sec_ptr, @@ -264,9 +264,9 @@ CAT(NAME,_bfd_print_private_bfd_data)\ /* Called to copy BFD private symbol data from one symbol to another. */ boolean (*_bfd_copy_private_symbol_data) PARAMS ((bfd *, asymbol *, - bfd *, asymbol *)); + bfd *, asymbol *)); /* Called to set private backend flags */ - boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword)); + boolean (*_bfd_set_private_flags) PARAMS ((bfd *, flagword)); /* Called to print private BFD data */ boolean (*_bfd_print_private_bfd_data) PARAMS ((bfd *, PTR)); @@ -335,7 +335,7 @@ CAT(NAME,_minisymbol_to_symbol) struct symbol_cache_entry *, symbol_info *)); #define bfd_get_symbol_info(b,p,e) BFD_SEND(b, _bfd_get_symbol_info, (b,p,e)) - boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *)); + boolean (*_bfd_is_local_label_name) PARAMS ((bfd *, const char *)); alent * (*_get_lineno) PARAMS ((bfd *, struct symbol_cache_entry *)); boolean (*_bfd_find_nearest_line) PARAMS ((bfd *abfd, @@ -436,7 +436,7 @@ in this structure. PTR backend_data; @} bfd_target; @end example -@* + @findex bfd_set_default_target @subsubsection @code{bfd_set_default_target} @strong{Synopsis} @@ -447,7 +447,7 @@ boolean bfd_set_default_target (const char *name); Set the default target vector to use when recognizing a BFD. This takes the name of the target, which may be a BFD target name or a configuration triplet. -@* + @findex bfd_find_target @subsubsection @code{bfd_find_target} @strong{Synopsis} @@ -464,7 +464,7 @@ variable to "default" will cause the first entry in the target list to be returned, and "target_defaulted" will be set in the BFD. This causes @code{bfd_check_format} to loop over all the targets to find the one that matches the file being read. -@* + @findex bfd_target_list @subsubsection @code{bfd_target_list} @strong{Synopsis} @@ -475,4 +475,4 @@ const char **bfd_target_list(void); Return a freshly malloced NULL-terminated vector of the names of all the valid BFD targets. Do not modify the names. -@* + |
