This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [rfc] [11/18] Cell multi-arch: Target description <compatible> infrastructure
- From: "Ulrich Weigand" <uweigand at de dot ibm dot com>
- To: eliz at gnu dot org
- Cc: gdb-patches at sourceware dot org
- Date: Mon, 8 Sep 2008 13:45:01 +0200 (CEST)
- Subject: Re: [rfc] [11/18] Cell multi-arch: Target description <compatible> infrastructure
Eli Zaretskii wrote:
> > +@var{arch} is an architecture name from the same selection
> > +accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
> > +Debugging Target}).
>
> I don't understand the purpose of "the same" here. Same as what?
This element accepts the same set of architecture names as the set
accepted by the "set architecture" command.
The wording I've used is copied above is copied from the description
of the <architecture> element (which also accepts the same set of
architecture names). If you can suggest a clearer way to express
this, I think both places should be fixed ...
> This begs a continuation:
>
> The way to describe this capability with @samp{<compatible>} is as
> follows:
>
> @smallexample
> ...
> @end smallexample
Added. See below for an updated patch.
Thanks,
Ulrich
Index: src/gdb/doc/gdb.texinfo
===================================================================
--- src.orig/gdb/doc/gdb.texinfo
+++ src/gdb/doc/gdb.texinfo
@@ -27586,6 +27586,7 @@ are explained further below.
<!DOCTYPE target SYSTEM "gdb-target.dtd">
<target version="1.0">
@r{[}@var{architecture}@r{]}
+ @r{[}@var{compatible}@dots{}@r{]}
@r{[}@var{feature}@dots{}@r{]}
</target>
@end smallexample
@@ -27641,6 +27642,32 @@ An @samp{<architecture>} element has thi
accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
Debugging Target}).
+@subsection Compatible Architecture
+@cindex <compatible>
+
+A @samp{<compatible>} element has this form:
+
+@smallexample
+ <compatible>@var{arch}</compatible>
+@end smallexample
+
+@var{arch} is an architecture name from the same selection
+accepted by @code{set architecture} (@pxref{Targets, ,Specifying a
+Debugging Target}).
+
+A @samp{<compatible>} element is used to specify that the target
+is able to run binaries in some other than the main target architecture
+given by the @samp{<architecture>} element. For example, on the
+Cell Broadband Engine, the main architecture is @code{powerpc:common}
+or @code{powerpc:common64}, but the system is able to run binaries
+in the @code{spu} architecture as well. The way to describe this
+capability with @samp{<compatible>} is as follows:
+
+@smallexample
+ <architecture>@code{powerpc:common}</architecture>
+ <compatible>@code{spu}</compatible>
+@end smallexample
+
@subsection Features
@cindex <feature>
--
Dr. Ulrich Weigand
GNU Toolchain for Linux on System z and Cell BE
Ulrich.Weigand@de.ibm.com