


objcopy(1)            GNU Development Tools            objcopy(1)


NNAAMMEE
       objcopy - copy and translate object files


SSYYNNOOPPSSIISS
       oobbjjccooppyy
              [--FF _b_f_d_n_a_m_e || ----ttaarrggeett==_b_f_d_n_a_m_e]
              [--II _b_f_d_n_a_m_e || ----iinnppuutt--ttaarrggeett==_b_f_d_n_a_m_e]
              [--OO _b_f_d_n_a_m_e || ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e]
              [--SS || ----ssttrriipp--aallll] [--gg || ----ssttrriipp--ddeebbuugg]
              [--xx || ----ddiissccaarrdd--aallll] [--XX || ----ddiissccaarrdd--llooccaallss]
              [--bb _b_y_t_e| --byte=_b_y_t_e]]
              [--ii _i_n_t_e_r_l_e_a_v_e| --interleave=_i_n_t_e_r_l_e_a_v_e]]
              [--vv || ----vveerrbboossee] [--VV || ----vveerrssiioonn] [----hheellpp] iinnffiillee
              [oouuttffiillee]

DDEESSCCRRIIPPTTIIOONN
       The GNU oobbjjccooppyy utility copies the contents of an object
       file to another.  oobbjjccooppyy uses the GNU BFD Library to read
       and write the object files.  It can write the destination
       object file in a format different from that of the source
       object file.  The exact behavior of oobbjjccooppyy is controlled
       by command-line options.

       oobbjjccooppyy creates temporary files to do its translations and
       deletes them afterward.  oobbjjccooppyy uses BFD to do all its
       translation work; it knows about all the formats BFD knows
       about, and thus is able to recognize most formats without
       being told explicitly.

       _i_n_f_i_l_e and _o_u_t_f_i_l_e are the source and output files
       respectively.  If you do not specify _o_u_t_f_i_l_e, oobbjjccooppyy
       creates a temporary file and destructively renames the
       result with the name of the input file.


OOPPTTIIOONNSS
       --II _b_f_d_n_a_m_e, ----iinnppuutt--ttaarrggeett==_b_f_d_n_a_m_e
              Consider the source file's object format to be
              _b_f_d_n_a_m_e, rather than attempting to deduce it.

       --OO _b_f_d_n_a_m_e, ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e
              Write the output file using the object format
              _b_f_d_n_a_m_e.

       --FF _b_f_d_n_a_m_e, ----ttaarrggeett==_b_f_d_n_a_m_e
              Use _b_f_d_n_a_m_e as the object format for both the input
              and the output file; i.e.  simply transfer data
              from source to destination with no translation.

       --SS, ----ssttrriipp--aallll
              Do not copy relocation and symbol information from
              the source file.




cygnus support              June 1993                           1





objcopy(1)            GNU Development Tools            objcopy(1)


       --gg, ----ssttrriipp--ddeebbuugg
              Do not copy debugging symbols from the source file.

       --xx,  ----ddiissccaarrdd--aallll
              Do not copy non-global symbols from the source
              file.

       --XX, ----ddiissccaarrdd--llooccaallss
              Do not copy compiler-generated local symbols.
              (These usually start with "L" or ".").

       --bb _b_y_t_e, ----bbyyttee==_b_y_t_e
              Keep only every _b_y_t_eth byte of the input file
              (header data is not affected).  _b_y_t_e can be in the
              range from 0 to the interleave-1.  This option is
              useful for creating files to program ROMs.  It is
              typically used with an srec output target.

       --ii _i_n_t_e_r_l_e_a_v_e, ----iinntteerrlleeaavvee==_i_n_t_e_r_l_e_a_v_e
              Only copy one out of every _i_n_t_e_r_l_e_a_v_e bytes.  Which
              one to copy is selected by the --bb or ----bbyyttee option.
              The default is 4.  The interleave is ignored if
              neither --bb nor ----bbyyttee is given.

       --vv, ----vveerrbboossee
              Verbose output: list all object files modified.  In
              the case of archives, "oobbjjccooppyy --VV" lists all
              members of the archive.

       --VV, ----vveerrssiioonn
              Show the version number of oobbjjccooppyy and exit.

       ----hheellpp Show a summary of the options to oobbjjccooppyy and exit.

SSEEEE AALLSSOO
       `bbiinnuuttiillss' entry in iinnffoo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
       H. Pesch (June 1993).


CCOOPPYYIINNGG
       Copyright (c) 1993 Free Software Foundation, Inc.

       Permission is granted to make and distribute verbatim
       copies of this manual provided the copyright notice and
       this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified
       versions of this manual under the conditions for verbatim
       copying, provided that the entire resulting derived work
       is distributed under the terms of a permission notice
       identical to this one.

       Permission is granted to copy and distribute translations
       of this manual into another language, under the above



cygnus support              June 1993                           2





objcopy(1)            GNU Development Tools            objcopy(1)


       conditions for modified versions, except that this
       permission notice may be included in translations approved
       by the Free Software Foundation instead of in the original
       English.





















































cygnus support              June 1993                           3


