From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 24582 invoked by alias); 17 Nov 2008 09:39:11 -0000 Received: (qmail 24567 invoked by uid 22791); 17 Nov 2008 09:39:09 -0000 X-Spam-Check-By: sourceware.org Received: from mel.act-europe.fr (HELO mel.act-europe.fr) (212.99.106.210) by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 17 Nov 2008 09:38:34 +0000 Received: from localhost (localhost [127.0.0.1]) by filtered-smtp.eu.adacore.com (Postfix) with ESMTP id F2E7229001E; Mon, 17 Nov 2008 10:38:30 +0100 (CET) Received: from mel.act-europe.fr ([127.0.0.1]) by localhost (smtp.eu.adacore.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id gbe8G0vfXAZI; Mon, 17 Nov 2008 10:38:30 +0100 (CET) Received: from ulanbator.act-europe.fr (ulanbator.act-europe.fr [10.10.0.139]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by mel.act-europe.fr (Postfix) with ESMTP id 5C3F329001D; Mon, 17 Nov 2008 10:38:30 +0100 (CET) Cc: Eli Zaretskii Message-Id: From: Tristan Gingold To: gdb-patches@sourceware.org In-Reply-To: Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (Apple Message framework v929.2) Subject: Re: [RFA] Darwin/x86 port (v4 - part 0/4) Date: Mon, 17 Nov 2008 21:03:00 -0000 References: X-Mailer: Apple Mail (2.929.2) X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2008-11/txt/msg00433.txt.bz2 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 +