diff mbox

[PATCH/doc] Remove fixme of packet "k"

Message ID 532BF790.90401@mentor.com
State Committed
Headers show

Commit Message

Hui Zhu March 21, 2014, 8:25 a.m. UTC
On 03/21/14 00:06, Eli Zaretskii wrote:
>> Date: Thu, 20 Mar 2014 11:44:23 +0800
>> From: Hui Zhu <hui_zhu@mentor.com>
>> CC: <stanshebs@earthlink.net>, <gdb-patches@sourceware.org>
>>
>> Updated a new version according to your comments.
>
> This version is OK, thanks.
>

Make a new patch according to your comments.
Please help me review it.

Thanks,
Hui

2014-03-21  Pedro Alves  <palves@redhat.com>
	    Stan Shebs  <stan@codesourcery.com>
	    Hui Zhu  <hui@codesourcery.com>

	* gdb.texinfo (Packets): Add anchor to "? packet".
	Remove fixme and update introduction of "k packet".
	Add anchor to "vKill packet".

Comments

Eli Zaretskii March 21, 2014, 8:38 a.m. UTC | #1
> Date: Fri, 21 Mar 2014 16:25:52 +0800
> From: Hui Zhu <hui_zhu@mentor.com>
> CC: <gdb-patches@sourceware.org>
> 
> On 03/21/14 00:06, Eli Zaretskii wrote:
> >> Date: Thu, 20 Mar 2014 11:44:23 +0800
> >> From: Hui Zhu <hui_zhu@mentor.com>
> >> CC: <stanshebs@earthlink.net>, <gdb-patches@sourceware.org>
> >>
> >> Updated a new version according to your comments.
> >
> > This version is OK, thanks.
> >
> 
> Make a new patch according to your comments.

OK.
Hui Zhu March 21, 2014, 8:59 a.m. UTC | #2
On 03/21/14 16:38, Eli Zaretskii wrote:
>> Date: Fri, 21 Mar 2014 16:25:52 +0800
>> From: Hui Zhu <hui_zhu@mentor.com>
>> CC: <gdb-patches@sourceware.org>
>>
>> On 03/21/14 00:06, Eli Zaretskii wrote:
>>>> Date: Thu, 20 Mar 2014 11:44:23 +0800
>>>> From: Hui Zhu <hui_zhu@mentor.com>
>>>> CC: <stanshebs@earthlink.net>, <gdb-patches@sourceware.org>
>>>>
>>>> Updated a new version according to your comments.
>>>
>>> This version is OK, thanks.
>>>
>>
>> Make a new patch according to your comments.
>
> OK.
>

Thanks for your help.
Committed to https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=36cb1214c9f26b4e9b42d146dcf64621b36b91df

Best,
Hui
diff mbox

Patch

--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -33742,6 +33742,7 @@  The remote target both supports and has
  
  @item ?
  @cindex @samp{?} packet
+@anchor{? packet}
  Indicate the reason the target halted.  The reply is the same as for
  step and continue.  This packet has a special interpretation when the
  target is in non-stop mode; see @ref{Remote Non-Stop}.
@@ -33954,9 +33955,25 @@  step packet}.
  @cindex @samp{k} packet
  Kill request.
  
-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 exact effect of this packet is not specified.
+
+For a bare-metal target, it may power cycle or reset the target
+system.  For that reason, the @samp{k} packet has no reply.
+
+For a single-process target, it may kill that process if possible.
+
+A multiple-process target may choose to kill just one process, or all
+that are under @value{GDBN}'s control.  For more precise control, use
+the vKill packet (@pxref{vKill packet}).
+
+If the target system immediately closes the connection in response to
+@samp{k}, @value{GDBN} does not consider the lack of packet
+acknowledgment to be an error, and assumes the kill was successful.
+
+If connected using @kbd{target extended-remote}, and the target does
+not close the connection in response to a kill request, @value{GDBN}
+probes the target state as if a new connection was opened
+(@pxref{? packet}).
  
  @item m @var{addr},@var{length}
  @cindex @samp{m} packet
@@ -34258,6 +34275,7 @@  request is completed.
  
  @item vKill;@var{pid}
  @cindex @samp{vKill} packet
+@anchor{vKill packet}
  Kill the process with the specified process ID.  @var{pid} is a
  hexadecimal integer identifying the process.  This packet is used in
  preference to @samp{k} when multiprocess protocol extensions are