home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / gcc263-utildoc.lha / gnu / man / man1 / objdump.1 < prev    next >
Encoding:
Text File  |  1994-12-19  |  9.1 KB  |  331 lines
  1.  
  2.  
  3.  
  4. objdump(1)            GNU Development Tools            objdump(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        objdump - display information from object files.
  9.  
  10.  
  11. SSYYNNOOPPSSIISS
  12.        oobbjjdduummpp
  13.               [--aa|----aarrcchhiivvee--hheeaaddeerrss] [--bb _b_f_d_n_a_m_e |
  14.               ----ttaarrggeett==_b_f_d_n_a_m_e] [--dd|----ddiissaasssseemmbbllee]
  15.               [--DD|----ddiissaasssseemmbbllee--aallll] [--ff|----ffiillee--hheeaaddeerrss]
  16.               [--hh|----sseeccttiioonn--hheeaaddeerrss | ----hheeaaddeerrss] [--ii|----iinnffoo]
  17.               [--jj _s_e_c_t_i_o_n | ----sseeccttiioonn==_s_e_c_t_i_o_n]
  18.               [--ll|----lliinnee--nnuummbbeerrss] [--mm _m_a_c_h_i_n_e |
  19.               ----aarrcchhiitteeccttuurree==_m_a_c_h_i_n_e] [--rr|----rreelloocc]
  20.               [--RR|----ddyynnaammiicc--rreelloocc] [--ss|----ffuullll--ccoonntteennttss] [----ssttaabbss]
  21.               [--tt|----ssyymmss] [--TT|----ddyynnaammiicc--ssyymmss] [--xx|----aallll--hheeaaddeerrss]
  22.               [----vveerrssiioonn] [----hheellpp] _o_b_j_f_i_l_e...
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.        oobbjjdduummpp displays information  about  one  or  more  object
  26.        files.  The options control what particular information to
  27.        display.  This information is mostly useful to programmers
  28.        who  are  working  on the compilation tools, as opposed to
  29.        programmers who just want their  program  to  compile  and
  30.        work.
  31.  
  32.        _o_b_j_f_i_l_e...  are the object files to be examined.  When you
  33.        specify archives, oobbjjdduummpp shows information on each of the
  34.        member object files.
  35.  
  36.  
  37. OOPPTTIIOONNSS
  38.        Where  long and short forms of an option are shown togeth-
  39.        er, they are equivalent.  At least one option  besides  --ll
  40.        (----lliinnee--nnuummbbeerrss) must be given.
  41.  
  42.  
  43.        --aa
  44.  
  45.        ----aarrcchhiivvee--hheeaaddeerrss
  46.               If any files from _o_b_j_f_i_l_e are archives, display the
  47.               archive header information (in a format similar  to
  48.               `llss  --ll').   Besides the information you could list
  49.               with `aarr ttvv', `oobbjjdduummpp --aa' shows  the  object  file
  50.               format of each archive member.
  51.  
  52.  
  53.        --bb _b_f_d_n_a_m_e
  54.  
  55.        ----ttaarrggeett==_b_f_d_n_a_m_e
  56.                 Specify  the  object-code  format  for the object
  57.               files to be _b_f_d_n_a_m_e.  This may  not  be  necessary;
  58.               _o_b_j_d_u_m_p  can  automatically recognize many formats.
  59.               For example,
  60.  
  61.  
  62.  
  63.  
  64. cygnus support           5 November 1991                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. objdump(1)            GNU Development Tools            objdump(1)
  71.  
  72.  
  73.               objdump -b oasys -m vax -h fu.o
  74.  
  75.  
  76.               display summary information from the section  head-
  77.               ers  (`--hh')  of `ffuu..oo', which is explicitly identi-
  78.               fied (`--mm') as a Vax object file in the format pro-
  79.               duced by Oasys compilers.  You can list the formats
  80.               available with the `--ii' option.
  81.  
  82.  
  83.        --dd
  84.  
  85.        ----ddiissaasssseemmbbllee
  86.               Display the assembler mnemonics for the machine in-
  87.               structions  from  _o_b_j_f_i_l_e.  This option only disas-
  88.               sembles those sections which are expected  to  con-
  89.               tain instructions.
  90.  
  91.  
  92.        --DD
  93.  
  94.        ----ddiissaasssseemmbbllee--aallll
  95.               Like  --dd,  but disassemble the contents of all sec-
  96.               tions, not just those expected to contain  instruc-
  97.               tions.
  98.  
  99.  
  100.        --ff
  101.  
  102.        ----ffiillee--hheeaaddeerrss
  103.               Display summary information from the overall header
  104.               of each file in _o_b_j_f_i_l_e.
  105.  
  106.  
  107.        --hh
  108.  
  109.        ----sseeccttiioonn--hheeaaddeerrss
  110.  
  111.        ----hheeaaddeerrss
  112.               Display summary information from the section  head-
  113.               ers of the object file.
  114.  
  115.  
  116.        ----hheellpp Print a summary of the options to oobbjjdduummpp and exit.
  117.  
  118.  
  119.        --ii
  120.  
  121.        ----iinnffoo Display a list showing all architectures and object
  122.               formats  available for specification with --bb or --mm.
  123.  
  124.  
  125.        --jj _n_a_m_e
  126.  
  127.  
  128.  
  129.  
  130. cygnus support           5 November 1991                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. objdump(1)            GNU Development Tools            objdump(1)
  137.  
  138.  
  139.        ----sseeccttiioonn==_n_a_m_e
  140.                Display information only for section _n_a_m_e
  141.  
  142.  
  143.        --ll
  144.  
  145.        ----lliinnee--nnuummbbeerrss
  146.               Label the  display  (using  debugging  information)
  147.               with  the  filename  and source line numbers corre-
  148.               sponding to the object  code  shown.   Only  useful
  149.               with --dd or --DD.
  150.  
  151.  
  152.        --mm _m_a_c_h_i_n_e
  153.  
  154.        ----aarrcchhiitteeccttuurree==_m_a_c_h_i_n_e
  155.                Specify the object files _o_b_j_f_i_l_e are for architec-
  156.               ture _m_a_c_h_i_n_e.  You can list available architectures
  157.               using the `--ii' option.
  158.  
  159.  
  160.        --rr
  161.  
  162.        ----rreelloocc
  163.               Print  the relocation entries of the file.  If used
  164.               with --dd or --dd, the relocations are  printed  inter-
  165.               spersed with the disassembly.
  166.  
  167.  
  168.        --RR
  169.  
  170.        ----ddyynnaammiicc--rreelloocc
  171.               Print  the  dynamic relocation entries of the file.
  172.               This is only meaningful for dynamic  objects,  such
  173.               as certain types of shared libraries.
  174.  
  175.  
  176.        --ss
  177.  
  178.        ----ffuullll--ccoonntteennttss
  179.               Display  the full contents of any sections request-
  180.               ed.
  181.  
  182.  
  183.        ----ssttaabbss
  184.               Display the contents of the .stab, .stab.index, and
  185.               .stab.excl sections from an ELF file.  This is only
  186.               useful on systems (such as Solaris  2.0)  in  which
  187.               .stab debugging symbol-table entries are carried in
  188.               an ELF section.  In most other file formats, debug-
  189.               ging  symbol-table  entries  are  interleaved  with
  190.               linkage symbols, and are visible in the --syms out-
  191.               put.
  192.  
  193.  
  194.  
  195.  
  196. cygnus support           5 November 1991                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. objdump(1)            GNU Development Tools            objdump(1)
  203.  
  204.  
  205.        --tt
  206.  
  207.        ----ssyymmss Symbol  Table.   Print  the symbol table entries of
  208.               the file.  This is similar to the information  pro-
  209.               vided by the `nnmm' program.
  210.  
  211.  
  212.        --TT
  213.  
  214.        ----ddyynnaammiicc--ssyymmss
  215.               Dynamic  Symbol  Table.   Print  the dynamic symbol
  216.               table entries of the file.  This is only meaningful
  217.               for  dynamic  objects,  such  as  certain  types of
  218.               shared libraries.  This is similar to the  informa-
  219.               tion provided by the `nnmm' program when given the --DD
  220.               ((----ddyynnaammiicc)) option.
  221.  
  222.  
  223.        ----vveerrssiioonn
  224.               Print the version number of oobbjjdduummpp and exit.
  225.  
  226.  
  227.        --xx
  228.  
  229.        ----aallll--hheeaaddeerrss
  230.               Display all available header information, including
  231.               the  symbol  table  and  relocation entries.  Using
  232.               `--xx' is equivalent to specifying all of `--aa  --ff  --hh
  233.               --rr --tt'.
  234.  
  235.  
  236. SSEEEE AALLSSOO
  237.        `bbiinnuuttiillss' entry in iinnffoo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
  238.        H. Pesch (October 1991); nnmm(11).
  239.  
  240.  
  241. CCOOPPYYIINNGG
  242.        Copyright (c) 1991 Free Software Foundation, Inc.
  243.  
  244.        Permission is granted  to  make  and  distribute  verbatim
  245.        copies  of  this  manual provided the copyright notice and
  246.        this permission notice are preserved on all copies.
  247.  
  248.        Permission is granted to copy and distribute modified ver-
  249.        sions  of  this  manual  under the conditions for verbatim
  250.        copying, provided that the entire resulting  derived  work
  251.        is  distributed  under  the  terms  of a permission notice
  252.        identical to this one.
  253.  
  254.        Permission is granted to copy and distribute  translations
  255.        of this manual into another language, under the above con-
  256.        ditions for modified versions, except that this permission
  257.        notice  may  be  included  in translations approved by the
  258.        Free Software Foundation instead of in  the  original  En-
  259.  
  260.  
  261.  
  262. cygnus support           5 November 1991                        4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. objdump(1)            GNU Development Tools            objdump(1)
  269.  
  270.  
  271.        glish.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. cygnus support           5 November 1991                        5
  329.  
  330.  
  331.