er_src - print source or dissasembly with index lines and interleaved compiler commentary
er_src [ -func | -{source,src} item tag | -disasm item tag |
-{cc,scc,dcc} com_spec | -outfile filename | -V ] object
er_src is a utility that generates source listings or combined source and disassembly listings with interleaved index lines and compiler commentary. By default, all commentary is shown.
object is the name of an executable, a shared object, an object file (.o), or a Java .class file.
item is the name of a function or of a source or object file used to build the executable or shared object; tag is an index used to determine which item is being referred to when multiple functions have the same name. It is required, but will be ignored if not necessary to resolve the function.
item may also be specified in the form function`file`, in which case the source or disassembly of the named function in the source context of the named file will be used. Users should refer to the er_print(1) man page for a description of source contexts and the annotation of source and disassembly with index lines and compiler commentary.
The special item and tag, all -1, is used to indicate generating the source or disassembly for all functions in the object. Note that the output from such reports for executables and shared objects may be very large.
The options accepted by er_src are listed below.
List all the functions from the given object.
Show the annotated source for the listed item.
Include the disassembly in the listing. The default listing does not include the disassembly. If there is no source available, produce a listing of the disassembly without index lines or compiler commentary.
If none of -func, -source, or -disasm is given, er_src defaults to -source all -1 object.
Define the compiler commentary classes to be shown. com_spec is a list of classes separated by colons. Users should refer to the er_print(1) man page for a description of these classes. The additional fields that are available for the dcc command in er_print can be used in the com_spec to specify the display of hexadecimal instructions and to control the interleaved source. The -cc option overrides any default setting (see DEFAULTS, below).
Open filename for output. If filename is a dash (-), write output to stdout.
Print the current release version of er_src.
er_src reads default settings for the display of compiler commentary classes from defaults files that are named .er.rc. The system-wide defaults file is read first, then a defaults file in the user's home directory, if present, then a defaults file in the current directory, if present. The default settings for compiler commentary classes are overridden by any -cc, -scc, or -dcc option specified.
Note: Since the defaults for the Analyzer, er_print and er_src are set by a common .er.rc file, the output of er_src may be affected by saving changes in the Analyzer's Set Data Preferences dialog, or by using any editor to change a .er.rc file. er_src will print a message to stderr naming the user .er.rc files it processed.
See the description of defaults files and their processing in the er_print(1) man page.
Performance Analyzer manual