Man Page er_src.1

NAME

     er_src - print source or dissasembly with  interleaved  com-
     piler commentary

SYNOPSIS

     er_src [ options ] object item tag

AVAILABILITY

     Part of Forte(TM) C, Forte C++, and Forte for  High  Perfor-
     mance Computing.

DESCRIPTION

     er_src is a utility that generates source listings  or  com-
     bined  source and disassembly listings with interleaved com-
     piler commentary.  By default, all commentary is shown.

     object is the name of an executable, a shared-object, or  an
     object file (.o).

     item is the name of a function or of a source or object file
     used  to  build  the  executable or shared object; it may be
     omitted in when an object file is specified.

     tag is an index  used  to  determine  which  item  is  being
     referred  to when multiple functions have the same name.  If
     it is not needed, it can be omitted.  If it is needed and is
     omitted, a message listing the possible choices is printed.

OPTIONS

     The options accepted by er_src are listed below.

     -d   Include the disassembly in  the  listing.  The  default
          listing  does not include the disassembly.  If there is
          no source  available,  a  listing  of  the  disassembly
          without compiler commentary is produced.

     -h   Show the hexadecimal representation of the instructions
          in  the disassembly.  The hexadecimal representation is
          not shown by default.  Ignored if  disassembly  is  not
          requested.

     -c class_list
          Define the compiler commentary  classes  to  be  shown.
          class_list  is  a  list of classes separated by colons.
          See the er_print(1) man page for a description of these
          classes.   The  -c option overrides any default setting
          (see DEFAULTS, below).

     -o filename
          Open filename for output.  If filename is a  dash  (-),
          output is written to stdout.

     -V   Print the current release version

DEFAULTS

     er_src processes  directives  from  a  .er.rc  file  in  the
     current  directory,  if  present;  from a .er.rc file in the
     user's home directory, if present; and  from  a  system-wide
     er.rc  file.   The  default settings for specifying compiler
     commentary options for  source  or  disassembly  output  are
     overridden  by er_src, which defaults to showing all commen-
     tary.  The files can also specify a path  for  a  C++  name-
     demangling library.  See the description of these directives
     and files, and their  processing,  in  the  er_print(1)  man
     page.

SEE ALSO

     analyzer(1),     collect(1),      collector(1),      dbx(1),
     er_archive(1),     er_cp(1),     er_export(1),     er_mv(1),
     er_print(1), er_rm(1), workshop(1), libcollector(3), and
     Analyzing Program Performance With Sun WorkShop.