aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc/gdb.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'gdb/doc/gdb.texinfo')
-rw-r--r--gdb/doc/gdb.texinfo52
1 files changed, 33 insertions, 19 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2552511..0b34346 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -50,8 +50,7 @@ This is the @value{EDITION} Edition, @value{DATE},
of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger}
for @value{GDBN} Version @value{GDBVN}.
-Copyright (C) 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001
- Free Software Foundation, Inc.
+Copyright (C) 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001, 2002 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
@@ -60,9 +59,10 @@ Invariant Sections being ``Free Software'' and ``Free Software Needs
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software. Copies published by the Free
-Software Foundation raise funds for GNU development.''
+(a) The Free Software Foundation's Back-Cover Text is: ``You have
+freedom to copy and modify this GNU Manual, like GNU software. Copies
+published by the Free Software Foundation raise funds for GNU
+development.''
@end ifinfo
@titlepage
@@ -82,8 +82,8 @@ Software Foundation raise funds for GNU development.''
@end tex
@vskip 0pt plus 1filll
-Copyright @copyright{} 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001
- Free Software Foundation, Inc.
+Copyright @copyright{} 1988,1989,1990,1991,1992,1993,1994,1995,1996,@*
+1998,1999,2000,2001,2002 Free Software Foundation, Inc.
@sp 2
Published by the Free Software Foundation @*
59 Temple Place - Suite 330, @*
@@ -97,9 +97,10 @@ Invariant Sections being ``Free Software'' and ``Free Software Needs
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software. Copies published by the Free
-Software Foundation raise funds for GNU development.''
+(a) The Free Software Foundation's Back-Cover Text is: ``You have
+freedom to copy and modify this GNU Manual, like GNU software. Copies
+published by the Free Software Foundation raise funds for GNU
+development.''
@end titlepage
@page
@@ -149,6 +150,7 @@ Copyright (C) 1988-2001 Free Software Foundation, Inc.
* Command Line Editing:: Command Line Editing
* Using History Interactively:: Using History Interactively
* Installing GDB:: Installing GDB
+* GNU Free Documentation License:: The license for this documentation
* Index:: Index
@end menu
@@ -202,6 +204,7 @@ Copyright (C) 1988-2000 Free Software Foundation, Inc.
* Command Line Editing:: Command Line Editing
* Using History Interactively:: Using History Interactively
* Installing GDB:: Installing GDB
+* GNU Free Documentation License:: The license for this documentation
* Index:: Index
@end menu
@@ -5948,19 +5951,20 @@ user.
Examples:
@smallexample
-(@value{GDBP}) @b{passcount 5 2} // Stop on the 5th execution of tracepoint 2
+(@value{GDBP}) @b{passcount 5 2} // Stop on the 5th execution of
+@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// tracepoint 2}
(@value{GDBP}) @b{passcount 12} // Stop on the 12th execution of the
- // most recently defined tracepoint.
+@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// most recently defined tracepoint.}
(@value{GDBP}) @b{trace foo}
(@value{GDBP}) @b{pass 3}
(@value{GDBP}) @b{trace bar}
(@value{GDBP}) @b{pass 2}
(@value{GDBP}) @b{trace baz}
(@value{GDBP}) @b{pass 1} // Stop tracing when foo has been
- // executed 3 times OR when bar has
- // been executed 2 times
- // OR when baz has been executed 1 time.
+@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// executed 3 times OR when bar has}
+@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// been executed 2 times}
+@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// OR when baz has been executed 1 time.}
@end smallexample
@end table
@@ -5988,9 +5992,9 @@ and follow it immediately with @samp{end}.
@smallexample
(@value{GDBP}) @b{collect @var{data}} // collect some data
-(@value{GDBP}) @b{while-stepping 5} // single-step 5 times and collect data
+(@value{GDBP}) @b{while-stepping 5} // single-step 5 times, collect data
-(@value{GDBP}) @b{end} // signals the end of actions.
+(@value{GDBP}) @b{end} // signals the end of actions.
@end smallexample
In the following example, the action list begins with @code{collect}
@@ -6065,6 +6069,8 @@ You may abbreviate @code{while-stepping} as @code{ws} or
@kindex info tracepoints
@cindex information about tracepoints
@item info tracepoints @r{[}@var{num}@r{]}
+@c FIXME: Shouldn't there be an "at", "on", or "for" in the next
+@c sentence? - Brian Y., FSF office staff
Display information the tracepoint @var{num}. If you don't specify a
tracepoint number displays information about all the tracepoints
defined so far. For each tracepoint, the following information is
@@ -6091,8 +6097,8 @@ its action list as given by the @code{actions} command
(@value{GDBP}) @b{info trace}
Num Enb Address PassC StepC What
1 y 0x002117c4 0 0 <gdb_asm>
-2 y 0x0020dc64 0 0 in gdb_test at gdb_test.c:375
-3 y 0x0020b1f4 0 0 in collect_data at ../foo.c:1741
+2 y 0x0020dc64 0 0 in g_test at g_test.c:1375
+3 y 0x0020b1f4 0 0 in get_data at ../foo.c:41
(@value{GDBP})
@end smallexample
@@ -11062,6 +11068,8 @@ The target does not need to look up any (more) symbols.
@item
@tab reply @code{qSymbol:}@var{sym_name}
@tab
+@sp 2
+@noindent
The target requests the value of symbol @var{sym_name} (hex encoded).
@value{GDBN} may provide the value by using the
@code{qSymbol:}@var{sym_value}:@var{sym_name}
@@ -11070,6 +11078,8 @@ message, described below.
@item symbol value
@tab @code{qSymbol:}@var{sym_value}:@var{sym_name}
@tab
+@sp 1
+@noindent
Set the value of SYM_NAME to SYM_VALUE.
@item
@tab
@@ -11089,6 +11099,8 @@ The target does not need to look up any (more) symbols.
@item
@tab reply @code{qSymbol:}@var{sym_name}
@tab
+@sp 2
+@noindent
The target requests the value of a new symbol @var{sym_name} (hex encoded).
@value{GDBN} will continue to supply the values of symbols (if available),
until the target ceases to request them.
@@ -14852,6 +14864,8 @@ There is no convenient way to generate a list of all available hosts.
There are many other options available as well, but they are generally
needed for special purposes only.
+@include fdl.texi
+
@node Index
@unnumbered Index
generated by cgit v1.1 at 2025-02-07 22:09:56 +0000