NAME
er_src - print source or dissasembly with index lines and
interleaved compiler commentary
SYNOPSIS
er_src [ -func | -{source,src} item tag | -disasm item tag |
-{cc,scc,dcc} com_spec | -outfile filename | -V ]
object
DESCRIPTION
er_src is a utility that generates source listings or com-
bined 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 gen-
erating the source or disassembly for all functions in the
object. Note that the output from such reports for execut-
ables 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 available, produce a listing of the disassem-
bly 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 hexa-
decimal 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 output to stdout.
-V Print the current release version of er_src.
DEFAULTS
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 over-
ridden 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 ALSO
er_print(1) and the Performance Analyzer manual.