binutils/objcopy.1

   1 .\" Copyright (c) 1991 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .TH objcopy 1 "June 1993" "cygnus support" "GNU Development Tools"
   4 .de BP
   5 .sp
   6 .ti \-.2i
   7 \(**
   8 ..
   9
  10 .SH NAME
  11 objcopy\(em\&copies and translates object files
  12
  13 .SH SYNOPSIS
  14 .hy 0
  15 .na
  16 .B objcopy
  17 .RS
  18 [
  19 .B -F \fIformat\fB | --format=\fIformat\fB
  20 ]
  21 .br
  22 [
  23 .B -I \fIformat\fB | --input-format=\fIformat\fB
  24 ]
  25 .br
  26 [
  27 .B -O \fIformat\fB | --output-format=\fIformat\fB
  28 ]
  29 .br
  30 [
  31 .B -S | --strip-all
  32 ] [
  33 .B -g | --strip-debug
  34 ]
  35 .br
  36 [
  37 .B -x | --discard-all
  38 ] [
  39 .B -X | --discard-locals
  40 ]
  41 .br
  42 [
  43 .B -v | --verbose
  44 ] [
  45 .B -V | --version
  46 ]
  47 .br
  48 .I infile
  49 [
  50 .I outfile
  51 ]
  52 .RE
  53 .SH DESCRIPTION
  54 The GNU
  55 .B objcopy
  56 utility copies the contents of an object file to another.
  57 .B objcopy
  58 uses the GNU BFD Library to read and write the object files.  It can
  59 write the destination object file in a format different from that of
  60 the source object file.  The exact behavior of
  61 .B objcopy
  62 is controlled by command-line options.
  63
  64 .B objcopy
  65 creates temporary files to do its translations and deletes them
  66 afterward.
  67 .B objcopy
  68 uses BFD to do all its translation work; it knows about all the
  69 formats BFD knows about, and thus is able to recognize most formats
  70 without being told explicitly.
  71
  72 .SH OPTIONS
  73 .TP 0.5i
  74 .I infile\fR,\fI outfile
  75 The source and output files respectively.  If you do not specify
  76 .IR outfile ,
  77 .B objcopy
  78 creates a temporary file and destructively renames the result with the
  79 name of the input file.
  80 .TP
  81 .B -I \fIformat\fB, --input-format=\fIformat\fB
  82 Consider the source file's object format to be
  83 .IR format ,
  84 rather than attempting to deduce it.
  85 .TP
  86 .B -O \fIformat\fB, --output-format=\fIformat\fB
  87 Write the output file using the object format
  88 .IR format .
  89 .TP
  90 .B -F \fIformat\fB, --format=\fIformat\fB
  91 Use
  92 .I format
  93 as the object format for both the input and the output file; i.e.
  94 simply transfer data from source to destination with no translation.
  95 .TP
  96 .B -S, --strip-all
  97 Do not copy relocation and symbol information from the source file.
  98 .TP
  99 .B -g, --strip-debug
 100 Do not copy debugging symbols from the source file.
 101 .TP
 102 .B -x, --discard-all
 103 Do not copy non-global symbols from the source file.
 104 .TP
 105 .B -X, --discard-locals
 106 Do not copy compiler-generated local symbols. (These usually start
 107 with "L" or ".").
 108 .TP
 109 .B -v, --verbose
 110 Verbose output: list all object files modified.  In the case of
 111 archives, "\fBobjcopy -V\fR" lists all members of the archive.
 112 .TP
 113 .B -V, --version
 114 Show the version number of
 115 .BR objcopy .
 116 .SH "SEE ALSO"
 117 .RB "`\|" binutils "\|'"
 118 entry in
 119 .B
 120 info\c
 121 \&;
 122 .I
 123 The GNU Binary Utilities\c
 124 \&, Roland H. Pesch (June 1993).
 125
 126 .SH COPYING
 127 Copyright (c) 1993 Free Software Foundation, Inc.
 128 .PP
 129 Permission is granted to make and distribute verbatim copies of
 130 this manual provided the copyright notice and this permission notice
 131 are preserved on all copies.
 132 .PP
 133 Permission is granted to copy and distribute modified versions of this
 134 manual under the conditions for verbatim copying, provided that the
 135 entire resulting derived work is distributed under the terms of a
 136 permission notice identical to this one.
 137 .PP
 138 Permission is granted to copy and distribute translations of this
 139 manual into another language, under the above conditions for modified
 140 versions, except that this permission notice may be included in
 141 translations approved by the Free Software Foundation instead of in
 142 the original English.