Skip to content

Commit ca6eff5

Browse files
committed
gdb/doc: Clarify vCont packet description
Specifically, what happens with multiple actions that could match a thread, and what happens when we get a vCont action that matches a thread that was already running. E.g., what does: "vCont;s:2" "vCont;s:1;c" mean for thread 2. (Thread 2 continues stepping.) gdb/doc/ChangeLog: 2016-10-26 Pedro Alves <[email protected]> * gdb.texinfo (Packets): Clarify vCont packets with multiple actions that match a thread, and what happens when an action matches a thread that is already running.
1 parent ef4a339 commit ca6eff5

File tree

2 files changed

+27
-11
lines changed

2 files changed

+27
-11
lines changed

gdb/doc/ChangeLog

+6
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
2016-10-26 Pedro Alves <[email protected]>
2+
3+
* gdb.texinfo (Packets): Clarify vCont packets with multiple
4+
actions that match a thread, and what happens when an action
5+
matches a thread that is already running.
6+
17
2016-10-14 Simon Marchi <[email protected]>
28

39
* gdb.texinfo (Using Trace Files): Fix typo.

gdb/doc/gdb.texinfo

+21-11
Original file line numberDiff line numberDiff line change
@@ -35530,13 +35530,17 @@ for success in non-stop mode (@pxref{Remote Non-Stop})
3553035530
@cindex @samp{vCont} packet
3553135531
@anchor{vCont packet}
3553235532
Resume the inferior, specifying different actions for each thread.
35533-
If an action is specified with no @var{thread-id}, then it is applied to any
35534-
threads that don't have a specific action specified; if no default action is
35535-
specified then other threads should remain stopped in all-stop mode and
35536-
in their current state in non-stop mode.
35537-
Specifying multiple
35538-
default actions is an error; specifying no actions is also an error.
35539-
Thread IDs are specified using the syntax described in @ref{thread-id syntax}.
35533+
35534+
For each inferior thread, the leftmost action with a matching
35535+
@var{thread-id} is applied. Threads that don't match any action
35536+
remain in their current state. Thread IDs are specified using the
35537+
syntax described in @ref{thread-id syntax}. If multiprocess
35538+
extensions (@pxref{multiprocess extensions}) are supported, actions
35539+
can be specified to match all threads in a process by using the
35540+
@samp{p@var{pid}.-1} form of the @var{thread-id}. An action with no
35541+
@var{thread-id} is called the default action and matches all threads.
35542+
Specifying multiple default actions is an error; specifying no actions
35543+
is also an error.
3554035544

3554135545
Currently supported actions are:
3554235546

@@ -35581,11 +35585,17 @@ the corresponding stop reply should indicate that the thread has stopped with
3558135585
signal @samp{0}, regardless of whether the target uses some other signal
3558235586
as an implementation detail.
3558335587

35588+
The server must ignore @samp{c}, @samp{C}, @samp{s}, @samp{S}, and
35589+
@samp{r} actions for threads that are already running. Conversely,
35590+
the server must ignore @samp{t} actions for threads that are already
35591+
stopped.
35592+
35593+
@emph{Note:} In non-stop mode, a thread is considered running until
35594+
@value{GDBN} acknowleges an asynchronous stop notification for it with
35595+
the @samp{vStopped} packet (@pxref{Remote Non-Stop}).
35596+
3558435597
The stub must support @samp{vCont} if it reports support for
35585-
multiprocess extensions (@pxref{multiprocess extensions}). Note that in
35586-
this case @samp{vCont} actions can be specified to apply to all threads
35587-
in a process by using the @samp{p@var{pid}.-1} form of the
35588-
@var{thread-id}.
35598+
multiprocess extensions (@pxref{multiprocess extensions}).
3558935599

3559035600
Reply:
3559135601
@xref{Stop Reply Packets}, for the reply specifications.

0 commit comments

Comments
 (0)