From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 51486 invoked by alias); 26 Oct 2015 16:11:51 -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 51477 invoked by uid 89); 26 Oct 2015 16:11:51 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.8 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout23.012.net.il Received: from mtaout23.012.net.il (HELO mtaout23.012.net.il) (80.179.55.175) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 26 Oct 2015 16:11:47 +0000 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0NWU005004XJC600@a-mtaout23.012.net.il> for gdb-patches@sourceware.org; Mon, 26 Oct 2015 18:11:44 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.94.185.246]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NWU005D44ZK9Y40@a-mtaout23.012.net.il>; Mon, 26 Oct 2015 18:11:44 +0200 (IST) Date: Mon, 26 Oct 2015 19:07:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH v1] ABI changes for Intel(R) MPX. In-reply-to: <1445864086-4831-6-git-send-email-walfred.tedeschi@intel.com> To: Walfred Tedeschi Cc: palves@redhat.com, brobecker@adacore.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83ziz5bodv.fsf@gnu.org> References: <1445864086-4831-1-git-send-email-walfred.tedeschi@intel.com> <1445864086-4831-6-git-send-email-walfred.tedeschi@intel.com> X-IsSubscribed: yes X-SW-Source: 2015-10/txt/msg00570.txt.bz2 > From: Walfred Tedeschi > Cc: gdb-patches@sourceware.org, Walfred Tedeschi > Date: Mon, 26 Oct 2015 13:54:46 +0100 > > doc: > gdb.texinfo: (Intel(R) Memory Protection Extensions): Add > documentation on performing program function calls. Is it possible to lose the "(R)" part here? It gets in the way of Emacs syntax highlighting of ChangeLog entries. > +While calling functions of an MPX enabled program boundary registers have > +to be initialized before performing the call. Intended to avoid unexpected > +side effects, as receiving a bound violation signal while performing > +the operation. Nevertheless is possible to change the boundary values if > +desired in placing a breakpoint at the end of the prologue and setting > +bound registers as wished. > +After the call is performed bound register might be keept or not for > +further investigations. The behaviour of initializing bounds on returning > +from a program function calls can be controlled and vizualized via the commands > +@table @code > +@kindex set mpx-bnd-init-on-return > +When set to 1 bound registers will be initialized when returning from a > +calling a program function > +@kindex show mpx-bnd-init-on-return > +Show the state of mpx-bnd-init-on-return. > +@end table There are a few English and Texinfo issues here, so I suggest the following minor rewording (please make sure I didn't change the meaning of what you intended to say): While calling functions of an MPX enabled program, boundary registers have to be initialized before performing the call, to avoid unexpected side effects, such as a bound violation exception, while performing the operation. Nevertheless, is possible to change the boundary values, if desired, by placing a breakpoint at the end of the prologue and setting bound registers as wished in the commands of that breakpoint. After the call is performed, a bound register might or might not be keept for further investigations. The behaviour of initializing bounds on returning from a program function calls can be controlled and displayed using the following commands: @table @code @kindex set mpx-bnd-init-on-return @item set mpx-bnd-init-on-return When set to 1, bound registers will be initialized when returning from a calling a program function. @kindex show mpx-bnd-init-on-return @item show mpx-bnd-init-on-return Show the state of @code{mpx-bnd-init-on-return}. @end table Thanks.