gprof: Symspecs
4.5 Symspecs
============
Many of the output options allow functions to be included or excluded
using "symspecs" (symbol specifications), which observe the following
syntax:
filename_containing_a_dot
| funcname_not_containing_a_dot
| linenumber
| ( [ any_filename ] `:' ( any_funcname | linenumber ) )
Here are some sample symspecs:
'main.c'
Selects everything in file 'main.c'--the dot in the string tells
'gprof' to interpret the string as a filename, rather than as a
function name. To select a file whose name does not contain a dot,
a trailing colon should be specified. For example, 'odd:' is
interpreted as the file named 'odd'.
'main'
Selects all functions named 'main'.
Note that there may be multiple instances of the same function name
because some of the definitions may be local (i.e., static).
Unless a function name is unique in a program, you must use the
colon notation explained below to specify a function from a
specific source file.
Sometimes, function names contain dots. In such cases, it is
necessary to add a leading colon to the name. For example, ':.mul'
selects function '.mul'.
In some object file formats, symbols have a leading underscore.
'gprof' will normally not print these underscores. When you name a
symbol in a symspec, you should type it exactly as 'gprof' prints
it in its output. For example, if the compiler produces a symbol
'_main' from your 'main' function, 'gprof' still prints it as
'main' in its output, so you should use 'main' in symspecs.
'main.c:main'
Selects function 'main' in file 'main.c'.
'main.c:134'
Selects line 134 in file 'main.c'.
Info Catalog
gprof: Deprecated Options
gprof: Invoking