Re: RFC: "set osabi"

[Daniel Jacobowitz <drow@mvista.com>]

On Sat, Jan 04, 2003 at 06:49:05PM -0500, Daniel Jacobowitz wrote:
> On Fri, Dec 27, 2002 at 10:47:46PM -0500, Daniel Jacobowitz wrote:
> > As promised.  I'm also looking for comments on this patch.  I know it needs
> > documentation still; that's on hold for a moment because it would conflict
> > with one of my other pending doc patches (since I want to put them in the
> > same section).  I'll do the docs before committing this.

Except I didn't.  Here they are; committed.

-- 
Daniel Jacobowitz
MontaVista Software                         Debian GNU/Linux Developer

Index: doc/ChangeLog
===================================================================
RCS file: /cvs/src/src/gdb/doc/ChangeLog,v
retrieving revision 1.253
diff -u -p -r1.253 ChangeLog
--- doc/ChangeLog	5 Jan 2003 01:38:40 -0000	1.253
+++ doc/ChangeLog	5 Jan 2003 02:03:30 -0000
@@ -1,5 +1,9 @@
 2003-01-04  Daniel Jacobowitz  <drow@mvista.com>
 
+	* gdb.texinfo (Controlling GDB): Document "set osabi".
+
+2003-01-04  Daniel Jacobowitz  <drow@mvista.com>
+
 	* gdb.texinfo (Backtraces): Document "set backtrace-below-main".
 	* gdbint.texinfo (FRAME_CHAIN_VALID): Update documentation.
 
Index: doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.134
diff -u -p -r1.134 gdb.texinfo
--- doc/gdb.texinfo	5 Jan 2003 01:38:40 -0000	1.134
+++ doc/gdb.texinfo	5 Jan 2003 02:03:34 -0000
@@ -12531,6 +12531,29 @@ application automatically.  However, som
 conclusions.  Use these commands to manage @value{GDBN}'s view of the
 current ABI.
 
+@cindex OS ABI
+@kindex set osabi
+
+One @value{GDBN} configuration can debug binaries for multiple operating
+system targets, either via remote debugging or native emulation. 
+@value{GDBN} will autodetect the @dfn{OS ABI} (Operating System ABI) in use,
+but you can override its conclusion using the @code{set osabi} command.
+One example where this is useful is in debugging of binaries which use
+an alternate C library (e.g.@: @sc{uClibc} for @sc{gnu}/Linux) which does
+not have the same identifying marks that the standard C library for your
+platform provides.
+
+@table @code
+@item show osabi
+Show the OS ABI currently in use.
+
+@item set osabi
+With no argument, show the list of registered available OS ABI's.
+
+@item set osabi @var{abi}
+Set the current OS ABI to @var{abi}.
+@end table
+
 @cindex float promotion
 @kindex set coerce-float-to-double