From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14046 invoked by alias); 4 Oct 2003 03:08:39 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 14039 invoked from network); 4 Oct 2003 03:08:38 -0000 Received: from unknown (HELO mx1.redhat.com) (66.187.233.31) by sources.redhat.com with SMTP; 4 Oct 2003 03:08:38 -0000 Received: from int-mx1.corp.redhat.com (int-mx1.corp.redhat.com [172.16.52.254]) by mx1.redhat.com (8.11.6/8.11.6) with ESMTP id h9438b120737 for ; Fri, 3 Oct 2003 23:08:37 -0400 Received: from pobox.corp.redhat.com (pobox.corp.redhat.com [172.16.52.156]) by int-mx1.corp.redhat.com (8.11.6/8.11.6) with ESMTP id h9438bc01427; Fri, 3 Oct 2003 23:08:37 -0400 Received: from localhost.localdomain (vpn50-46.rdu.redhat.com [172.16.50.46]) by pobox.corp.redhat.com (8.12.8/8.12.8) with ESMTP id h9438Zbe031885; Fri, 3 Oct 2003 23:08:35 -0400 Received: (from kev@localhost) by localhost.localdomain (8.11.6/8.11.6) id h9438UW24970; Fri, 3 Oct 2003 20:08:30 -0700 Date: Sat, 04 Oct 2003 03:08:00 -0000 From: Kevin Buettner Message-Id: <1031004030829.ZM24969@localhost.localdomain> To: Eli Zaretskii Subject: [RFA/doc] TARGET_ADJUST_BREAKPOINT_ADDRESS - patch 2 of 4 Cc: gdb-patches@sources.redhat.com MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-SW-Source: 2003-10/txt/msg00072.txt.bz2 [This is a repost of the patch I posted earlier, but with the correct subject line.] This is patch 2, the documentation patch for my current set of TARGET_ADJUST_BREAKPOINT_ADDRESS patch submissions. For an overview of the past history regarding this patch, see: http://sources.redhat.com/ml/gdb-patches/2003-10/msg00070.html Okay? Kevin * gdbint.texinfo (TARGET_ADJUST_BREAKPOINT_ADDRESS): Document. Index: doc/gdbint.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdbint.texinfo,v retrieving revision 1.172 diff -u -p -r1.172 gdbint.texinfo --- doc/gdbint.texinfo 2 Oct 2003 20:28:31 -0000 1.172 +++ doc/gdbint.texinfo 3 Oct 2003 23:38:30 -0000 @@ -3052,6 +3052,22 @@ custom breakpoint insertion and removal @code{BREAKPOINT_FROM_PC} needs to read the target's memory for some reason. +@item TARGET_ADJUST_BREAKPOINT_ADDRESS (@var{address}) +@findex TARGET_ADJUST_BREAKPOINT_ADDRESS +Given an address at which a breakpoint is desired, return a breakpoint +address adjusted to account for architectural constraints on +breakpoint placement. This method is not needed by most targets. + +The FR-V target (see @file{frv-tdep.c}) requires this method. The +FR-V is a VLIW architecture whose VLIW instructions consist of a +number of RISC-like subinstructions which execute in parallel. This +architecture requires that breakpoints only be placed on the first +subinstruction of a VLIW (aggregate) instruction. + +Since the adjustment of a breakpoint may radically alter a user's +expectation, @value{GDBN} prints a warning when an adjusted breakpoint +is initially set and each time that that breakpoint is hit. + @item DEPRECATED_CALL_DUMMY_WORDS @findex DEPRECATED_CALL_DUMMY_WORDS Pointer to an array of @code{LONGEST} words of data containing