The following commands control er_print display output.
Close any open output file, then open filename for subsequent output. When opening filename, clear any pre-existing content. If you specify a dash (-) instead of filename, output is written to standard output. If you specify two dashes (--) instead of filename, output is written to standard error.
Close any open output file and open filename, preserving any pre-existing content, so that subsequent output is appended to the end of the file. If filename does not exist, the functionality of the appendfile command is the same as for the outfile command.
Limit any output to the first n entries of the report, where n is an unsigned integer. If n is zero, remove any limit. If n is omitted, print the current limit.
Specify whether to use the long or the short form of function names (C++ and Java only). If shared-object-name is specified, append the shared-object name to the function name.
Set the mode to one of the following:
For Java experiments, show the Java call stacks for Java threads, and do not show housekeeping threads. The function list includes a function <JVM-System> representing aggregated time from non-Java threads. When the JVM software does not report a Java call stack, time is reported against the function <no Java callstack recorded>.
For OpenMP experiments, show reconstructed call stacks similar to those obtained when the program is compiled without OpenMP. Add special functions, with the names of form <OMP-*>, when the OpenMP runtime is performing certain operations.
For Java experiments, show the Java call stacks for Java threads when the user’s Java code is being executed, and machine call stacks when JVM code is being executed or when the JVM software does not report a Java call stack. Show the machine call stacks for housekeeping threads.
For OpenMP experiments, show compiler-generated functions representing parallelized loops, tasks, and such, which are aggregated with user functions in user mode. Add special functions, with the names of form <OMP-*>, when the OpenMP runtime is performing certain operations. Functions from the OpenMP runtime code libmtsk.so are suppressed.
For Java experiments and OpenMP experiments, show the actual native call stacks for all threads.
For all experiments other than Java experiments and OpenMP experiments, all three modes show the same data.
Set comparison mode off (compare off, the default), or on (compare on), or delta (compare delta) or ratio (compare ratio). If comparison mode is off, when multiple experiments are read the data is aggregated. If comparison is enabled, when multiple experiments are loaded separate columns of metrics are shown for the data from each experiment. If comparison mode is delta, the base experiment shows absolute metrics but the comparison experiment shows differences between it and the base. If comparison mode is ratio, the comparison experiment shows ratios between it and the base.
Comparison mode will treat each experiment or experiment-group as a separate compare group. The first experiment or experiment-group argument is the base group. If you want to include more than one experiment in a compare group, you must create an experiment-group file to use as a single argument to er_print.
Set the print mode from the string. If the string is text, printing will be done in tabular form. If the string is a single character, printing will be done as a delimiter-separated list, with the single character as the delimiter. If the string is html, printing will be formatted for an HTML table. Any other string is invalid, and the command will be ignored.
The printmode setting is used only for those commands that generate tables, such as functions, memobj, indxobj. The setting is ignored for other printing commands, including source and disassembly.