scc

  1.TH SCC-SIZE 1 scc\-VERSION
  2.SH NAME
  3scc-size \- list section sizes of object files
  4.SH SYNOPSIS
  5.B scc-size
  6.RB [ \-t ]
  7.RI [ file ...]
  8.SH DESCRIPTION
  9.B scc-size
 10lists the sizes of the text, data, and BSS sections of each object
 11.I file
 12specified, along with the total size in decimal and hexadecimal.
 13If no
 14.I file
 15arguments are given,
 16.B scc-size
 17reads from
 18.B a.out
 19by default.
 20.PP
 21For each
 22.IR file ,
 23.B scc-size
 24writes a line to standard output containing the following tab-separated fields:
 25.PP
 26.RS
 27.I text data bss dec hex filename
 28.RE
 29.PP
 30where
 31.I text
 32is the combined size of the text (code) and read-only data sections,
 33.I data
 34is the size of the initialised data sections,
 35.I bss
 36is the size of the uninitialised data sections,
 37.I dec
 38is the total size in decimal,
 39.I hex
 40is the total size in hexadecimal,
 41and
 42.I filename
 43is the name of the file.
 44.PP
 45A header line is always printed before the first entry:
 46.PP
 47.RS
 48.EX
 49text	data	bss	dec	hex	filename
 50.EE
 51.RE
 52.PP
 53When processing an archive library,
 54.B scc-size
 55reports sizes for each object file member contained within the archive.
 56Members that are not recognised object files are silently skipped.
 57.PP
 58Sections are classified as follows:
 59.PP
 60.RS
 61.PD 0
 62.TP
 63.B T R
 64Text and read-only data sections contribute to the
 65.I text
 66total.
 67.TP
 68.B D
 69Initialised data sections contribute to the
 70.I data
 71total.
 72.TP
 73.B B
 74Uninitialised (BSS) data sections contribute to the
 75.I bss
 76total.
 77.PD
 78.RE
 79.PP
 80Sections of any other type are not counted.
 81.SH OPTIONS
 82.TP
 83.B \-t
 84Print a totals row after all file entries.
 85The totals row accumulates the text, data, and BSS sizes across all
 86processed files (including archive members) and is labelled
 87.BR (TOTALS) .
 88.SH OPERANDS
 89.TP
 90.I file
 91A pathname of an object file or archive library whose section sizes are
 92to be listed.
 93If no operands are given,
 94.B scc-size
 95reads from
 96.BR a.out .
 97.SH EXAMPLES
 98Display the section sizes of an object file:
 99.IP
100.EX
101scc-size foo.o
102.EE
103.PP
104Display section sizes for all object files in an archive:
105.IP
106.EX
107scc-size libfoo.a
108.EE
109.PP
110Display section sizes for multiple files with a totals row:
111.IP
112.EX
113scc-size \-t foo.o bar.o baz.o
114.EE
115.SH STANDARDS
116The
117.B scc-size
118utility is designed to conform to IEEE Std 1003.1-2008 (POSIX.1).
119.SH SEE ALSO
120.BR scc-ar (1),
121.BR scc-nm (1),
122.BR scc-strip (1),
123.BR scc-objdump (1)