Message ID | 5322AE41.4050008@mentor.com |
---|---|
State | Superseded |
Headers | show |
> Date: Fri, 14 Mar 2014 15:22:41 +0800 > From: Hui Zhu <hui_zhu@mentor.com> > CC: Eli Zaretskii <eliz@gnu.org> > > So make a patch update doc of 'k' to: > ‘k’ > Kill all processes. > > The ‘k’ packet has no reply. Fine with me, assuming that someone who knows that code will confirm your understanding.
On 3/14/14 12:22 AM, Hui Zhu wrote: [...] > So make a patch update doc of 'k' to: > ‘k’ > Kill all processes. > > The ‘k’ packet has no reply. For old packets in the protocol, we need to be careful not to tweak the description so as to change the meaning. In this case, the effect of 'k' is not precisely specified; while the current version of GDBserver has taken it to mean "all inferiors", that may not be true of the stub I shipped to a customer four years ago. As a replacement for the FIXME, I suggest something like "Kill the target process or processes." "The exact effect of this packet is not specified. For a single-process target, it will kill that process if possible. A multiple-process target may choose to kill just one process, or all that that are under GDB's control. For more precise control, use the vKill packet." "The ‘k’ packet has no reply." It seems like it should say something about inferiors as well, but I couldn't think of how to express it clearly. Stan stan@codesourcery.com
--- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -33952,11 +33952,9 @@ step packet}. @item k @cindex @samp{k} packet -Kill request. +Kill all processes. -FIXME: @emph{There is no description of how to operate when a specific -thread context has been selected (i.e.@: does 'k' kill only that -thread?)}. +The @samp{k} packet has no reply. @item m @var{addr},@var{length} @cindex @samp{m} packet