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 \- 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 objfile\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
  39 .I objfile
  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 .B \-A
  47 .TP
  48 .B \-B
  49 .TP
  50 .BI "\-\-format " "compatibility"
  51 Using one of these options, you can choose whether the output from GNU
  52 \c
  53 .B size\c
  54 \& resembles output from System V \c
  55 .B size\c
  56 \& (using `\|\c
  57 .B \-A\c
  58 \|',
  59 or `\|\c
  60 .B \-\-format=sysv\c
  61 \|'), or Berkeley \c
  62 .B size\c
  63 \& (using `\|\c
  64 .B \-B\c
  65 \|', or
  66 `\|\c
  67 .B \-\-format=berkeley\c
  68 \|').  The default is the one-line format similar to
  69 Berkeley's.
  70
  71 .TP
  72 .B \-\-help
  73 Show a summary of acceptable arguments and options.
  74
  75 .TP
  76 .B \-d
  77 .TP
  78 .B \-o
  79 .TP
  80 .B \-x
  81 .TP
  82 .BI "\-\-radix " "number"
  83 Using one of these options, you can control whether the size of each
  84 section is given in decimal (`\|\c
  85 .B \-d\c
  86 \|', or `\|\c
  87 .B \-\-radix 10\c
  88 \|'); octal
  89 (`\|\c
  90 .B \-o\c
  91 \|', or `\|\c
  92 .B \-\-radix 8\c
  93 \|'); or hexadecimal (`\|\c
  94 .B \-x\c
  95 \|', or
  96 `\|\c
  97 .B \-\-radix 16\c
  98 \|').  In `\|\c
  99 .B \-\-radix \c
 100 .I number\c
 101 \&\c
 102 \|', only the three
 103 values (8, 10, 16) are supported.  The total size is always given in two
 104 radices; decimal and hexadecimal for `\|\c
 105 .B \-d\c
 106 \|' or `\|\c
 107 .B \-x\c
 108 \|' output, or
 109 octal and hexadecimal if you're using `\|\c
 110 .B \-o\c
 111 \|'.
 112
 113 .TP
 114 .BI "\-\-target " "bfdname"
 115 You can specify a particular object-code format for \c
 116 .I objfile\c
 117 \& as
 118 \c
 119 .I bfdname\c
 120 \&.  This may not be necessary; \c
 121 .I size\c
 122 \& can
 123 automatically recognize many formats.   See
 124 .BR objdump ( 1 )
 125 for information
 126 on listing available formats.
 127
 128 .TP
 129 .B \-V
 130 .TP
 131 .B \-\-version
 132 Display version number information on \c
 133 .B size\c
 134 \& itself.
 135
 136 .SH "SEE ALSO"
 137 .RB "`\|" binutils "\|'"
 138 entry in
 139 .BR info ;
 140 .IR "The GNU Binary Utilities" ,
 141  Roland H. Pesch (October 1991);
 142 .BR ar "(" 1 "),"
 143 .BR objdump ( 1 ).
 144
 145 .SH COPYING
 146 Copyright (c) 1991 Free Software Foundation, Inc.
 147 .PP
 148 Permission is granted to make and distribute verbatim copies of
 149 this manual provided the copyright notice and this permission notice
 150 are preserved on all copies.
 151 .PP
 152 Permission is granted to copy and distribute modified versions of this
 153 manual under the conditions for verbatim copying, provided that the
 154 entire resulting derived work is distributed under the terms of a
 155 permission notice identical to this one.
 156 .PP
 157 Permission is granted to copy and distribute translations of this
 158 manual into another language, under the above conditions for modified
 159 versions, except that this permission notice may be included in
 160 translations approved by the Free Software Foundation instead of in
 161 the original English.