Re: [RFA] Darwin/x86 port (v4 - part 0/4)

Tristan Gingold
2008-11-17T09:39:11Z

On Nov 14, 2008, at 7:42 PM, Eli Zaretskii wrote:
>> *** gdb/NEWS 22 Oct 2008 22:14:21 -0000 1.292
>> + * New native configurations
>> +
>> + x86 Darwin i[34567]86-*-darwin*
>> +
>
> This is okay, but I thought you also support x86_64?

Right. What about:

* New native configurations

x86/x86_64 Darwin i[34567]86-*-darwin*

I realized that we don't support configuring as x86_64-*-darwin*.
Maybe I should
add it ?

>> The bigger the value is the more verbose the output is.
>
> Suggest to rephrase:
>
> "Higher values produce more verbose output."
>
> If you agree, please make this change in all the other places you use
> a similar phrase.

Sure. English is not my native language and I sometimes don't pick
the right word.

>> + @item set debug mach-o @var{num}
>> + @kindex set debug mach-o
>> + When set to a non zero value, enables debugging messages specific
>> to
>> mach-o
>> + object file processing. The bigger the value is the more verbose
>> the
>
> Do all Darwin developers know what is "mach-o object file processing"?
> If not, perhaps a sentence or two of explanations are due.

Ok.

>> + If on any inferior faults (but single stepping and
>> + breakpoint) will be reported as a mach exception before being
>> reported to
>> + the kernel.
>
> "If on, any inferior faults (except single stepping and breakpoint
> traps) will be announced as mach exceptions before being reported to
> the kernel."
>
> To tell the truth, I don't really understand the meaning of the
> mach-exceptions option, nor when it will be useful to GDB users. Can
> you explain?

I tried to explain better in the documentation. Basically it is
useful to understand the
reason of why a signal was sent.

Here is the updated doc patch.

Thank you for your comments,
Tristan.

+ @node Darwin
+ @subsection Darwin
+ @cindex Darwin
+
+ @value{GDBN} provides the following commands specific to the Darwin
target:
+
+ @table @code
+ @item set debug darwin @var{num}
+ @kindex set debug darwin
+ When set to a non zero value, enables debugging messages specific to
+ the Darwin support. Higher values produce more verbose output.
+
+ @item show debug darwin
+ @kindex show debug darwin
+ Show the current state of Darwin messages.
+
+ @item set debug mach-o @var{num}
+ @kindex set debug mach-o
+ When set to a non zero value, enables debugging messages while gdb is
+ reading Darwin object files. The object and executable file format
+ for Darwin is named mach-o. Higher values produce more verbose
+ output.
+
+ @item show debug mach-o
+ @kindex show debug mach-o
+ Show the current state of mach-o file messages.
+
+ @item set mach-exceptions on
+ @itemx set mach-exceptions off
+ @kindex set mach-exceptions
+ On Darwin, faults are first reported as a mach exception and then as a
+ signal. Use this command to turn on trapping of mach exceptions in
+ the inferior. This might be seldom useful to better understand the
+ cause of a fault. The default is off.
+
+ @item show mach-exceptions
+ @kindex show mach-exceptions
+ Show the current state of exceptions trapping.
+ @end table
+