binutils/size.1

   1 .\" Copyright (c) 1991 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .TH size 1 "5 November 1991" "cygnus support" "GNU Development Tools"
   4 .de BP
   5 .sp
   6 .ti \-.2i
   7 \(**
   8 ..
   9
  10 .SH NAME
  11 size\(em\&list section sizes and total size.
  12
  13 .SH SYNOPSIS
  14 .hy 0
  15 .na
  16 .TP
  17 .B size
  18 .RB "[\|" \-A \||\| \-B \||\| \c
  19 .BI "+format\ " compatibility\c
  20 \&\|]
  21 .RB "[\|" +help "\|]"
  22 .RB "[\|" \-d \||\| \-o \||\| \-x\c
  23 \||\|\c
  24 .BI "+radix\ " number\c
  25 \&\|]
  26 .RB "[\|" \c
  27 .BI "+target\ " bfdname\c
  28 \&\|]
  29 .RB "[\|" \-V \||\| +version "\|]"
  30 .I objfiles\c
  31 \&.\|.\|.
  32 .ad b
  33 .hy 1
  34 .SH DESCRIPTION
  35 The GNU \c
  36 .B size\c
  37 \& utility lists the section sizes\(em\&and the total
  38 size\(em\&for each of the object files \c
  39 .I objfiles\c
  40 \& in its argument list.
  41 By default, one line of output is generated for each object file or each
  42 module in an archive.
  43
  44 .SH OPTIONS
  45 .TP
  46 .IR "objfiles" .\|.\|.
  47 The object files to be examined.
  48
  49 .TP
  50 .B \-A
  51 .TP
  52 .B \-B
  53 .TP
  54 .BI "+format " "compatibility"\c
  55 \&
  56 Using one of these options, you can choose whether the output from GNU
  57 \c
  58 .B size\c
  59 \& resembles output from System V \c
  60 .B size\c
  61 \& (using `\|\c
  62 .B \-A\c
  63 \|',
  64 or `\|\c
  65 .B +format sysv\c
  66 \|'), or Berkeley \c
  67 .B size\c
  68 \& (using `\|\c
  69 .B \-B\c
  70 \|', or
  71 `\|\c
  72 .B +format berkeley\c
  73 \|').  The default is the one-line format similar to
  74 Berkeley's.
  75
  76 .TP
  77 .B +help
  78 Show a summary of acceptable arguments and options.
  79
  80 .TP
  81 .B \-d
  82 .TP
  83 .B \-o
  84 .TP
  85 .B \-x
  86 .TP
  87 .BI "+radix " "number"\c
  88 \&
  89 Using one of these options, you can control whether the size of each
  90 section is given in decimal (`\|\c
  91 .B \-d\c
  92 \|', or `\|\c
  93 .B +radix 10\c
  94 \|'); octal
  95 (`\|\c
  96 .B \-o\c
  97 \|', or `\|\c
  98 .B +radix 8\c
  99 \|'); or hexadecimal (`\|\c
 100 .B \-x\c
 101 \|', or
 102 `\|\c
 103 .B +radix 16\c
 104 \|').  In `\|\c
 105 .B +radix \c
 106 .I number\c
 107 \&\c
 108 \|', only the three
 109 values (8, 10, 16) are supported.  The total size is always given in two
 110 radices; decimal and hexadecimal for `\|\c
 111 .B \-d\c
 112 \|' or `\|\c
 113 .B \-x\c
 114 \|' output, or
 115 octal and hexadecimal if you're using `\|\c
 116 .B \-o\c
 117 \|'.
 118
 119 .TP
 120 .BI "+target " "bfdname"\c
 121 \&
 122 You can specify a particular object-code format for \c
 123 .I objfiles\c
 124 \& as
 125 \c
 126 .I bfdname\c
 127 \&.  This may not be necessary; \c
 128 .I size\c
 129 \& can
 130 automatically recognize many formats.   See
 131 .BR objdump ( 1 )
 132 for information
 133 on listing available formats.
 134
 135 .TP
 136 .B \-V
 137 .TP
 138 .B +version
 139 Display version number information on \c
 140 .B size\c
 141 \& itself.
 142
 143 .PP
 144
 145 .SH "SEE ALSO"
 146 .RB "`\|" binutils "\|'"
 147 entry in
 148 .B
 149 info\c
 150 \&;
 151 .I
 152 The GNU Binary Utilities\c
 153 \&, Roland H. Pesch (October 1991);
 154 .BR ar "(" 1 "),"
 155 .BR objdump ( 1 ).
 156
 157 .SH COPYING
 158 Copyright (c) 1991 Free Software Foundation, Inc.
 159 .PP
 160 Permission is granted to make and distribute verbatim copies of
 161 this manual provided the copyright notice and this permission notice
 162 are preserved on all copies.
 163 .PP
 164 Permission is granted to copy and distribute modified versions of this
 165 manual under the conditions for verbatim copying, provided that the
 166 entire resulting derived work is distributed under the terms of a
 167 permission notice identical to this one.
 168 .PP
 169 Permission is granted to copy and distribute translations of this
 170 manual into another language, under the above conditions for modified
 171 versions, except that this permission notice may be included in
 172 translations approved by the Free Software Foundation instead of in
 173 the original English.