The er_print utility reads settings in resource files named .er.rc from several locations to determine default values. The files are read in the following order:
System resource file /Studio-installation-dir/lib/analyzer/lib/er.rc
User's .er.rc resource file if it exists in the user's home directory.
A .er.rc resource file if it exists in the current directory from which you executed the er_print command.
The settings of each file override the settings of the files read before it. Defaults from the .er.rc file in your home directory override the system defaults, and defaults from the .er.rc file in the current directory override both home and system defaults.
Any settings in .er.rc that apply to source and disassembly compiler commentary are also used by the er_src utility.
You can use the following commands in your .er.rc file to set the defaults for er_print and er_src. You can use these commands only for setting defaults, not as input for the er_print utility.
You can include a .er.rc defaults file in your home directory to set defaults for all experiments, or in any other directory to set defaults locally. When the er_print utility, the er_src utility, or the Performance Analyzer is started, the current directory and your home directory are scanned for .er.rc files. These files are read if they are present, and the system defaults file is also read. Defaults from the .er.rc file in your home directory override the system defaults, and defaults from the .er.rc file in the current directory override both home and system defaults.
These files can contain scc, sthresh, dcc, dthresh, addpath, pathmap, name, mobj_define, indxobj_define, object_show, object_hide, object_api, compare, printmode, machinemodel, and viewmode commands, as described previously in this chapter. They can also contain the following commands, which cannot be used on either the command line or in scripts:
Specify the default metrics to be displayed or printed in the function list. The syntax and use of the metric list is described in the section Metric Lists. The order of the metric keywords in the list determines the order in which the metrics are presented.
Default metrics for the Callers-Callees list are derived from the function list default metrics by adding the corresponding attributed metric before the first occurrence of each metric name in the list.
Specify the default metric by which the function list is sorted. The sort metric is the first metric in this list that matches a metric in any loaded experiment, subject to the following conditions:
If the entry in metric-spec has a visibility string of an exclamation point, !, the first metric whose name matches is used, regardless of whether it is visible.
If the entry in metric-spec has any other visibility string, the first visible metric whose name matches is used.
The syntax and use of the metric list is described in the section Metric Lists.
The default sort metric for the Callers-Callees list is the attributed metric corresponding to the default sort metric for the function list.
Set the mode for reading descendant experiments to on (enable all descendants) or off (disable all descendants). If the =regexp is used, enable data from those experiments whose executable name matches the regular expression. The default setting is on to follow all descendants.
In reading experiments with descendants, any sub-experiments that contain little or no performance data are ignored by Performance Analyzer and er_print.