* main.c: Remove windows.h use.
[deliverable/binutils-gdb.git] / binutils / size.1
CommitLineData
0285c67d
NC
1.rn '' }`
2''' $RCSfile$$Revision$$Date$
3'''
4''' $Log$
5''' Revision 1.5 2001/03/25 20:32:25 nickc
6''' Automate generate on man pages
7'''
8'''
9.de Sh
10.br
11.if t .Sp
12.ne 5
13.PP
14\fB\\$1\fR
15.PP
16..
17.de Sp
18.if t .sp .5v
19.if n .sp
252b5132 20..
0285c67d
NC
21.de Ip
22.br
23.ie \\n(.$>=3 .ne \\$3
24.el .ne 3
25.IP "\\$1" \\$2
26..
27.de Vb
28.ft CW
29.nf
30.ne \\$1
31..
32.de Ve
33.ft R
252b5132 34
0285c67d
NC
35.fi
36..
37'''
38'''
39''' Set up \*(-- to give an unbreakable dash;
40''' string Tr holds user defined translation string.
41''' Bell System Logo is used as a dummy character.
42'''
43.tr \(*W-|\(bv\*(Tr
44.ie n \{\
45.ds -- \(*W-
46.ds PI pi
47.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
48.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
49.ds L" ""
50.ds R" ""
51''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
52''' \*(L" and \*(R", except that they are used on ".xx" lines,
53''' such as .IP and .SH, which do another additional levels of
54''' double-quote interpretation
55.ds M" """
56.ds S" """
57.ds N" """""
58.ds T" """""
59.ds L' '
60.ds R' '
61.ds M' '
62.ds S' '
63.ds N' '
64.ds T' '
65'br\}
66.el\{\
67.ds -- \(em\|
68.tr \*(Tr
69.ds L" ``
70.ds R" ''
71.ds M" ``
72.ds S" ''
73.ds N" ``
74.ds T" ''
75.ds L' `
76.ds R' '
77.ds M' `
78.ds S' '
79.ds N' `
80.ds T' '
81.ds PI \(*p
82'br\}
83.\" If the F register is turned on, we'll generate
84.\" index entries out stderr for the following things:
85.\" TH Title
86.\" SH Header
87.\" Sh Subsection
88.\" Ip Item
89.\" X<> Xref (embedded
90.\" Of course, you have to process the output yourself
91.\" in some meaninful fashion.
92.if \nF \{
93.de IX
94.tm Index:\\$1\t\\n%\t"\\$2"
95..
96.nr % 0
97.rr F
98.\}
99.TH SIZE.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
100.UC
101.if n .hy 0
102.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
103.de CQ \" put $1 in typewriter font
104.ft CW
105'if n "\c
106'if t \\&\\$1\c
107'if n \\&\\$1\c
108'if n \&"
109\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110'.ft R
111..
112.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
113. \" AM - accent mark definitions
114.bd B 3
115. \" fudge factors for nroff and troff
116.if n \{\
117. ds #H 0
118. ds #V .8m
119. ds #F .3m
120. ds #[ \f1
121. ds #] \fP
122.\}
123.if t \{\
124. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
125. ds #V .6m
126. ds #F 0
127. ds #[ \&
128. ds #] \&
129.\}
130. \" simple accents for nroff and troff
131.if n \{\
132. ds ' \&
133. ds ` \&
134. ds ^ \&
135. ds , \&
136. ds ~ ~
137. ds ? ?
138. ds ! !
139. ds /
140. ds q
141.\}
142.if t \{\
143. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
144. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
145. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
146. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
147. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
148. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
149. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
150. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
151. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
152.\}
153. \" troff and (daisy-wheel) nroff accents
154.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
155.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
156.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
157.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
158.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
159.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
160.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
161.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
162.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
163.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
164.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
165.ds ae a\h'-(\w'a'u*4/10)'e
166.ds Ae A\h'-(\w'A'u*4/10)'E
167.ds oe o\h'-(\w'o'u*4/10)'e
168.ds Oe O\h'-(\w'O'u*4/10)'E
169. \" corrections for vroff
170.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
171.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
172. \" for low resolution devices (crt and lpr)
173.if \n(.H>23 .if \n(.V>19 \
174\{\
175. ds : e
176. ds 8 ss
177. ds v \h'-1'\o'\(aa\(ga'
178. ds _ \h'-1'^
179. ds . \h'-1'.
180. ds 3 3
181. ds o a
182. ds d- d\h'-1'\(ga
183. ds D- D\h'-1'\(hy
184. ds th \o'bp'
185. ds Th \o'LP'
186. ds ae ae
187. ds Ae AE
188. ds oe oe
189. ds Oe OE
190.\}
191.rm #[ #] #H #V #F C
192.SH "NAME"
252b5132 193size \- list section sizes and total size.
0285c67d
NC
194.SH "SYNOPSIS"
195size [ \-A | \-B | --format=\fIcompatibility\fR ]
196 [ --help ] [ \-d | \-o | \-x | --radix=\fInumber\fR ]
197 [ --target=\fIbfdname\fR ] [ \-V | --version ]
198 [ \fIobjfile\fR... ]
199.SH "DESCRIPTION"
200The GNU \f(CWsize\fR utility lists the section sizes---and the total
201size---for each of the object or archive files \fIobjfile\fR in its
202argument list. By default, one line of output is generated for each
203object file or each module in an archive.
204.PP
205\fIobjfile\fR... are the object files to be examined.
206If none are specified, the file \f(CWa.out\fR will be used.
207.SH "OPTIONS"
208The command line options have the following meanings:
209.Ip "\f(CW-A\fR" 4
210.Ip "\f(CW-B\fR" 4
211.Ip "\f(CW--format=\fIcompatibility\fR\fR" 4
212Using one of these options, you can choose whether the output from \s-1GNU\s0
213\f(CWsize\fR resembles output from System V \f(CWsize\fR (using \fB\-A\fR,
214or \fB--format=sysv\fR), or Berkeley \f(CWsize\fR (using \fB\-B\fR, or
215\fB--format=berkeley\fR). The default is the one-line format similar to
252b5132 216Berkeley's.
0285c67d
NC
217.Sp
218Here is an example of the Berkeley (default) format of output from
219\f(CWsize\fR:
220
221 $ size --format=Berkeley ranlib size
222 text data bss dec hex filename
223 294880 81920 11592 388392 5ed28 ranlib
224 294880 81920 11888 388688 5ee50 size
225.Sp
226This is the same data, but displayed closer to System V conventions:
227.Sp
228.Vb 16
229\&
230\& $ size --format=SysV ranlib size
231\& ranlib :
232\& section size addr
233\& .text 294880 8192
234\& .data 81920 303104
235\& .bss 11592 385024
236\& Total 388392
237\&
238\&
239\& size :
240\& section size addr
241\& .text 294880 8192
242\& .data 81920 303104
243\& .bss 11888 385024
244\& Total 388688
245.Ve
246.Ip "\f(CW--help\fR" 4
252b5132 247Show a summary of acceptable arguments and options.
0285c67d
NC
248.Ip "\f(CW-d\fR" 4
249.Ip "\f(CW-o\fR" 4
250.Ip "\f(CW-x\fR" 4
251.Ip "\f(CW--radix=\fInumber\fR\fR" 4
252b5132 252Using one of these options, you can control whether the size of each
0285c67d
NC
253section is given in decimal (\fB\-d\fR, or \fB--radix=10\fR); octal
254(\fB\-o\fR, or \fB--radix=8\fR); or hexadecimal (\fB\-x\fR, or
255\fB--radix=16\fR). In \fB--radix=\fR\fInumber\fR, only the three
252b5132 256values (8, 10, 16) are supported. The total size is always given in two
0285c67d
NC
257radices; decimal and hexadecimal for \fB\-d\fR or \fB\-x\fR output, or
258octal and hexadecimal if you're using \fB\-o\fR.
259.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
260Specify that the object-code format for \fIobjfile\fR is
261\fIbfdname\fR. This option may not be necessary; \f(CWsize\fR can
262automatically recognize many formats.
263.Ip "\f(CW-V\fR" 4
264.Ip "\f(CW--version\fR" 4
265Display the version number of \f(CWsize\fR.
266.SH "SEE ALSO"
267\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
268.SH "COPYRIGHT"
269Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
270.PP
271Permission is granted to copy, distribute and/or modify this document
272under the terms of the GNU Free Documentation License, Version 1.1
273or any later version published by the Free Software Foundation;
274with no Invariant Sections, with no Front-Cover Texts, and with no
275Back-Cover Texts. A copy of the license is included in the
276section entitled \*(L"GNU Free Documentation License\*(R".
252b5132 277
0285c67d
NC
278.rn }` ''
279.IX Title "SIZE.1 1"
280.IX Name "size - list section sizes and total size."
252b5132 281
0285c67d 282.IX Header "NAME"
252b5132 283
0285c67d 284.IX Header "SYNOPSIS"
252b5132 285
0285c67d
NC
286.IX Header "DESCRIPTION"
287
288.IX Header "OPTIONS"
289
290.IX Item "\f(CW-A\fR"
291
292.IX Item "\f(CW-B\fR"
293
294.IX Item "\f(CW--format=\fIcompatibility\fR\fR"
295
296.IX Item "\f(CW--help\fR"
297
298.IX Item "\f(CW-d\fR"
cf055d54 299
0285c67d 300.IX Item "\f(CW-o\fR"
cf055d54 301
0285c67d 302.IX Item "\f(CW-x\fR"
cf055d54 303
0285c67d 304.IX Item "\f(CW--radix=\fInumber\fR\fR"
cf055d54 305
0285c67d 306.IX Item "\f(CW--target=\fIbfdname\fR\fR"
cf055d54 307
0285c67d 308.IX Item "\f(CW-V\fR"
cf055d54 309
0285c67d 310.IX Item "\f(CW--version\fR"
cf055d54 311
0285c67d 312.IX Header "SEE ALSO"
cf055d54 313
0285c67d 314.IX Header "COPYRIGHT"
cf055d54 315
This page took 0.075449 seconds and 4 git commands to generate.