STDUMP(1)STDUMP(1)


NAME
     stdump - Dumps a file of intermediate-code debugging information

SYNOPSIS
     stdump [-a] [-b] [-c] [-g] [-h] [-i] [-n number] file

DESCRIPTION
     When compiling for the old 32-bit ABI (-32), the compilers generate an
     intermediate language which is separated into binary instructions and
     debugging information, each constituting a separate file.  Use stdump
     to dump a file containing debugging information which was generated by
     the compilers.  stdump writes to the standard output.  The
     organization of the output is simple but the details of the output are
     complicated.  The detailed output is be defined here.  The output of
     stdump is subject to change and one should not rely on the output
     format remaining the same from release to release.

     The organization of the output is that for each source file
     represented in file, there may be auxiliary-symbols, local-symbols, a
     file-indirect-table, optimization-entries, procedures, and line-
     numbers.  There is only one externals-table and one dense-number-table
     in file.

     By default, stdump prints all information about all sections of the
     debugging information.  The options (described on this man page)
     restrict the output to the selected sections.

     The file may be an object file (such as produced by cc -c), an
     executable file (such as produced by ld(1) or cc(1)), or a debugging
     information file (which may be produced as described below).

     Normally, debugging information files (and instruction files) are
     placed in /tmp and removed after each compilation.  Use the -keep
     option to cc, or f77(1), to force the compiler to preserve these files
     in the target directory.  When this switch is used, the compilation of
     file.x (where x is c for C or f for FORTRAN, for example) will produce
     the intermediate files file.B (instructions) and file.T (debugging
     information).  The latter file (file.T) may be used as input to
     stdump.

     stdump accepts the following options:

     -a          Print the dense number table.  This section is empty for
                 object and executable files.

     -b          Print the externals table.

     -c          Print the local debugging symbols.  The source file name
                 is printed here.

     -g          Print the auxiliaries table.  This table has encoded in it
                 in a complex way the actual data types of all the data in
                 the symbols.  The local-symbol and externals table
                 sections show this data expanded into semi-readable text.

     -h          Print the line table.  One source line number per 32-bits
                 of executable code.

     -i          Print the File Indirect Table.

     -n number   Print information about only the source file whose number
                 is specified.  Files are numbered sequentially starting
                 with zero.

NOTES
     Do not use stdump to display the debugging information of 64-bit (-64)
     or new 32-bit ABI (-n32) object files.  Use the dwarfdump(1) command
     instead.

     To see the linking information, specify elfdump(1) instead of stdump.

FILES
     /tmp/ctmstaxxxxx    Default name of debugging information file for
                         process id xxxxx

     file.T              Name of debugging information file created by the
                         -keep option

     /usr/bin/stdump     Debugging information dump program

SEE ALSO
     elfdump(1), dwarfdump(1), cc(1), f77(1), pc(1), abi(5)