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