diff options
| author | Pedro Alves <pedro@codesourcery.com> | 2009-03-05 23:11:11 +0000 |
|---|---|---|
| committer | Pedro Alves <pedro@codesourcery.com> | 2009-03-05 23:11:11 +0000 |
| commit | 6e9407b3a655b3339a97bfeb9f79e6bf8e9a90ae (patch) | |
| tree | 6bd0465e05a25a15c37df6ad51ce6df47a4cc43d | |
| parent | a31bdfa66308b389d2a94de814afafbb4f0d9ff5 (diff) | |
| download | gdb-6e9407b3a655b3339a97bfeb9f79e6bf8e9a90ae.tar.gz | |
* 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.
| -rw-r--r-- | gdb/doc/ChangeLog | 7 | ||||
| -rw-r--r-- | gdb/doc/gdb.texinfo | 45 |
2 files changed, 25 insertions, 27 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 9f01b3365a6..22173329129 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 10e7388b161..5b3c50bf995 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 |