Usage:
gprof2dot [options] [file] ...
Options:
-h, --help show this help message and exit
-o FILE, --output=FILE
output filename [stdout]
-n PERCENTAGE, --node-thres=PERCENTAGE
eliminate nodes below this threshold [default: 0.5]
-e PERCENTAGE, --edge-thres=PERCENTAGE
eliminate edges below this threshold [default: 0.1]
-f FORMAT, --format=FORMAT
profile format: axe, callgrind, collapse, dtrace, hprof, json, oprofile,
perf, prof, pstats, sleepy, sysprof or xperf [default: prof]
--total=TOTALMETHOD preferred method of calculating total time: callratios or callstacks
(currently affects only perf format) [default: callratios]
-c THEME, --colormap=THEME
color map: bw, color, gray, pink or print [default: color]
-s, --strip strip function parameters, template parameters, and const modifiers from
demangled C++ function names
--color-nodes-by-selftime
color nodes by self time, rather than by total time (sum of self and
descendants)
-w, --wrap wrap function names
--show-samples show function samples
--time-format=TIME_FORMAT
format to use for showing time values [default: %.7g]
--node-label=MEASURE measurements to on show the node (can be specified multiple times): self-
time, self-time-percentage, total-time or total-time-percentage [default:
total-time-percentage, self-time-percentage]
--list-functions=LIST_FUNCTIONS
list functions available for selection in -z or -l, requires selector
argument ( use '+' to select all). Recall that the selector argument is
used with Unix/Bash globbing/pattern matching, and that entries are
formatted '<pkg>:<linenum>:<function>'. When argument starts with '%', a
dump of all available information is performed for selected entries,
after removal of leading '%'.
-z ROOT, --root=ROOT prune call graph to show only descendants of specified root function
-l LEAF, --leaf=LEAF prune call graph to show only ancestors of specified leaf function
--depth=DEPTH prune call graph to show only descendants or ancestors until specified
depth
--skew=THEME_SKEW skew the colorization curve. Values < 1.0 give more variety to lower
percentages. Values > 1.0 give less variety to lower percentages
-p FILTER_PATHS, --path=FILTER_PATHS
Filter all modules not in a specified path
--compare Compare two graphs with almost identical structure. With this option two
files should be provided.gprof2dot.py [options] --compare [file1] [file2]
...
--compare-tolerance=TOLERANCE
Tolerance threshold for node difference (default=0.001%).If the difference
is below this value the nodes are considered identical.
--compare-only-slower
Display comparison only for function which are slower in second graph.
--compare-only-faster
Display comparison only for function which are faster in second graph.
--compare-color-by-difference
Color nodes based on the value of the difference. Nodes with the largest
differences represent the hot spots.
Options (24)
| Option | Description | Source |
|---|
-h, --help | show this help message and exit | help |
-o, --output FILE | output filename [stdout] | help |
-n, --node-thres PERCENTAGE | eliminate nodes below this threshold [default: 0.5] | help |
-e, --edge-thres PERCENTAGE | eliminate edges below this threshold [default: 0.1] | help |
-f, --format FORMAT | profile format: axe, callgrind, collapse, dtrace, hprof, json, oprofile, perf, prof, pstats, sleepy, sysprof or xperf [default: prof] | help |
--total TOTALMETHOD | preferred method of calculating total time: callratios or callstacks (currently affects only perf format) [default: callratios] | help |
-c, --colormap THEME | color map: bw, color, gray, pink or print [default: color] | help |
-s, --strip | strip function parameters, template parameters, and const modifiers from demangled C++ function names | help |
--color-nodes-by-selftime | color nodes by self time, rather than by total time (sum of self and descendants) | help |
-w, --wrap | wrap function names | help |
--show-samples | show function samples | help |
--time-format TIME_FORMAT | format to use for showing time values [default: %.7g] | help |
--node-label MEASURE | measurements to on show the node (can be specified multiple times): self- time, self-time-percentage, total-time or total-time-percentage [default: total-time-percentage, self-time-percentage] | help |
--list-functions LIST_FUNCTIONS | list functions available for selection in -z or -l, requires selector argument ( use '+' to select all). | help |
-z, --root ROOT | prune call graph to show only descendants of specified root function | help |
-l, --leaf LEAF | prune call graph to show only ancestors of specified leaf function | help |
--depth DEPTH | prune call graph to show only descendants or ancestors until specified depth | help |
--skew THEME_SKEW | skew the colorization curve. | help |
-p, --path FILTER_PATHS | Filter all modules not in a specified path | help |
--compare | Compare two graphs with almost identical structure. | help |
--compare-tolerance TOLERANCE | Tolerance threshold for node difference (default=0.001%).If the difference is below this value the nodes are considered identical. | help |
--compare-only-slower | Display comparison only for function which are slower in second graph. | help |
--compare-only-faster | Display comparison only for function which are faster in second graph. | help |
--compare-color-by-difference | Color nodes based on the value of the difference. | help |
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.