binutils/size.1

   1 .\" Copyright (c) 1991, 2000 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .TH size 1 "5 November 1991" "Free Software Foundation" "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, 2000 Free Software Foundation, Inc.
 147 .PP
 148 This document is distributed under the terms of the GNU Free
 149 Documenation License.  That license is described in the GNU Free
 150 Documentation License section.
 151
 152 .SH GNU Free Documentation License
 153   Version 1.1, March 2000
 154
 155   Copyright (C) 2000  Free Software Foundation, Inc.
 156   59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 157
 158   Everyone is permitted to copy and distribute verbatim
 159   copies of this license document, but changing it is
 160   not allowed.
 161 .PP
 162 0. PREAMBLE
 163 .PP
 164 The purpose of this License is to make a manual, textbook, or other
 165 written document "free" in the sense of freedom: to assure everyone
 166 the effective freedom to copy and redistribute it, with or without
 167 modifying it, either commercially or noncommercially.  Secondarily,
 168 this License preserves for the author and publisher a way to get
 169 credit for their work, while not being considered responsible for
 170 modifications made by others.
 171 .PP
 172 This License is a kind of "copyleft", which means that derivative
 173 works of the document must themselves be free in the same sense.  It
 174 complements the GNU General Public License, which is a copyleft
 175 license designed for free software.
 176 .PP
 177 We have designed this License in order to use it for manuals for free
 178 software, because free software needs free documentation: a free
 179 program should come with manuals providing the same freedoms that the
 180 software does.  But this License is not limited to software manuals;
 181 it can be used for any textual work, regardless of subject matter or
 182 whether it is published as a printed book.  We recommend this License
 183 principally for works whose purpose is instruction or reference.
 184 .PP
 185 1. APPLICABILITY AND DEFINITIONS
 186 .PP
 187 This License applies to any manual or other work that contains a
 188 notice placed by the copyright holder saying it can be distributed
 189 under the terms of this License.  The "Document", below, refers to any
 190 such manual or work.  Any member of the public is a licensee, and is
 191 addressed as "you".
 192 .PP
 193 A "Modified Version" of the Document means any work containing the
 194 Document or a portion of it, either copied verbatim, or with
 195 modifications and/or translated into another language.
 196 .PP
 197 A "Secondary Section" is a named appendix or a front-matter section of
 198 the Document that deals exclusively with the relationship of the
 199 publishers or authors of the Document to the Document's overall subject
 200 (or to related matters) and contains nothing that could fall directly
 201 within that overall subject.  (For example, if the Document is in part a
 202 textbook of mathematics, a Secondary Section may not explain any
 203 mathematics.)  The relationship could be a matter of historical
 204 connection with the subject or with related matters, or of legal,
 205 commercial, philosophical, ethical or political position regarding
 206 them.
 207 .PP
 208 The "Invariant Sections" are certain Secondary Sections whose titles
 209 are designated, as being those of Invariant Sections, in the notice
 210 that says that the Document is released under this License.
 211 .PP
 212 The "Cover Texts" are certain short passages of text that are listed,
 213 as Front-Cover Texts or Back-Cover Texts, in the notice that says that
 214 the Document is released under this License.
 215 .PP
 216 A "Transparent" copy of the Document means a machine-readable copy,
 217 represented in a format whose specification is available to the
 218 general public, whose contents can be viewed and edited directly and
 219 straightforwardly with generic text editors or (for images composed of
 220 pixels) generic paint programs or (for drawings) some widely available
 221 drawing editor, and that is suitable for input to text formatters or
 222 for automatic translation to a variety of formats suitable for input
 223 to text formatters.  A copy made in an otherwise Transparent file
 224 format whose markup has been designed to thwart or discourage
 225 subsequent modification by readers is not Transparent.  A copy that is
 226 not "Transparent" is called "Opaque".
 227 .PP
 228 Examples of suitable formats for Transparent copies include plain
 229 ASCII without markup, Texinfo input format, LaTeX input format, SGML
 230 or XML using a publicly available DTD, and standard-conforming simple
 231 HTML designed for human modification.  Opaque formats include
 232 PostScript, PDF, proprietary formats that can be read and edited only
 233 by proprietary word processors, SGML or XML for which the DTD and/or
 234 processing tools are not generally available, and the
 235 machine-generated HTML produced by some word processors for output
 236 purposes only.
 237 .PP
 238 The "Title Page" means, for a printed book, the title page itself,
 239 plus such following pages as are needed to hold, legibly, the material
 240 this License requires to appear in the title page.  For works in
 241 formats which do not have any title page as such, "Title Page" means
 242 the text near the most prominent appearance of the work's title,
 243 preceding the beginning of the body of the text.
 244 .PP
 245 2. VERBATIM COPYING
 246 .PP
 247 You may copy and distribute the Document in any medium, either
 248 commercially or noncommercially, provided that this License, the
 249 copyright notices, and the license notice saying this License applies
 250 to the Document are reproduced in all copies, and that you add no other
 251 conditions whatsoever to those of this License.  You may not use
 252 technical measures to obstruct or control the reading or further
 253 copying of the copies you make or distribute.  However, you may accept
 254 compensation in exchange for copies.  If you distribute a large enough
 255 number of copies you must also follow the conditions in section 3.
 256 .PP
 257 You may also lend copies, under the same conditions stated above, and
 258 you may publicly display copies.
 259 .PP
 260 3. COPYING IN QUANTITY
 261 .PP
 262 If you publish printed copies of the Document numbering more than 100,
 263 and the Document's license notice requires Cover Texts, you must enclose
 264 the copies in covers that carry, clearly and legibly, all these Cover
 265 Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
 266 the back cover.  Both covers must also clearly and legibly identify
 267 you as the publisher of these copies.  The front cover must present
 268 the full title with all words of the title equally prominent and
 269 visible.  You may add other material on the covers in addition.
 270 Copying with changes limited to the covers, as long as they preserve
 271 the title of the Document and satisfy these conditions, can be treated
 272 as verbatim copying in other respects.
 273 .PP
 274 If the required texts for either cover are too voluminous to fit
 275 legibly, you should put the first ones listed (as many as fit
 276 reasonably) on the actual cover, and continue the rest onto adjacent
 277 pages.
 278 .PP
 279 If you publish or distribute Opaque copies of the Document numbering
 280 more than 100, you must either include a machine-readable Transparent
 281 copy along with each Opaque copy, or state in or with each Opaque copy
 282 a publicly-accessible computer-network location containing a complete
 283 Transparent copy of the Document, free of added material, which the
 284 general network-using public has access to download anonymously at no
 285 charge using public-standard network protocols.  If you use the latter
 286 option, you must take reasonably prudent steps, when you begin
 287 distribution of Opaque copies in quantity, to ensure that this
 288 Transparent copy will remain thus accessible at the stated location
 289 until at least one year after the last time you distribute an Opaque
 290 copy (directly or through your agents or retailers) of that edition to
 291 the public.
 292 .PP
 293 It is requested, but not required, that you contact the authors of the
 294 Document well before redistributing any large number of copies, to give
 295 them a chance to provide you with an updated version of the Document.
 296 .PP
 297 4. MODIFICATIONS
 298 .PP
 299 You may copy and distribute a Modified Version of the Document under
 300 the conditions of sections 2 and 3 above, provided that you release
 301 the Modified Version under precisely this License, with the Modified
 302 Version filling the role of the Document, thus licensing distribution
 303 and modification of the Modified Version to whoever possesses a copy
 304 of it.  In addition, you must do these things in the Modified Version:
 305 .PP
 306 A. Use in the Title Page (and on the covers, if any) a title distinct
 307 from that of the Document, and from those of previous versions
 308 (which should, if there were any, be listed in the History section
 309 of the Document).  You may use the same title as a previous version
 310 if the original publisher of that version gives permission.
 311 .PP
 312 B. List on the Title Page, as authors, one or more persons or entities
 313 responsible for authorship of the modifications in the Modified
 314 Version, together with at least five of the principal authors of the
 315 Document (all of its principal authors, if it has less than five).
 316 .PP
 317 C. State on the Title page the name of the publisher of the
 318 Modified Version, as the publisher.
 319 .PP
 320 D. Preserve all the copyright notices of the Document.
 321 .PP
 322 E. Add an appropriate copyright notice for your modifications
 323 adjacent to the other copyright notices.
 324 .PP
 325 F. Include, immediately after the copyright notices, a license notice
 326 giving the public permission to use the Modified Version under the
 327 terms of this License, in the form shown in the Addendum below.
 328 Preserve in that license notice the full lists of Invariant Sections
 329 and required Cover Texts given in the Document's license notice.
 330 .PP
 331 H. Include an unaltered copy of this License.
 332 .PP
 333 I. Preserve the section entitled "History", and its title, and add to
 334 it an item stating at least the title, year, new authors, and
 335 publisher of the Modified Version as given on the Title Page.  If
 336 there is no section entitled "History" in the Document, create one
 337 stating the title, year, authors, and publisher of the Document as
 338 given on its Title Page, then add an item describing the Modified
 339 Version as stated in the previous sentence.
 340 .PP
 341 J. Preserve the network location, if any, given in the Document for
 342 public access to a Transparent copy of the Document, and likewise
 343 the network locations given in the Document for previous versions
 344 it was based on.  These may be placed in the "History" section.
 345 You may omit a network location for a work that was published at
 346 least four years before the Document itself, or if the original
 347 publisher of the version it refers to gives permission.
 348 .PP
 349 K. In any section entitled "Acknowledgements" or "Dedications",
 350 preserve the section's title, and preserve in the section all the
 351 substance and tone of each of the contributor acknowledgements
 352 and/or dedications given therein.
 353 .PP
 354 L. Preserve all the Invariant Sections of the Document,
 355 unaltered in their text and in their titles.  Section numbers
 356 or the equivalent are not considered part of the section titles.
 357 .PP
 358 M. Delete any section entitled "Endorsements".  Such a section
 359 may not be included in the Modified Version.
 360 .PP
 361 N. Do not retitle any existing section as "Endorsements"
 362 or to conflict in title with any Invariant Section.
 363 .PP
 364 If the Modified Version includes new front-matter sections or
 365 appendices that qualify as Secondary Sections and contain no material
 366 copied from the Document, you may at your option designate some or all
 367 of these sections as invariant.  To do this, add their titles to the
 368 list of Invariant Sections in the Modified Version's license notice.
 369 These titles must be distinct from any other section titles.
 370 .PP
 371 You may add a section entitled "Endorsements", provided it contains
 372 nothing but endorsements of your Modified Version by various
 373 parties--for example, statements of peer review or that the text has
 374 been approved by an organization as the authoritative definition of a
 375 standard.
 376 .PP
 377 You may add a passage of up to five words as a Front-Cover Text, and a
 378 passage of up to 25 words as a Back-Cover Text, to the end of the list
 379 of Cover Texts in the Modified Version.  Only one passage of
 380 Front-Cover Text and one of Back-Cover Text may be added by (or
 381 through arrangements made by) any one entity.  If the Document already
 382 includes a cover text for the same cover, previously added by you or
 383 by arrangement made by the same entity you are acting on behalf of,
 384 you may not add another; but you may replace the old one, on explicit
 385 permission from the previous publisher that added the old one.
 386 .PP
 387 The author(s) and publisher(s) of the Document do not by this License
 388 give permission to use their names for publicity for or to assert or
 389 imply endorsement of any Modified Version.
 390 .PP
 391
 392 5. COMBINING DOCUMENTS
 393 .PP
 394 You may combine the Document with other documents released under this
 395 License, under the terms defined in section 4 above for modified
 396 versions, provided that you include in the combination all of the
 397 Invariant Sections of all of the original documents, unmodified, and
 398 list them all as Invariant Sections of your combined work in its
 399 license notice.
 400 .PP
 401 The combined work need only contain one copy of this License, and
 402 multiple identical Invariant Sections may be replaced with a single
 403 copy.  If there are multiple Invariant Sections with the same name but
 404 different contents, make the title of each such section unique by
 405 adding at the end of it, in parentheses, the name of the original
 406 author or publisher of that section if known, or else a unique number.
 407 Make the same adjustment to the section titles in the list of
 408 Invariant Sections in the license notice of the combined work.
 409 .PP
 410 In the combination, you must combine any sections entitled "History"
 411 in the various original documents, forming one section entitled
 412 "History"; likewise combine any sections entitled "Acknowledgements",
 413 and any sections entitled "Dedications".  You must delete all sections
 414 entitled "Endorsements."
 415 .PP
 416
 417 6. COLLECTIONS OF DOCUMENTS
 418 .PP
 419 You may make a collection consisting of the Document and other documents
 420 released under this License, and replace the individual copies of this
 421 License in the various documents with a single copy that is included in
 422 the collection, provided that you follow the rules of this License for
 423 verbatim copying of each of the documents in all other respects.
 424 .PP
 425 You may extract a single document from such a collection, and distribute
 426 it individually under this License, provided you insert a copy of this
 427 License into the extracted document, and follow this License in all
 428 other respects regarding verbatim copying of that document.
 429 .PP
 430
 431 7. AGGREGATION WITH INDEPENDENT WORKS
 432 .PP
 433 A compilation of the Document or its derivatives with other separate
 434 and independent documents or works, in or on a volume of a storage or
 435 distribution medium, does not as a whole count as a Modified Version
 436 of the Document, provided no compilation copyright is claimed for the
 437 compilation.  Such a compilation is called an "aggregate", and this
 438 License does not apply to the other self-contained works thus compiled
 439 with the Document, on account of their being thus compiled, if they
 440 are not themselves derivative works of the Document.
 441 .PP
 442 If the Cover Text requirement of section 3 is applicable to these
 443 copies of the Document, then if the Document is less than one quarter
 444 of the entire aggregate, the Document's Cover Texts may be placed on
 445 covers that surround only the Document within the aggregate.
 446 Otherwise they must appear on covers around the whole aggregate.
 447 .PP
 448
 449 8. TRANSLATION
 450 .PP
 451 Translation is considered a kind of modification, so you may
 452 distribute translations of the Document under the terms of section 4.
 453 Replacing Invariant Sections with translations requires special
 454 permission from their copyright holders, but you may include
 455 translations of some or all Invariant Sections in addition to the
 456 original versions of these Invariant Sections.  You may include a
 457 translation of this License provided that you also include the
 458 original English version of this License.  In case of a disagreement
 459 between the translation and the original English version of this
 460 License, the original English version will prevail.
 461 .PP
 462
 463 9. TERMINATION
 464 .PP
 465 You may not copy, modify, sublicense, or distribute the Document except
 466 as expressly provided for under this License.  Any other attempt to
 467 copy, modify, sublicense or distribute the Document is void, and will
 468 automatically terminate your rights under this License.  However,
 469 parties who have received copies, or rights, from you under this
 470 License will not have their licenses terminated so long as such
 471 parties remain in full compliance.
 472 .PP
 473
 474 10. FUTURE REVISIONS OF THIS LICENSE
 475 .PP
 476 The Free Software Foundation may publish new, revised versions
 477 of the GNU Free Documentation License from time to time.  Such new
 478 versions will be similar in spirit to the present version, but may
 479 differ in detail to address new problems or concerns.  See
 480 http://www.gnu.org/copyleft/.
 481 .PP
 482 Each version of the License is given a distinguishing version number.
 483 If the Document specifies that a particular numbered version of this
 484 License "or any later version" applies to it, you have the option of
 485 following the terms and conditions either of that specified version or
 486 of any later version that has been published (not as a draft) by the
 487 Free Software Foundation.  If the Document does not specify a version
 488 number of this License, you may choose any version ever published (not
 489 as a draft) by the Free Software Foundation.
 490 .PP
 491
 492 ADDENDUM: How to use this License for your documents
 493 .PP
 494 To use this License in a document you have written, include a copy of
 495 the License in the document and put the following copyright and
 496 license notices just after the title page:
 497 .PP
 498     Copyright (c)  YEAR  YOUR NAME.
 499     Permission is granted to copy, distribute and/or
 500     modify this document under the terms of the GNU
 501     Free Documentation License, Version 1.1 or any later
 502     version published by the Free Software Foundation;
 503     with the Invariant Sections being LIST THEIR TITLES,
 504     with the Front-Cover Texts being LIST, and with the
 505     Back-Cover Texts being LIST.  A copy of the license
 506     is included in the section entitled "GNU Free
 507     Documentation License".
 508 .PP
 509 If you have no Invariant Sections, write "with no Invariant Sections"
 510 instead of saying which ones are invariant.  If you have no
 511 Front-Cover Texts, write "no Front-Cover Texts" instead of
 512 "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
 513 .PP
 514 If your document contains nontrivial examples of program code, we
 515 recommend releasing these examples in parallel under your choice of
 516 free software license, such as the GNU General Public License,
 517 to permit their use in free software.