From 2fb860fcbc80b76dbd84958e547ddf1bdd1c4417 Mon Sep 17 00:00:00 2001 From: Pedro Alves Date: Wed, 14 Dec 2011 14:46:24 +0000 Subject: [PATCH] 2011-12-14 Pedro Alves * gdb.texinfo (Implementing a Remote Stub): Explain that you should transfer control to the stub in the startup code instead of in main. Mention the need to get past the initial breakpoint. --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/gdb.texinfo | 15 ++++++++++++--- 2 files changed, 18 insertions(+), 3 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index b295a48857e..6cd0b9be9fb 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2011-12-14 Pedro Alves + + * gdb.texinfo (Implementing a Remote Stub): Explain that you + should transfer control to the stub in the startup code instead of + in main. Mention the need to get past the initial breakpoint. + 2011-12-06 Tom Tromey * gdb.texinfo (Set Breaks): Update for new behavior. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 50c299e480d..925e66adca0 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -17536,8 +17536,8 @@ subroutines: @findex set_debug_traps @cindex remote serial stub, initialization This routine arranges for @code{handle_exception} to run when your -program stops. You must call this subroutine explicitly near the -beginning of your program. +program stops. You must call this subroutine explicitly in your +program's startup code. @item handle_exception @findex handle_exception @@ -17683,13 +17683,22 @@ Make sure you have defined the supporting low-level routines @end display @item -Insert these lines near the top of your program: +Insert these lines in your program's startup code, before the main +procedure is called: @smallexample set_debug_traps(); breakpoint(); @end smallexample +On some machines, when a breakpoint trap is raised, the hardware +automatically makes the PC point to the instruction after the +breakpoint. If your machine doesn't do that, you may need to adjust +@code{handle_exception} to arrange for it to return to the instruction +after the breakpoint on this first invocation, so that your program +doesn't keep hitting the initial breakpoint instead of making +progress. + @item For the 680x0 stub only, you need to provide a variable called @code{exceptionHook}. Normally you just use: -- 2.30.2