er_src(1)er_src(1)NAMEer_src - print source or dissasembly with index lines and interleaved
compiler commentary
SYNOPSISer_src [ -func | -{source,src} item tag | -disasm item tag |
-{cc,scc,dcc} com_spec | -outfile filename | -V ]
object
DESCRIPTIONer_src is a utility that generates source listings or combined source
and disassembly listings with interleaved index lines and compiler com‐
mentary. 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 deter‐
mine 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.
-func List all the functions from the given object.
-{source,src}
Show the annotated source for the listed item.
-disasm
Include the disassembly in the listing. The default listing
does not include the disassembly. If there is no source avail‐
able, 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.
-{cc,scc,dcc} com_spec
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).
-outfile filename
Open filename for output. If filename is a dash (-), write out‐
put to stdout.
-V Print the current release version of er_src.
DEFAULTSer_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.
SEE ALSOer_print(1) and the Performance Analyzer manual.
March 2004 er_src(1)
