OS Manuals

/opt/chainguard/nemo-rl/venvs/gym/bin/gprof2dot

NeMo RL venv for NeMo Gym environments

From nemo-rl-cuda-13.0-gym 0.7.0-r23 (enterprise-packages), captured 2026-11-09 by running gprof2dot --help (exit 0). permalink

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)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
-o, --output FILEoutput filename [stdout]help
-n, --node-thres PERCENTAGEeliminate nodes below this threshold [default: 0.5]help
-e, --edge-thres PERCENTAGEeliminate edges below this threshold [default: 0.1]help
-f, --format FORMATprofile format: axe, callgrind, collapse, dtrace, hprof, json, oprofile, perf, prof, pstats, sleepy, sysprof or xperf [default: prof]help
--total TOTALMETHODpreferred method of calculating total time: callratios or callstacks (currently affects only perf format) [default: callratios]help
-c, --colormap THEMEcolor map: bw, color, gray, pink or print [default: color]help
-s, --stripstrip function parameters, template parameters, and const modifiers from demangled C++ function nameshelp
--color-nodes-by-selftimecolor nodes by self time, rather than by total time (sum of self and descendants)help
-w, --wrapwrap function nameshelp
--show-samplesshow function sampleshelp
--time-format TIME_FORMATformat to use for showing time values [default: %.7g]help
--node-label MEASUREmeasurements 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_FUNCTIONSlist functions available for selection in -z or -l, requires selector argument ( use '+' to select all).help
-z, --root ROOTprune call graph to show only descendants of specified root functionhelp
-l, --leaf LEAFprune call graph to show only ancestors of specified leaf functionhelp
--depth DEPTHprune call graph to show only descendants or ancestors until specified depthhelp
--skew THEME_SKEWskew the colorization curve.help
-p, --path FILTER_PATHSFilter all modules not in a specified pathhelp
--compareCompare two graphs with almost identical structure.help
--compare-tolerance TOLERANCETolerance threshold for node difference (default=0.001%).If the difference is below this value the nodes are considered identical.help
--compare-only-slowerDisplay comparison only for function which are slower in second graph.help
--compare-only-fasterDisplay comparison only for function which are faster in second graph.help
--compare-color-by-differenceColor 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.