aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorPedro Alves <palves@redhat.com>2009-03-05 23:11:11 +0000
committerPedro Alves <palves@redhat.com>2009-03-05 23:11:11 +0000
commit32fc0df94ff6c3d88c6336e34a8e0b19045e5c83 (patch)
treef5e55c8794de5e0fbcd71cd3d7752708ed6c7967 /gdb
parentaae64587896fc361f18a6a38e988c5610276bf17 (diff)
downloadgdb-32fc0df94ff6c3d88c6336e34a8e0b19045e5c83.zip
gdb-32fc0df94ff6c3d88c6336e34a8e0b19045e5c83.tar.gz
gdb-32fc0df94ff6c3d88c6336e34a8e0b19045e5c83.tar.bz2
* gdb.texinfo (Background Execution): Better describe the set
target-async command. (Maintenance Commands): Delete description of the `maint set/show linux-async' and `maint set/show remote-async' commands.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog7
-rw-r--r--gdb/doc/gdb.texinfo45
2 files changed, 25 insertions, 27 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9f01b33..2217332 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,10 @@
+2009-03-05 Pedro Alves <pedro@codesourcery.com>
+
+ * gdb.texinfo (Background Execution): Better describe the set
+ target-async command.
+ (Maintenance Commands): Delete description of the `maint set/show
+ linux-async' and `maint set/show remote-async' commands.
+
2009-02-18 Vladimir Prus <vladimir@codesourcery.com>
* gdb.texinfo (GDB/MI Async Records): Add double-spaces
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 10e7388..5b3c50b 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4711,6 +4711,24 @@ the program to report that some thread has stopped before prompting for
another command. In background execution, @value{GDBN} immediately gives
a command prompt so that you can issue other commands while your program runs.
+You need to explicitly enable asynchronous mode before you can use
+background execution commands. You can use these commands to
+manipulate the asynchronous mode setting:
+
+@table @code
+@kindex set target-async
+@item set target-async on
+Enable asynchronous mode.
+@item set target-async off
+Disable asynchronous mode.
+@kindex show target-async
+@item show target-async
+Show the current target-async setting.
+@end table
+
+If the target doesn't support async mode, @value{GDBN} issues an error
+message if you attempt to use the background execution commands.
+
To specify background execution, add a @code{&} to the command. For example,
the background form of the @code{continue} command is @code{continue&}, or
just @code{c&}. The execution commands that accept background execution
@@ -4776,11 +4794,6 @@ only the current thread. To stop the whole program in non-stop mode,
use @code{interrupt -a}.
@end table
-You may need to explicitly enable async mode before you can use background
-execution commands, with the @code{set target-async 1} command. If the
-target doesn't support async mode, @value{GDBN} issues an error message
-if you attempt to use the background execution commands.
-
@node Thread-Specific Breakpoints
@subsection Thread-Specific Breakpoints
@@ -25402,28 +25415,6 @@ data in a @file{gmon.out} file, be sure to move it to a safe location.
Configuring with @samp{--enable-profiling} arranges for @value{GDBN} to be
compiled with the @samp{-pg} compiler option.
-@kindex maint set linux-async
-@kindex maint show linux-async
-@cindex asynchronous support
-@item maint set linux-async
-@itemx maint show linux-async
-Control the GNU/Linux native asynchronous support
-(@pxref{Background Execution}) of @value{GDBN}.
-
-GNU/Linux native asynchronous support will be disabled until you use
-the @samp{maint set linux-async} command to enable it.
-
-@kindex maint set remote-async
-@kindex maint show remote-async
-@cindex asynchronous support
-@item maint set remote-async
-@itemx maint show remote-async
-Control the remote asynchronous support
-(@pxref{Background Execution}) of @value{GDBN}.
-
-Remote asynchronous support will be disabled until you use
-the @samp{maint set remote-async} command to enable it.
-
@kindex maint show-debug-regs
@cindex x86 hardware debug registers
@item maint show-debug-regs