From f4b3909f865c9e06c965a1e128a8d5a4a7bfc967 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 2 Feb 2007 19:48:50 +0000 Subject: [PATCH] * gdbint.texinfo (Operation System ABI Variant Handling): Update descriptions for new/deleted elements in gdb_osabi. Add missing description for function generic_elf_osabi_sniff_abi_tag_sections. --- gdb/doc/ChangeLog | 8 ++++- gdb/doc/gdbint.texinfo | 79 ++++++++++++++++++++++++++++++------------ 2 files changed, 64 insertions(+), 23 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index c0bef5bcb5..664397a3b5 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2007-02-02 Markus Deuling (tiny change) + + * gdbint.texinfo (Operation System ABI Variant Handling): Update + descriptions for new/deleted elements in gdb_osabi. Add missing + description for function generic_elf_osabi_sniff_abi_tag_sections. + 2007-01-29 Joel Brobecker * gdb.texinfo (Maintenance Commands): Add documentation for @@ -6,7 +12,7 @@ 2007-01-26 Jan Kratochvil Eli Zaretskii - * gdb.texinfo: Describe CHAR array vs. string identifcation rules. + * gdb.texinfo: Describe CHAR array vs. string identification rules. 2007-01-26 Eli Zaretskii diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 9019f3c929..c71e1f90fb 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -2615,10 +2615,14 @@ A @dfn{handler} is used to fine-tune the @code{gdbarch} structure for the selected OS ABI. There may be only one handler for a given OS ABI for each BFD architecture. -The following OS ABI variants are defined in @file{osabi.h}: +The following OS ABI variants are defined in @file{defs.h}: @table @code +@findex GDB_OSABI_UNINITIALIZED +@item GDB_OSABI_UNINITIALIZED +Used for struct gdbarch_info if ABI is still uninitialized. + @findex GDB_OSABI_UNKNOWN @item GDB_OSABI_UNKNOWN The ABI of the inferior is unknown. The default @code{gdbarch} @@ -2626,63 +2630,87 @@ settings for the architecture will be used. @findex GDB_OSABI_SVR4 @item GDB_OSABI_SVR4 -UNIX System V Release 4 +UNIX System V Release 4. @findex GDB_OSABI_HURD @item GDB_OSABI_HURD -GNU using the Hurd kernel +GNU using the Hurd kernel. @findex GDB_OSABI_SOLARIS @item GDB_OSABI_SOLARIS -Sun Solaris +Sun Solaris. @findex GDB_OSABI_OSF1 @item GDB_OSABI_OSF1 -OSF/1, including Digital UNIX and Compaq Tru64 UNIX +OSF/1, including Digital UNIX and Compaq Tru64 UNIX. @findex GDB_OSABI_LINUX @item GDB_OSABI_LINUX -GNU using the Linux kernel +GNU using the Linux kernel. @findex GDB_OSABI_FREEBSD_AOUT @item GDB_OSABI_FREEBSD_AOUT -FreeBSD using the a.out executable format +FreeBSD using the @code{a.out} executable format. @findex GDB_OSABI_FREEBSD_ELF @item GDB_OSABI_FREEBSD_ELF -FreeBSD using the ELF executable format +FreeBSD using the ELF executable format. @findex GDB_OSABI_NETBSD_AOUT @item GDB_OSABI_NETBSD_AOUT -NetBSD using the a.out executable format +NetBSD using the @code{a.out} executable format. @findex GDB_OSABI_NETBSD_ELF @item GDB_OSABI_NETBSD_ELF -NetBSD using the ELF executable format +NetBSD using the ELF executable format. + +@findex GDB_OSABI_OPENBSD_ELF +@item GDB_OSABI_OPENBSD_ELF +OpenBSD using the ELF executable format. @findex GDB_OSABI_WINCE @item GDB_OSABI_WINCE -Windows CE +Windows CE. @findex GDB_OSABI_GO32 @item GDB_OSABI_GO32 -DJGPP +DJGPP. @findex GDB_OSABI_NETWARE @item GDB_OSABI_NETWARE -Novell NetWare +Novell NetWare. -@findex GDB_OSABI_ARM_EABI_V1 -@item GDB_OSABI_ARM_EABI_V1 -ARM Embedded ABI version 1 +@findex GDB_OSABI_IRIX +@item GDB_OSABI_IRIX +Irix. -@findex GDB_OSABI_ARM_EABI_V2 -@item GDB_OSABI_ARM_EABI_V2 -ARM Embedded ABI version 2 +@findex GDB_OSABI_LYNXOS +@item GDB_OSABI_LYNXOS +LynxOS. -@findex GDB_OSABI_ARM_APCS -@item GDB_OSABI_ARM_APCS -Generic ARM Procedure Call Standard +@findex GDB_OSABI_INTERIX +@item GDB_OSABI_INTERIX +Interix (Posix layer for MS-Windows systems). + +@findex GDB_OSABI_HPUX_ELF +@item GDB_OSABI_HPUX_ELF +HP/UX using the ELF executable format. + +@findex GDB_OSABI_HPUX_SOM +@item GDB_OSABI_HPUX_SOM +HP/UX using the SOM executable format. + +@findex GDB_OSABI_QNXNTO +@item GDB_OSABI_QNXNTO +QNX Neutrino. + +@findex GDB_OSABI_CYGWIN +@item GDB_OSABI_CYGWIN +Cygwin. + +@findex GDB_OSABI_AIX +@item GDB_OSABI_AIX +AIX. @end table @@ -2722,6 +2750,13 @@ architecture, a warning will be issued and the debugging session will continue with the defaults already established for @var{gdbarch}. @end deftypefun +@deftypefun void generic_elf_osabi_sniff_abi_tag_sections (bfd *@var{abfd}, asection *@var{sect}, void *@var{obj}) +Helper routine for ELF file sniffers. Examine the file described by +@var{abfd} and look at ABI tag note sections to determine the OS ABI +from the note. This function should be called via +@code{bfd_map_over_sections}. +@end deftypefun + @section Initializing a New Architecture Each @code{gdbarch} is associated with a single @sc{bfd} architecture,