binutils/size.1

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