OpenE2K/binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

(Calling): Expand and elaborate text. Add "print". Add the

Browse Source 
description of problems with weak aliases.
This commit is contained in:
Eli Zaretskii 2004-10-23 14:34:54 +00:00
parent f018e82f92
commit f856860472
2 changed files with 25 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
gdb/doc/ChangeLog
View File

@ -7,6 +7,8 @@
shared libraries.
(Starting): Fix whitespace; make "elaboration" stand out where it
is first used, and add an index entry for the term.
(Calling): Expand and elaborate text. Add "print". Add the
description of problems with weak aliases.
2004-10-12 Andrew Cagney <cagney@gnu.org>

29
gdb/doc/gdb.texinfo
View File

@ -10048,18 +10048,35 @@ selected stack frame returns naturally.
@node Calling
@section Calling program functions
@cindex calling functions
@kindex call
@table @code
@cindex calling functions
@cindex inferior functions, calling
@item print @var{expr}
Evaluate the expression @var{expr} and displaying the resuling value.
@var{expr} may include calls to functions in the program being
debugged.
@kindex call
@item call @var{expr}
Evaluate the expression @var{expr} without displaying @code{void}
returned values.
@end table
You can use this variant of the @code{print} command if you want to
execute a function from your program, but without cluttering the output
with @code{void} returned values. If the result is not void, it
is printed and saved in the value history.
execute a function from your program that does not return anything
(a.k.a.@: @dfn{a void function}), but without cluttering the output
with @code{void} returned values that @value{GDBN} will otherwise
print. If the result is not void, it is printed and saved in the
value history.
@end table
@cindex weak alias functions
Sometimes, a function you wish to call is actually a @dfn{weak alias}
for another function. In such case, @value{GDBN} might not pick up
the type information, including the types of the function arguments,
which causes @value{GDBN} to call the inferior function incorrectly.
As a result, the called function will function erroneously and may
even crash. A solution to that is to use the name of the aliased
function instead.
@node Patching
@section Patching programs