From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15694 invoked by alias); 16 Sep 2014 10:36:16 -0000 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 Received: (qmail 15649 invoked by uid 89); 16 Sep 2014 10:36:15 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Tue, 16 Sep 2014 10:36:14 +0000 Received: from int-mx09.intmail.prod.int.phx2.redhat.com (int-mx09.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s8GAa8hA014646 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 16 Sep 2014 06:36:11 -0400 Received: from [127.0.0.1] (ovpn01.gateway.prod.ext.ams2.redhat.com [10.39.146.11]) by int-mx09.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s8GAa6bB012991; Tue, 16 Sep 2014 06:36:06 -0400 Message-ID: <54181295.6030302@redhat.com> Date: Tue, 16 Sep 2014 10:36:00 -0000 From: Pedro Alves User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.1.0 MIME-Version: 1.0 To: Doug Evans , Gary Benson CC: gdb-patches Subject: Re: [PATCH 3/9 v7] Introduce target_{stop,continue}_ptid References: <21520.36381.756875.963606@ruffy2.mtv.corp.google.com> <20140911102659.GA17472@blade.nx> <5412DEB5.6020706@redhat.com> <21523.9502.168492.803068@ruffy2.mtv.corp.google.com> <54132B55.9000108@redhat.com> <21523.12189.134570.770432@ruffy2.mtv.corp.google.com> <5413305B.6020402@redhat.com> <21523.13993.986533.615240@ruffy2.mtv.corp.google.com> <54133939.70801@redhat.com> <20140915100736.GA13503@blade.nx> In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-SW-Source: 2014-09/txt/msg00521.txt.bz2 On 09/15/2014 05:00 PM, Doug Evans wrote: > On Mon, Sep 15, 2014 at 3:07 AM, Gary Benson wrote: >> Doug Evans wrote: >>> On Fri, Sep 12, 2014 at 11:19 AM, Pedro Alves wrote: >>>> On 09/12/2014 07:08 PM, Doug Evans wrote: >>>>> Pedro Alves wrote: >>>>>> I just now noticed the elephant in the room -- target_stop >>>>>> is asynchronous, doesn't wait for a stop, while and >>>>>> target_stop_ptid is synchronous. [...] >>>>> >>>>> If the above code is right, I think a clarifying comment is >>>>> required somewhere. It's odd that one can call >>>>> agent_run_command when the inferior may or may not be stopped >>>>> yet. [Or is there a bug here? - if I'm reading the gdbserver >>>>> version correctly it first waits for the inferior to stop] >>>> >>>> It's a bug. >>>> >>>> (Note that the GDB side interfaces with an out-of-tree >>>> agent, not GDBserver's agent. I don't know the status of >>>> that agent.) >>> >>> Data point that target_stop should be named target_stop_async? >> >> Ok, can I get a summary of this thread, I'm struggling to follow it. >> >> a) What should the functions be called: >> - target_stop_async / target_stop_wait >> - target_continue_async / target_continue_no_signal >> - something else? >> >> b) Is there a bug here I need to address? > > At this point I think we're still in discussion mode, there are no > conclusions/agreements yet, except for the agreement to use > target_continue_with_no_signal instead of target_continue_ptid. > > To advance the discussion, > the async case is the subtle case IMO. Evidently (and I'm just going > by what I see, there may be more data here) someone (*1) looked at the > name "target_stop" and thought it was async (which is probably what > I'd do). The function comment doesn't specify. One could argue it's > sufficient to just fix the function comment, but if we're going to > have a mix of similar functions, some of which are async and some > sync, then IMO we should also make the difference stand out in the > code where it's read. I'd be happy with a convention where all async > functions ended with _async or _no_wait (the latter reads better to > me), but I'm guessing I'd be happy with a different convention as > well. At first blush, this looks to me like looking for a generalization / hard rule where one might not be necessary, or otherwise, we'd need more a better/clearer rule/constrain on which methods this would apply to. E.g., would you rename target_xfer_partial? Certainly memory accesses can be expected to work in an asynchronous way, with read results being sent over with asynchronous notifications (even though we don't do it like that). What about target_resume? I'm not sure renaming that would be useful, for example. So I'd like to see a comprehensive list of functions that'd you're proposing would be affected in order to be able to comment further or even be able to see the same patterns you're seeing. target_stop_and_wait (the existing target_stop_ptid) isn't really a target method, unlike target_stop, target_resume, etc. -- it's a helper method that sits on top of target methods. So I'd go with clarifying target_stop's "asyncness" in its comments, name the helper target_stop_and_wait. I think that's already better than the status quo. And then we can discuss conventions and (potentially wholesale) renaming separately. It's not a big deal if we have to rename the new function again. Thanks, Pedro Alves