Man Page er_src.1

NAME

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

SYNOPSIS

     er_src [ -d | -c class-list | -o filename | -V |  ]
         object [ item [ tag ] ]

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 when an object file is specified,  but  is  required
     when an executable or shared-object 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  is  printed  that  lists  the possible
     choices with their index numbers.

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.

     -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 additional fields that are available for
          the dcc command in er_print can be used in  the  class-
          list to specify the display of hexadecimal instructions
          and to control the interleaved source.  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 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 the -c option.  The files can also specify a  path
     for  a  C++  name-demangling library. See the description of
     defaults files and their processing in the  er_print(1)  man
     page.

SEE ALSO

     er_print(1), and the manual
     Program Performance Analysis Tools