This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH] Add autoload-breakpoints [3/7] ReportAsync-doc


Hi Eli,

Thank you for your help.

On 03/17/12 18:12, Eli Zaretskii wrote:
Date: Sat, 17 Mar 2012 16:52:34 +0800
From: Hui Zhu<hui_zhu@mentor.com>
CC: Stan Shebs<stan_shebs@mentor.com>

This is patch for the doc about ReportAsync.

Thanks.


+The @value{GDBN} remote serial protocol includes @dfn{reportasync},
+packets that the stub can report status or do an operation in any time.

I don't understand the "do an operation in any time" part. What does it mean in practice?

It is means that after gdb connected with the stub, the stub can report when the inferior is running and GDB is waiting it, or inferior is stoped and GDB just control it.
It make the stub can report the status for any time.


I didn't have good words on this part to make it more clear. Could you help me with it?


When the stub wants to send a @samp{reportasync} packet, it first sends a handshake packet @samp{^} to @value{GDBN}.

+If @value{GDBN} reply a @samp{^}, the shake hands is successful.

If @value{GDBN} replies with a @samp{^}, the handshake is successful.


+If not, the shake hands is fail and this packet need to be handle
+as a simple packet.

If not, the handshake fails, and the @samp{reportasync} packet needs to be handled as a simple packet.

I will fix them.



And I don't understand what you mean by "needs to be handled as a simple packet". If that's a reference to something discussed earlier in the manual, please add here a cross-reference to that part.

That means when the stub send a shake hands package ^ and wait the reply, if it got a package that is not ^. Then the shake hands is fail. It need give up this shake hands and begin to handle this packet that it just get.
For example:
Stub send a ^ to GDB. It readchar, and got a $. It should not drop this $, After that, it will got "c#csum". It need handle the package "$c#csum".
My words in the doc is not very clear, could you help me with it?



+After shake hands, the stub can send packet to @value{GDBN}, the packet
+format is same with simple remote serial protocol.

After the handshake, the stub can send @samp{reportasync} packets to @value{GDBN}, using the same packet format as in simple remote serial protocol.

Is this only for the failed handshake?  If so, perhaps we need to tell
what happens when the handshake succeeds.

No, this is for success.
What about I change it to:
After the handshake success, the stub can send @samp{reportasync} packets to @value{GDBN}, using the same packet format as in simple remote serial protocol.


Best,
Hui


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]