home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / c / gcc263-utildoc.lha / gnu / man / man1 / objcopy.1 < prev    next >
Encoding:
Text File  |  1994-12-19  |  6.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. objcopy(1)            GNU Development Tools            objcopy(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        objcopy - copy and translate object files
  9.  
  10.  
  11. SSYYNNOOPPSSIISS
  12.        oobbjjccooppyy
  13.               [--FF _b_f_d_n_a_m_e || ----ttaarrggeett==_b_f_d_n_a_m_e]
  14.               [--II _b_f_d_n_a_m_e || ----iinnppuutt--ttaarrggeett==_b_f_d_n_a_m_e]
  15.               [--OO _b_f_d_n_a_m_e || ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e]
  16.               [--RR _s_e_c_t_i_o_n_n_a_m_e || ----rreemmoovvee--sseeccttiioonn==_s_e_c_t_i_o_n_n_a_m_e]
  17.               [--SS || ----ssttrriipp--aallll] [--gg || ----ssttrriipp--ddeebbuugg]
  18.               [--xx || ----ddiissccaarrdd--aallll] [--XX || ----ddiissccaarrdd--llooccaallss]
  19.               [--bb _b_y_t_e| --byte=_b_y_t_e]]
  20.               [--ii _i_n_t_e_r_l_e_a_v_e| --interleave=_i_n_t_e_r_l_e_a_v_e]]
  21.               [--vv || ----vveerrbboossee] [--VV || ----vveerrssiioonn] [----hheellpp] iinnffiillee
  22.               [oouuttffiillee]
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.        The GNU oobbjjccooppyy utility copies the contents of an object
  26.        file to another.  oobbjjccooppyy uses the GNU BFD Library to read
  27.        and write the object files.  It can write the destination
  28.        object file in a format different from that of the source
  29.        object file.  The exact behavior of oobbjjccooppyy is controlled
  30.        by command-line options.
  31.  
  32.        oobbjjccooppyy creates temporary files to do its translations and
  33.        deletes them afterward.  oobbjjccooppyy uses BFD to do all its
  34.        translation work; it knows about all the formats BFD knows
  35.        about, and thus is able to recognize most formats without
  36.        being told explicitly.
  37.  
  38.        _i_n_f_i_l_e and _o_u_t_f_i_l_e are the source and output files
  39.        respectively.  If you do not specify _o_u_t_f_i_l_e, oobbjjccooppyy
  40.        creates a temporary file and destructively renames the
  41.        result with the name of the input file.
  42.  
  43.  
  44. OOPPTTIIOONNSS
  45.        --II _b_f_d_n_a_m_e, ----iinnppuutt--ttaarrggeett==_b_f_d_n_a_m_e
  46.               Consider the source file's object format to be
  47.               _b_f_d_n_a_m_e, rather than attempting to deduce it.
  48.  
  49.        --OO _b_f_d_n_a_m_e, ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e
  50.               Write the output file using the object format
  51.               _b_f_d_n_a_m_e.
  52.  
  53.        --FF _b_f_d_n_a_m_e, ----ttaarrggeett==_b_f_d_n_a_m_e
  54.               Use _b_f_d_n_a_m_e as the object format for both the input
  55.               and the output file; i.e.  simply transfer data
  56.               from source to destination with no translation.
  57.  
  58.        --RR _s_e_c_t_i_o_n_n_a_m_e, ----rreemmoovvee--sseeccttiioonn==_s_e_c_t_i_o_n_n_a_m_e
  59.               Remove the named section from the file.  This
  60.               option may be given more than once.  Note that
  61.  
  62.  
  63.  
  64. cygnus support              June 1993                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. objcopy(1)            GNU Development Tools            objcopy(1)
  71.  
  72.  
  73.               using this option inappropriately may make the
  74.               output file unusable.
  75.  
  76.        --SS, ----ssttrriipp--aallll
  77.               Do not copy relocation and symbol information from
  78.               the source file.
  79.  
  80.        --gg, ----ssttrriipp--ddeebbuugg
  81.               Do not copy debugging symbols from the source file.
  82.  
  83.        --xx,  ----ddiissccaarrdd--aallll
  84.               Do not copy non-global symbols from the source
  85.               file.
  86.  
  87.        --XX, ----ddiissccaarrdd--llooccaallss
  88.               Do not copy compiler-generated local symbols.
  89.               (These usually start with "L" or ".").
  90.  
  91.        --bb _b_y_t_e, ----bbyyttee==_b_y_t_e
  92.               Keep only every _b_y_t_eth byte of the input file
  93.               (header data is not affected).  _b_y_t_e can be in the
  94.               range from 0 to the interleave-1.  This option is
  95.               useful for creating files to program ROMs.  It is
  96.               typically used with an srec output target.
  97.  
  98.        --ii _i_n_t_e_r_l_e_a_v_e, ----iinntteerrlleeaavvee==_i_n_t_e_r_l_e_a_v_e
  99.               Only copy one out of every _i_n_t_e_r_l_e_a_v_e bytes.  Which
  100.               one to copy is selected by the --bb or ----bbyyttee option.
  101.               The default is 4.  The interleave is ignored if
  102.               neither --bb nor ----bbyyttee is given.
  103.  
  104.        --vv, ----vveerrbboossee
  105.               Verbose output: list all object files modified.  In
  106.               the case of archives, "oobbjjccooppyy --VV" lists all
  107.               members of the archive.
  108.  
  109.        --VV, ----vveerrssiioonn
  110.               Show the version number of oobbjjccooppyy and exit.
  111.  
  112.        ----hheellpp Show a summary of the options to oobbjjccooppyy and exit.
  113.  
  114. SSEEEE AALLSSOO
  115.        `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
  116.        H. Pesch (June 1993).
  117.  
  118.  
  119. CCOOPPYYIINNGG
  120.        Copyright (c) 1993 Free Software Foundation, Inc.
  121.  
  122.        Permission is granted to make and distribute verbatim
  123.        copies of this manual provided the copyright notice and
  124.        this permission notice are preserved on all copies.
  125.  
  126.        Permission is granted to copy and distribute modified
  127.  
  128.  
  129.  
  130. cygnus support              June 1993                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. objcopy(1)            GNU Development Tools            objcopy(1)
  137.  
  138.  
  139.        versions of this manual under the conditions for verbatim
  140.        copying, provided that the entire resulting derived work
  141.        is distributed under the terms of a permission notice
  142.        identical to this one.
  143.  
  144.        Permission is granted to copy and distribute translations
  145.        of this manual into another language, under the above
  146.        conditions for modified versions, except that this
  147.        permission notice may be included in translations approved
  148.        by the Free Software Foundation instead of in the original
  149.        English.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. cygnus support              June 1993                           3
  197.  
  198.  
  199.