aboutsummaryrefslogtreecommitdiff
path: root/gdb/target.h
diff options
context:
space:
mode:
authorGary Benson <gbenson@redhat.com>2014-09-22 11:33:59 +0100
committerGary Benson <gbenson@redhat.com>2014-09-22 11:33:59 +0100
commit9a6cf3683df4f85f58ccea00864e36dc9ebef2ef (patch)
tree4624cb75161e7f276c602f7dd20d65a5139817a6 /gdb/target.h
parent03f4463bfce516cf7275ec2deb211c1bf2b5c67d (diff)
downloadgdb-9a6cf3683df4f85f58ccea00864e36dc9ebef2ef.zip
gdb-9a6cf3683df4f85f58ccea00864e36dc9ebef2ef.tar.gz
gdb-9a6cf3683df4f85f58ccea00864e36dc9ebef2ef.tar.bz2
Update target_stop's documentation
This commit updates target_stop's documentation to clarify that it is asynchronous. gdb/ChangeLog: * target.c (target_stop): Updated comment.
Diffstat (limited to 'gdb/target.h')
-rw-r--r--gdb/target.h6
1 files changed, 4 insertions, 2 deletions
diff --git a/gdb/target.h b/gdb/target.h
index 2ea7a2d..a679228 100644
--- a/gdb/target.h
+++ b/gdb/target.h
@@ -1573,8 +1573,10 @@ extern int target_thread_alive (ptid_t ptid);
extern void target_find_new_threads (void);
/* Make target stop in a continuable fashion. (For instance, under
- Unix, this should act like SIGSTOP). This function is normally
- used by GUIs to implement a stop button. */
+ Unix, this should act like SIGSTOP). Note that this function is
+ asynchronous: it does not wait for the target to become stopped
+ before returning. If this is the behavior you want please use
+ target_stop_and_wait. */
extern void target_stop (ptid_t ptid);