objcopy(1) GNU Development Tools objcopy(1) NNAAMMEE objcopy - copy and translate object files SSYYNNOOPPSSIISS oobbjjccooppyy [--FF _b_f_d_n_a_m_e || ----ttaarrggeett==_b_f_d_n_a_m_e] [--II _b_f_d_n_a_m_e || ----iinnppuutt--ttaarrggeett==_b_f_d_n_a_m_e] [--OO _b_f_d_n_a_m_e || ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e] [--SS || ----ssttrriipp--aallll] [--gg || ----ssttrriipp--ddeebbuugg] [--xx || ----ddiissccaarrdd--aallll] [--XX || ----ddiissccaarrdd--llooccaallss] [--bb _b_y_t_e| --byte=_b_y_t_e]] [--ii _i_n_t_e_r_l_e_a_v_e| --interleave=_i_n_t_e_r_l_e_a_v_e]] [--vv || ----vveerrbboossee] [--VV || ----vveerrssiioonn] [----hheellpp] iinnffiillee [oouuttffiillee] DDEESSCCRRIIPPTTIIOONN The GNU oobbjjccooppyy utility copies the contents of an object file to another. oobbjjccooppyy 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 oobbjjccooppyy is controlled by command-line options. oobbjjccooppyy creates temporary files to do its translations and deletes them afterward. oobbjjccooppyy 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, oobbjjccooppyy creates a temporary file and destructively renames the result with the name of the input file. OOPPTTIIOONNSS --II _b_f_d_n_a_m_e, ----iinnppuutt--ttaarrggeett==_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. --OO _b_f_d_n_a_m_e, ----oouuttppuutt--ttaarrggeett==_b_f_d_n_a_m_e Write the output file using the object format _b_f_d_n_a_m_e. --FF _b_f_d_n_a_m_e, ----ttaarrggeett==_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. --SS, ----ssttrriipp--aallll Do not copy relocation and symbol information from the source file. cygnus support June 1993 1 objcopy(1) GNU Development Tools objcopy(1) --gg, ----ssttrriipp--ddeebbuugg Do not copy debugging symbols from the source file. --xx, ----ddiissccaarrdd--aallll Do not copy non-global symbols from the source file. --XX, ----ddiissccaarrdd--llooccaallss Do not copy compiler-generated local symbols. (These usually start with "L" or "."). --bb _b_y_t_e, ----bbyyttee==_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. --ii _i_n_t_e_r_l_e_a_v_e, ----iinntteerrlleeaavvee==_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 --bb or ----bbyyttee option. The default is 4. The interleave is ignored if neither --bb nor ----bbyyttee is given. --vv, ----vveerrbboossee Verbose output: list all object files modified. In the case of archives, "oobbjjccooppyy --VV" lists all members of the archive. --VV, ----vveerrssiioonn Show the version number of oobbjjccooppyy and exit. ----hheellpp Show a summary of the options to oobbjjccooppyy and exit. SSEEEE AALLSSOO `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 H. Pesch (June 1993). CCOOPPYYIINNGG 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 .