author | jjkang |
Fri, 11 Jun 2010 15:22:19 +0800 | |
changeset 3 | d6b1fbb42aec |
parent 0 | 76b1f169d9fe |
permissions | -rw-r--r-- |
0
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1 |
.\" Automatically generated by Pod::Man version 1.15 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2 |
.\" Wed Jan 18 01:53:37 2006 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3 |
.\" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4 |
.\" Standard preamble: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5 |
.\" ====================================================================== |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6 |
.de Sh \" Subsection heading |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7 |
.br |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8 |
.if t .Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9 |
.ne 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
11 |
\fB\\$1\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
12 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
13 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
14 |
.de Sp \" Vertical space (when we can't use .PP) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
15 |
.if t .sp .5v |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
16 |
.if n .sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
17 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
18 |
.de Ip \" List item |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
19 |
.br |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
20 |
.ie \\n(.$>=3 .ne \\$3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
21 |
.el .ne 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
22 |
.IP "\\$1" \\$2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
23 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
24 |
.de Vb \" Begin verbatim text |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
25 |
.ft CW |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
26 |
.nf |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
27 |
.ne \\$1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
28 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
29 |
.de Ve \" End verbatim text |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
30 |
.ft R |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
31 |
|
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
32 |
.fi |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
33 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
34 |
.\" Set up some character translations and predefined strings. \*(-- will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
35 |
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
36 |
.\" double quote, and \*(R" will give a right double quote. | will give a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
37 |
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
38 |
.\" to do unbreakable dashes and therefore won't be available. \*(C` and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
39 |
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
40 |
.tr \(*W-|\(bv\*(Tr |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
41 |
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
42 |
.ie n \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
43 |
. ds -- \(*W- |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
44 |
. ds PI pi |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
45 |
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
46 |
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
47 |
. ds L" "" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
48 |
. ds R" "" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
49 |
. ds C` "" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
50 |
. ds C' "" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
51 |
'br\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
52 |
.el\{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
53 |
. ds -- \|\(em\| |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
54 |
. ds PI \(*p |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
55 |
. ds L" `` |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
56 |
. ds R" '' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
57 |
'br\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
58 |
.\" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
59 |
.\" If the F register is turned on, we'll generate index entries on stderr |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
60 |
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
61 |
.\" index entries marked with X<> in POD. Of course, you'll have to process |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
62 |
.\" the output yourself in some meaningful fashion. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
63 |
.if \nF \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
64 |
. de IX |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
65 |
. tm Index:\\$1\t\\n%\t"\\$2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
66 |
.. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
67 |
. nr % 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
68 |
. rr F |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
69 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
70 |
.\" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
71 |
.\" For nroff, turn off justification. Always turn off hyphenation; it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
72 |
.\" makes way too many mistakes in technical documents. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
73 |
.hy 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
74 |
.if n .na |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
75 |
.\" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
76 |
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
77 |
.\" Fear. Run. Save yourself. No user-serviceable parts. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
78 |
.bd B 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
79 |
. \" fudge factors for nroff and troff |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
80 |
.if n \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
81 |
. ds #H 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
82 |
. ds #V .8m |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
83 |
. ds #F .3m |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
84 |
. ds #[ \f1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
85 |
. ds #] \fP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
86 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
87 |
.if t \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
88 |
. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
89 |
. ds #V .6m |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
90 |
. ds #F 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
91 |
. ds #[ \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
92 |
. ds #] \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
93 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
94 |
. \" simple accents for nroff and troff |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
95 |
.if n \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
96 |
. ds ' \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
97 |
. ds ` \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
98 |
. ds ^ \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
99 |
. ds , \& |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
100 |
. ds ~ ~ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
101 |
. ds / |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
102 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
103 |
.if t \{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
104 |
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
105 |
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
106 |
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
107 |
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
108 |
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
109 |
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
110 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
111 |
. \" troff and (daisy-wheel) nroff accents |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
112 |
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
113 |
.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
114 |
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
115 |
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
116 |
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
117 |
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
118 |
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
119 |
.ds ae a\h'-(\w'a'u*4/10)'e |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
120 |
.ds Ae A\h'-(\w'A'u*4/10)'E |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
121 |
. \" corrections for vroff |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
122 |
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
123 |
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
124 |
. \" for low resolution devices (crt and lpr) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
125 |
.if \n(.H>23 .if \n(.V>19 \ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
126 |
\{\ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
127 |
. ds : e |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
128 |
. ds 8 ss |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
129 |
. ds o a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
130 |
. ds d- d\h'-1'\(ga |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
131 |
. ds D- D\h'-1'\(hy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
132 |
. ds th \o'bp' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
133 |
. ds Th \o'LP' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
134 |
. ds ae ae |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
135 |
. ds Ae AE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
136 |
.\} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
137 |
.rm #[ #] #H #V #F C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
138 |
.\" ====================================================================== |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
139 |
.\" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
140 |
.IX Title "GCC 1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
141 |
.TH GCC 1 "gcc-3.4.5" "2006-01-18" "GNU" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
142 |
.UC |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
143 |
.SH "NAME" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
144 |
gcc \- \s-1GNU\s0 project C and \*(C+ compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
145 |
.SH "SYNOPSIS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
146 |
.IX Header "SYNOPSIS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
147 |
gcc [\fB\-c\fR|\fB\-S\fR|\fB\-E\fR] [\fB\-std=\fR\fIstandard\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
148 |
[\fB\-g\fR] [\fB\-pg\fR] [\fB\-O\fR\fIlevel\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
149 |
[\fB\-W\fR\fIwarn\fR...] [\fB\-pedantic\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
150 |
[\fB\-I\fR\fIdir\fR...] [\fB\-L\fR\fIdir\fR...] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
151 |
[\fB\-D\fR\fImacro\fR[=\fIdefn\fR]...] [\fB\-U\fR\fImacro\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
152 |
[\fB\-f\fR\fIoption\fR...] [\fB\-m\fR\fImachine-option\fR...] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
153 |
[\fB\-o\fR \fIoutfile\fR] \fIinfile\fR... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
154 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
155 |
Only the most useful options are listed here; see below for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
156 |
remainder. \fBg++\fR accepts mostly the same options as \fBgcc\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
157 |
.SH "DESCRIPTION" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
158 |
.IX Header "DESCRIPTION" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
159 |
When you invoke \s-1GCC\s0, it normally does preprocessing, compilation, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
160 |
assembly and linking. The ``overall options'' allow you to stop this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
161 |
process at an intermediate stage. For example, the \fB\-c\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
162 |
says not to run the linker. Then the output consists of object files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
163 |
output by the assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
164 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
165 |
Other options are passed on to one stage of processing. Some options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
166 |
control the preprocessor and others the compiler itself. Yet other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
167 |
options control the assembler and linker; most of these are not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
168 |
documented here, since you rarely need to use any of them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
169 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
170 |
Most of the command line options that you can use with \s-1GCC\s0 are useful |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
171 |
for C programs; when an option is only useful with another language |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
172 |
(usually \*(C+), the explanation says so explicitly. If the description |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
173 |
for a particular option does not mention a source language, you can use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
174 |
that option with all supported languages. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
175 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
176 |
The \fBgcc\fR program accepts options and file names as operands. Many |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
177 |
options have multi-letter names; therefore multiple single-letter options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
178 |
may \fInot\fR be grouped: \fB\-dr\fR is very different from \fB\-d\ \-r\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
179 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
180 |
You can mix options and other arguments. For the most part, the order |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
181 |
you use doesn't matter. Order does matter when you use several options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
182 |
of the same kind; for example, if you specify \fB\-L\fR more than once, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
183 |
the directories are searched in the order specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
184 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
185 |
Many options have long names starting with \fB\-f\fR or with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
186 |
\&\fB\-W\fR\-\-\-for example, \fB\-fforce-mem\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
187 |
\&\fB\-fstrength-reduce\fR, \fB\-Wformat\fR and so on. Most of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
188 |
these have both positive and negative forms; the negative form of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
189 |
\&\fB\-ffoo\fR would be \fB\-fno-foo\fR. This manual documents |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
190 |
only one of these two forms, whichever one is not the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
191 |
.SH "OPTIONS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
192 |
.IX Header "OPTIONS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
193 |
.Sh "Option Summary" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
194 |
.IX Subsection "Option Summary" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
195 |
Here is a summary of all the options, grouped by type. Explanations are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
196 |
in the following sections. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
197 |
.Ip "\fIOverall Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
198 |
.IX Item "Overall Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
199 |
\&\fB\-c \-S \-E \-o\fR \fIfile\fR \fB\-pipe \-pass-exit-codes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
200 |
\&\-x\fR \fIlanguage\fR \fB\-v \-### \-\-help \-\-target-help \-\-version\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
201 |
.Ip "\fIC Language Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
202 |
.IX Item "C Language Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
203 |
\&\fB\-ansi \-std=\fR\fIstandard\fR \fB\-aux-info\fR \fIfilename\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
204 |
\&\fB\-fno-asm \-fno-builtin \-fno-builtin-\fR\fIfunction\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
205 |
\&\fB\-fhosted \-ffreestanding \-fms-extensions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
206 |
\&\-trigraphs \-no-integrated-cpp \-traditional \-traditional-cpp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
207 |
\&\-fallow-single-precision \-fcond-mismatch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
208 |
\&\-fsigned-bitfields \-fsigned-char |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
209 |
\&\-funsigned-bitfields \-funsigned-char |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
210 |
\&\-fwritable-strings\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
211 |
.Ip "\fI\*(C+ Language Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
212 |
.IX Item " Language Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
213 |
\&\fB\-fabi-version=\fR\fIn\fR \fB\-fno-access-control \-fcheck-new |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
214 |
\&\-fconserve-space \-fno-const-strings |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
215 |
\&\-fno-elide-constructors |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
216 |
\&\-fno-enforce-eh-specs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
217 |
\&\-ffor-scope \-fno-for-scope \-fno-gnu-keywords |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
218 |
\&\-fno-implicit-templates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
219 |
\&\-fno-implicit-inline-templates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
220 |
\&\-fno-implement-inlines \-fms-extensions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
221 |
\&\-fno-nonansi-builtins \-fno-operator-names |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
222 |
\&\-fno-optional-diags \-fpermissive |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
223 |
\&\-frepo \-fno-rtti \-fstats \-ftemplate-depth-\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
224 |
\&\fB\-fuse-cxa-atexit \-fno-weak \-nostdinc++ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
225 |
\&\-fno-default-inline \-Wabi \-Wctor-dtor-privacy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
226 |
\&\-Wnon-virtual-dtor \-Wreorder |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
227 |
\&\-Weffc++ \-Wno-deprecated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
228 |
\&\-Wno-non-template-friend \-Wold-style-cast |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
229 |
\&\-Woverloaded-virtual \-Wno-pmf-conversions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
230 |
\&\-Wsign-promo\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
231 |
.Ip "\fIObjective-C Language Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
232 |
.IX Item "Objective-C Language Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
233 |
\&\fB\-fconstant-string-class=\fR\fIclass-name\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
234 |
\&\fB\-fgnu-runtime \-fnext-runtime |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
235 |
\&\-fno-nil-receivers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
236 |
\&\-fobjc-exceptions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
237 |
\&\-freplace-objc-classes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
238 |
\&\-fzero-link |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
239 |
\&\-gen-decls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
240 |
\&\-Wno-protocol \-Wselector \-Wundeclared-selector\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
241 |
.Ip "\fILanguage Independent Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
242 |
.IX Item "Language Independent Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
243 |
\&\fB\-fmessage-length=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
244 |
\&\fB\-fdiagnostics-show-location=\fR[\fBonce\fR|\fBevery-line\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
245 |
.Ip "\fIWarning Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
246 |
.IX Item "Warning Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
247 |
\&\fB\-fsyntax-only \-pedantic \-pedantic-errors |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
248 |
\&\-w \-Wextra \-Wall \-Waggregate-return |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
249 |
\&\-Wcast-align \-Wcast-qual \-Wchar-subscripts \-Wcomment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
250 |
\&\-Wconversion \-Wno-deprecated-declarations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
251 |
\&\-Wdisabled-optimization \-Wno-div-by-zero \-Wendif-labels |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
252 |
\&\-Werror \-Werror-implicit-function-declaration |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
253 |
\&\-Wfloat-equal \-Wformat \-Wformat=2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
254 |
\&\-Wno-format-extra-args \-Wformat-nonliteral |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
255 |
\&\-Wformat-security \-Wformat-y2k |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
256 |
\&\-Wimplicit \-Wimplicit-function-declaration \-Wimplicit-int |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
257 |
\&\-Wimport \-Wno-import \-Winit-self \-Winline |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
258 |
\&\-Wno-invalid-offsetof \-Winvalid-pch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
259 |
\&\-Wlarger-than-\fR\fIlen\fR \fB\-Wlong-long |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
260 |
\&\-Wmain \-Wmissing-braces |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
261 |
\&\-Wmissing-format-attribute \-Wmissing-noreturn |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
262 |
\&\-Wno-multichar \-Wnonnull \-Wpacked \-Wpadded |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
263 |
\&\-Wparentheses \-Wpointer-arith \-Wredundant-decls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
264 |
\&\-Wreturn-type \-Wsequence-point \-Wshadow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
265 |
\&\-Wsign-compare \-Wstrict-aliasing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
266 |
\&\-Wswitch \-Wswitch-default \-Wswitch-enum |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
267 |
\&\-Wsystem-headers \-Wtrigraphs \-Wundef \-Wuninitialized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
268 |
\&\-Wunknown-pragmas \-Wunreachable-code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
269 |
\&\-Wunused \-Wunused-function \-Wunused-label \-Wunused-parameter |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
270 |
\&\-Wunused-value \-Wunused-variable \-Wwrite-strings\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
271 |
.Ip "\fIC-only Warning Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
272 |
.IX Item "C-only Warning Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
273 |
\&\fB\-Wbad-function-cast \-Wmissing-declarations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
274 |
\&\-Wmissing-prototypes \-Wnested-externs \-Wold-style-definition |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
275 |
\&\-Wstrict-prototypes \-Wtraditional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
276 |
\&\-Wdeclaration-after-statement\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
277 |
.Ip "\fIDebugging Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
278 |
.IX Item "Debugging Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
279 |
\&\fB\-d\fR\fIletters\fR \fB\-dumpspecs \-dumpmachine \-dumpversion |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
280 |
\&\-fdump-unnumbered \-fdump-translation-unit\fR[\fB-\fR\fIn\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
281 |
\&\fB\-fdump-class-hierarchy\fR[\fB-\fR\fIn\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
282 |
\&\fB\-fdump-tree-original\fR[\fB-\fR\fIn\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
283 |
\&\fB\-fdump-tree-optimized\fR[\fB-\fR\fIn\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
284 |
\&\fB\-fdump-tree-inlined\fR[\fB-\fR\fIn\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
285 |
\&\fB\-feliminate-dwarf2\-dups \-feliminate-unused-debug-types |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
286 |
\&\-feliminate-unused-debug-symbols \-fmem-report \-fprofile-arcs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
287 |
\&\-frandom-seed=\fR\fIstring\fR \fB\-fsched-verbose=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
288 |
\&\fB\-ftest-coverage \-ftime-report |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
289 |
\&\-g \-g\fR\fIlevel\fR \fB\-gcoff \-gdwarf-2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
290 |
\&\-ggdb \-gstabs \-gstabs+ \-gvms \-gxcoff \-gxcoff+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
291 |
\&\-p \-pg \-print-file-name=\fR\fIlibrary\fR \fB\-print-libgcc-file-name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
292 |
\&\-print-multi-directory \-print-multi-lib |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
293 |
\&\-print-prog-name=\fR\fIprogram\fR \fB\-print-search-dirs \-Q |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
294 |
\&\-save-temps \-time\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
295 |
.Ip "\fIOptimization Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
296 |
.IX Item "Optimization Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
297 |
\&\fB\-falign-functions=\fR\fIn\fR \fB\-falign-jumps=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
298 |
\&\fB\-falign-labels=\fR\fIn\fR \fB\-falign-loops=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
299 |
\&\fB\-fbranch-probabilities \-fprofile-values \-fvpt \-fbranch-target-load-optimize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
300 |
\&\-fbranch-target-load-optimize2 \-fcaller-saves \-fcprop-registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
301 |
\&\-fcse-follow-jumps \-fcse-skip-blocks \-fdata-sections |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
302 |
\&\-fdelayed-branch \-fdelete-null-pointer-checks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
303 |
\&\-fexpensive-optimizations \-ffast-math \-ffloat-store |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
304 |
\&\-fforce-addr \-fforce-mem \-ffunction-sections |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
305 |
\&\-fgcse \-fgcse-lm \-fgcse-sm \-fgcse-las \-floop-optimize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
306 |
\&\-fcrossjumping \-fif-conversion \-fif-conversion2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
307 |
\&\-finline-functions \-finline-limit=\fR\fIn\fR \fB\-fkeep-inline-functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
308 |
\&\-fkeep-static-consts \-fmerge-constants \-fmerge-all-constants |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
309 |
\&\-fmove-all-movables \-fnew-ra \-fno-branch-count-reg |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
310 |
\&\-fno-default-inline \-fno-defer-pop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
311 |
\&\-fno-function-cse \-fno-guess-branch-probability |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
312 |
\&\-fno-inline \-fno-math-errno \-fno-peephole \-fno-peephole2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
313 |
\&\-funsafe-math-optimizations \-ffinite-math-only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
314 |
\&\-fno-trapping-math \-fno-zero-initialized-in-bss |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
315 |
\&\-fomit-frame-pointer \-foptimize-register-move |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
316 |
\&\-foptimize-sibling-calls \-fprefetch-loop-arrays |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
317 |
\&\-fprofile-generate \-fprofile-use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
318 |
\&\-freduce-all-givs \-fregmove \-frename-registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
319 |
\&\-freorder-blocks \-freorder-functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
320 |
\&\-frerun-cse-after-loop \-frerun-loop-opt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
321 |
\&\-frounding-math \-fschedule-insns \-fschedule-insns2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
322 |
\&\-fno-sched-interblock \-fno-sched-spec \-fsched-spec-load |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
323 |
\&\-fsched-spec-load-dangerous |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
324 |
\&\-fsched-stalled-insns=\fR\fIn\fR \fB\-sched-stalled-insns-dep=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
325 |
\&\fB\-fsched2\-use-superblocks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
326 |
\&\-fsched2\-use-traces \-fsignaling-nans |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
327 |
\&\-fsingle-precision-constant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
328 |
\&\-fstrength-reduce \-fstrict-aliasing \-ftracer \-fthread-jumps |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
329 |
\&\-funroll-all-loops \-funroll-loops \-fpeel-loops |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
330 |
\&\-funswitch-loops \-fold-unroll-loops \-fold-unroll-all-loops |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
331 |
\&\-\-param\fR \fIname\fR\fB=\fR\fIvalue\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
332 |
\&\fB\-O \-O0 \-O1 \-O2 \-O3 \-Os\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
333 |
.Ip "\fIPreprocessor Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
334 |
.IX Item "Preprocessor Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
335 |
\&\fB\-A\fR\fIquestion\fR\fB=\fR\fIanswer\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
336 |
\&\fB\-A-\fR\fIquestion\fR[\fB=\fR\fIanswer\fR] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
337 |
\&\fB\-C \-dD \-dI \-dM \-dN |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
338 |
\&\-D\fR\fImacro\fR[\fB=\fR\fIdefn\fR] \fB\-E \-H |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
339 |
\&\-idirafter\fR \fIdir\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
340 |
\&\fB\-include\fR \fIfile\fR \fB\-imacros\fR \fIfile\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
341 |
\&\fB\-iprefix\fR \fIfile\fR \fB\-iwithprefix\fR \fIdir\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
342 |
\&\fB\-iwithprefixbefore\fR \fIdir\fR \fB\-isystem\fR \fIdir\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
343 |
\&\fB\-M \-MM \-MF \-MG \-MP \-MQ \-MT \-nostdinc |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
344 |
\&\-P \-fworking-directory \-remap |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
345 |
\&\-trigraphs \-undef \-U\fR\fImacro\fR \fB\-Wp,\fR\fIoption\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
346 |
\&\fB\-Xpreprocessor\fR \fIoption\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
347 |
.Ip "\fIAssembler Option\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
348 |
.IX Item "Assembler Option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
349 |
\&\fB\-Wa,\fR\fIoption\fR \fB\-Xassembler\fR \fIoption\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
350 |
.Ip "\fILinker Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
351 |
.IX Item "Linker Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
352 |
\&\fIobject-file-name\fR \fB\-l\fR\fIlibrary\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
353 |
\&\fB\-nostartfiles \-nodefaultlibs \-nostdlib \-pie |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
354 |
\&\-s \-static \-static-libgcc \-shared \-shared-libgcc \-symbolic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
355 |
\&\-Wl,\fR\fIoption\fR \fB\-Xlinker\fR \fIoption\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
356 |
\&\fB\-u\fR \fIsymbol\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
357 |
.Ip "\fIDirectory Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
358 |
.IX Item "Directory Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
359 |
\&\fB\-B\fR\fIprefix\fR \fB\-I\fR\fIdir\fR \fB\-I- \-L\fR\fIdir\fR \fB\-specs=\fR\fIfile\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
360 |
.Ip "\fITarget Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
361 |
.IX Item "Target Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
362 |
\&\fB\-V\fR \fIversion\fR \fB\-b\fR \fImachine\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
363 |
.Ip "\fIMachine Dependent Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
364 |
.IX Item "Machine Dependent Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
365 |
\&\fIM680x0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
366 |
\&\fB\-m68000 \-m68020 \-m68020\-40 \-m68020\-60 \-m68030 \-m68040 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
367 |
\&\-m68060 \-mcpu32 \-m5200 \-m68881 \-mbitfield \-mc68000 \-mc68020 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
368 |
\&\-mnobitfield \-mrtd \-mshort \-msoft-float \-mpcrel |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
369 |
\&\-malign-int \-mstrict-align \-msep-data \-mno-sep-data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
370 |
\&\-mshared-library-id=n \-mid-shared-library \-mno-id-shared-library\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
371 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
372 |
\&\fIM68hc1x Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
373 |
\&\fB\-m6811 \-m6812 \-m68hc11 \-m68hc12 \-m68hcs12 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
374 |
\&\-mauto-incdec \-minmax \-mlong-calls \-mshort |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
375 |
\&\-msoft-reg-count=\fR\fIcount\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
376 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
377 |
\&\fI\s-1VAX\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
378 |
\&\fB\-mg \-mgnu \-munix\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
379 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
380 |
\&\fI\s-1SPARC\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
381 |
\&\fB\-mcpu=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
382 |
\&\fB\-mtune=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
383 |
\&\fB\-mcmodel=\fR\fIcode-model\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
384 |
\&\fB\-m32 \-m64 \-mapp-regs \-mno-app-regs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
385 |
\&\-mfaster-structs \-mno-faster-structs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
386 |
\&\-mflat \-mno-flat \-mfpu \-mno-fpu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
387 |
\&\-mhard-float \-msoft-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
388 |
\&\-mhard-quad-float \-msoft-quad-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
389 |
\&\-mimpure-text \-mno-impure-text \-mlittle-endian |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
390 |
\&\-mstack-bias \-mno-stack-bias |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
391 |
\&\-munaligned-doubles \-mno-unaligned-doubles |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
392 |
\&\-mv8plus \-mno-v8plus \-mvis \-mno-vis |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
393 |
\&\-mcypress \-mf930 \-mf934 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
394 |
\&\-msparclite \-msupersparc \-mv8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
395 |
\&\-threads \-pthreads\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
396 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
397 |
\&\fI\s-1ARM\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
398 |
\&\fB\-mapcs-frame \-mno-apcs-frame |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
399 |
\&\-mapcs-26 \-mapcs-32 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
400 |
\&\-mapcs-stack-check \-mno-apcs-stack-check |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
401 |
\&\-mapcs-float \-mno-apcs-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
402 |
\&\-mapcs-reentrant \-mno-apcs-reentrant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
403 |
\&\-msched-prolog \-mno-sched-prolog |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
404 |
\&\-mlittle-endian \-mbig-endian \-mwords-little-endian |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
405 |
\&\-malignment-traps \-mno-alignment-traps |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
406 |
\&\-msoft-float \-mhard-float \-mfpe |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
407 |
\&\-mthumb-interwork \-mno-thumb-interwork |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
408 |
\&\-mcpu=\fR\fIname\fR \fB\-march=\fR\fIname\fR \fB\-mfpe=\fR\fIname\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
409 |
\&\fB\-mstructure-size-boundary=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
410 |
\&\fB\-mabort-on-noreturn |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
411 |
\&\-mlong-calls \-mno-long-calls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
412 |
\&\-msingle-pic-base \-mno-single-pic-base |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
413 |
\&\-mpic-register=\fR\fIreg\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
414 |
\&\fB\-mnop-fun-dllimport |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
415 |
\&\-mcirrus-fix-invalid-insns \-mno-cirrus-fix-invalid-insns |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
416 |
\&\-mpoke-function-name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
417 |
\&\-mthumb \-marm |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
418 |
\&\-mtpcs-frame \-mtpcs-leaf-frame |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
419 |
\&\-mcaller-super-interworking \-mcallee-super-interworking\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
420 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
421 |
\&\fI\s-1MN10300\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
422 |
\&\fB\-mmult-bug \-mno-mult-bug |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
423 |
\&\-mam33 \-mno-am33 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
424 |
\&\-mam33\-2 \-mno-am33\-2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
425 |
\&\-mno-crt0 \-mrelax\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
426 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
427 |
\&\fIM32R/D Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
428 |
\&\fB\-m32r2 \-m32rx \-m32r |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
429 |
\&\-mdebug |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
430 |
\&\-malign-loops \-mno-align-loops |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
431 |
\&\-missue-rate=\fR\fInumber\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
432 |
\&\fB\-mbranch-cost=\fR\fInumber\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
433 |
\&\fB\-mmodel=\fR\fIcode-size-model-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
434 |
\&\fB\-msdata=\fR\fIsdata-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
435 |
\&\fB\-mno-flush-func \-mflush-func=\fR\fIname\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
436 |
\&\fB\-mno-flush-trap \-mflush-trap=\fR\fInumber\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
437 |
\&\fB\-G\fR \fInum\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
438 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
439 |
\&\fI\s-1RS/6000\s0 and PowerPC Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
440 |
\&\fB\-mcpu=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
441 |
\&\fB\-mtune=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
442 |
\&\fB\-mpower \-mno-power \-mpower2 \-mno-power2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
443 |
\&\-mpowerpc \-mpowerpc64 \-mno-powerpc |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
444 |
\&\-maltivec \-mno-altivec |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
445 |
\&\-mpowerpc-gpopt \-mno-powerpc-gpopt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
446 |
\&\-mpowerpc-gfxopt \-mno-powerpc-gfxopt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
447 |
\&\-mnew-mnemonics \-mold-mnemonics |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
448 |
\&\-mfull-toc \-mminimal-toc \-mno-fp-in-toc \-mno-sum-in-toc |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
449 |
\&\-m64 \-m32 \-mxl-compat \-mno-xl-compat \-mpe |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
450 |
\&\-malign-power \-malign-natural |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
451 |
\&\-msoft-float \-mhard-float \-mmultiple \-mno-multiple |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
452 |
\&\-mstring \-mno-string \-mupdate \-mno-update |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
453 |
\&\-mfused-madd \-mno-fused-madd \-mbit-align \-mno-bit-align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
454 |
\&\-mstrict-align \-mno-strict-align \-mrelocatable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
455 |
\&\-mno-relocatable \-mrelocatable-lib \-mno-relocatable-lib |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
456 |
\&\-mtoc \-mno-toc \-mlittle \-mlittle-endian \-mbig \-mbig-endian |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
457 |
\&\-mdynamic-no-pic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
458 |
\&\-mprioritize-restricted-insns=\fR\fIpriority\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
459 |
\&\fB\-msched-costly-dep=\fR\fIdependence_type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
460 |
\&\fB\-minsert-sched-nops=\fR\fIscheme\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
461 |
\&\fB\-mcall-sysv \-mcall-netbsd |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
462 |
\&\-maix-struct-return \-msvr4\-struct-return |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
463 |
\&\-mabi=altivec \-mabi=no-altivec |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
464 |
\&\-mabi=spe \-mabi=no-spe |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
465 |
\&\-misel=yes \-misel=no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
466 |
\&\-mspe=yes \-mspe=no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
467 |
\&\-mfloat-gprs=yes \-mfloat-gprs=no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
468 |
\&\-mprototype \-mno-prototype |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
469 |
\&\-msim \-mmvme \-mads \-myellowknife \-memb \-msdata |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
470 |
\&\-msdata=\fR\fIopt\fR \fB\-mvxworks \-mwindiss \-G\fR \fInum\fR \fB\-pthread\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
471 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
472 |
\&\fIDarwin Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
473 |
\&\fB\-all_load \-allowable_client \-arch \-arch_errors_fatal |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
474 |
\&\-arch_only \-bind_at_load \-bundle \-bundle_loader |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
475 |
\&\-client_name \-compatibility_version \-current_version |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
476 |
\&\-dependency-file \-dylib_file \-dylinker_install_name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
477 |
\&\-dynamic \-dynamiclib \-exported_symbols_list |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
478 |
\&\-filelist \-flat_namespace \-force_cpusubtype_ALL |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
479 |
\&\-force_flat_namespace \-headerpad_max_install_names |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
480 |
\&\-image_base \-init \-install_name \-keep_private_externs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
481 |
\&\-multi_module \-multiply_defined \-multiply_defined_unused |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
482 |
\&\-noall_load \-nofixprebinding \-nomultidefs \-noprebind \-noseglinkedit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
483 |
\&\-pagezero_size \-prebind \-prebind_all_twolevel_modules |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
484 |
\&\-private_bundle \-read_only_relocs \-sectalign |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
485 |
\&\-sectobjectsymbols \-whyload \-seg1addr |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
486 |
\&\-sectcreate \-sectobjectsymbols \-sectorder |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
487 |
\&\-seg_addr_table \-seg_addr_table_filename \-seglinkedit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
488 |
\&\-segprot \-segs_read_only_addr \-segs_read_write_addr |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
489 |
\&\-single_module \-static \-sub_library \-sub_umbrella |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
490 |
\&\-twolevel_namespace \-umbrella \-undefined |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
491 |
\&\-unexported_symbols_list \-weak_reference_mismatches |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
492 |
\&\-whatsloaded\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
493 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
494 |
\&\fI\s-1MIPS\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
495 |
\&\fB\-EL \-EB \-march=\fR\fIarch\fR \fB\-mtune=\fR\fIarch\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
496 |
\&\fB\-mips1 \-mips2 \-mips3 \-mips4 \-mips32 \-mips32r2 \-mips64 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
497 |
\&\-mips16 \-mno-mips16 \-mabi=\fR\fIabi\fR \fB\-mabicalls \-mno-abicalls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
498 |
\&\-mxgot \-mno-xgot \-membedded-pic \-mno-embedded-pic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
499 |
\&\-mgp32 \-mgp64 \-mfp32 \-mfp64 \-mhard-float \-msoft-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
500 |
\&\-msingle-float \-mdouble-float \-mint64 \-mlong64 \-mlong32 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
501 |
\&\-G\fR\fInum\fR \fB\-membedded-data \-mno-embedded-data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
502 |
\&\-muninit-const-in-rodata \-mno-uninit-const-in-rodata |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
503 |
\&\-msplit-addresses \-mno-split-addresses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
504 |
\&\-mexplicit-relocs \-mno-explicit-relocs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
505 |
\&\-mrnames \-mno-rnames |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
506 |
\&\-mcheck-zero-division \-mno-check-zero-division |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
507 |
\&\-mmemcpy \-mno-memcpy \-mlong-calls \-mno-long-calls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
508 |
\&\-mmad \-mno-mad \-mfused-madd \-mno-fused-madd \-nocpp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
509 |
\&\-mfix-sb1 \-mno-fix-sb1 \-mflush-func=\fR\fIfunc\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
510 |
\&\fB\-mno-flush-func \-mbranch-likely \-mno-branch-likely\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
511 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
512 |
\&\fIi386 and x86\-64 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
513 |
\&\fB\-mtune=\fR\fIcpu-type\fR \fB\-march=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
514 |
\&\fB\-mfpmath=\fR\fIunit\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
515 |
\&\fB\-masm=\fR\fIdialect\fR \fB\-mno-fancy-math-387 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
516 |
\&\-mno-fp-ret-in-387 \-msoft-float \-msvr3\-shlib |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
517 |
\&\-mno-wide-multiply \-mrtd \-malign-double |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
518 |
\&\-mpreferred-stack-boundary=\fR\fInum\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
519 |
\&\fB\-mmmx \-msse \-msse2 \-msse3 \-m3dnow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
520 |
\&\-mthreads \-mno-align-stringops \-minline-all-stringops |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
521 |
\&\-mpush-args \-maccumulate-outgoing-args \-m128bit-long-double |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
522 |
\&\-m96bit-long-double \-mregparm=\fR\fInum\fR \fB\-momit-leaf-frame-pointer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
523 |
\&\-mno-red-zone \-mno-tls-direct-seg-refs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
524 |
\&\-mcmodel=\fR\fIcode-model\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
525 |
\&\fB\-m32 \-m64 \-mstack-arg-probe\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
526 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
527 |
\&\fI\s-1HPPA\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
528 |
\&\fB\-march=\fR\fIarchitecture-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
529 |
\&\fB\-mbig-switch \-mdisable-fpregs \-mdisable-indexing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
530 |
\&\-mfast-indirect-calls \-mgas \-mgnu-ld \-mhp-ld |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
531 |
\&\-mjump-in-delay \-mlinker-opt \-mlong-calls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
532 |
\&\-mlong-load-store \-mno-big-switch \-mno-disable-fpregs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
533 |
\&\-mno-disable-indexing \-mno-fast-indirect-calls \-mno-gas |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
534 |
\&\-mno-jump-in-delay \-mno-long-load-store |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
535 |
\&\-mno-portable-runtime \-mno-soft-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
536 |
\&\-mno-space-regs \-msoft-float \-mpa-risc-1\-0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
537 |
\&\-mpa-risc-1\-1 \-mpa-risc-2\-0 \-mportable-runtime |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
538 |
\&\-mschedule=\fR\fIcpu-type\fR \fB\-mspace-regs \-msio \-mwsio |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
539 |
\&\-nolibdld \-static \-threads\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
540 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
541 |
\&\fIIntel 960 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
542 |
\&\fB\-m\fR\fIcpu-type\fR \fB\-masm-compat \-mclean-linkage |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
543 |
\&\-mcode-align \-mcomplex-addr \-mleaf-procedures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
544 |
\&\-mic-compat \-mic2.0\-compat \-mic3.0\-compat |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
545 |
\&\-mintel-asm \-mno-clean-linkage \-mno-code-align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
546 |
\&\-mno-complex-addr \-mno-leaf-procedures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
547 |
\&\-mno-old-align \-mno-strict-align \-mno-tail-call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
548 |
\&\-mnumerics \-mold-align \-msoft-float \-mstrict-align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
549 |
\&\-mtail-call\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
550 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
551 |
\&\fI\s-1DEC\s0 Alpha Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
552 |
\&\fB\-mno-fp-regs \-msoft-float \-malpha-as \-mgas |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
553 |
\&\-mieee \-mieee-with-inexact \-mieee-conformant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
554 |
\&\-mfp-trap-mode=\fR\fImode\fR \fB\-mfp-rounding-mode=\fR\fImode\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
555 |
\&\fB\-mtrap-precision=\fR\fImode\fR \fB\-mbuild-constants |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
556 |
\&\-mcpu=\fR\fIcpu-type\fR \fB\-mtune=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
557 |
\&\fB\-mbwx \-mmax \-mfix \-mcix |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
558 |
\&\-mfloat-vax \-mfloat-ieee |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
559 |
\&\-mexplicit-relocs \-msmall-data \-mlarge-data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
560 |
\&\-msmall-text \-mlarge-text |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
561 |
\&\-mmemory-latency=\fR\fItime\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
562 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
563 |
\&\fI\s-1DEC\s0 Alpha/VMS Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
564 |
\&\fB\-mvms-return-codes\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
565 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
566 |
\&\fIH8/300 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
567 |
\&\fB\-mrelax \-mh \-ms \-mn \-mint32 \-malign-300\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
568 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
569 |
\&\fI\s-1SH\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
570 |
\&\fB\-m1 \-m2 \-m2e \-m3 \-m3e |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
571 |
\&\-m4\-nofpu \-m4\-single-only \-m4\-single \-m4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
572 |
\&\-m5\-64media \-m5\-64media-nofpu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
573 |
\&\-m5\-32media \-m5\-32media-nofpu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
574 |
\&\-m5\-compact \-m5\-compact-nofpu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
575 |
\&\-mb \-ml \-mdalign \-mrelax |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
576 |
\&\-mbigtable \-mfmovd \-mhitachi \-mnomacsave |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
577 |
\&\-mieee \-misize \-mpadstruct \-mspace |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
578 |
\&\-mprefergot \-musermode\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
579 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
580 |
\&\fISystem V Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
581 |
\&\fB\-Qy \-Qn \-YP,\fR\fIpaths\fR \fB\-Ym,\fR\fIdir\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
582 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
583 |
\&\fI\s-1ARC\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
584 |
\&\fB\-EB \-EL |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
585 |
\&\-mmangle-cpu \-mcpu=\fR\fIcpu\fR \fB\-mtext=\fR\fItext-section\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
586 |
\&\fB\-mdata=\fR\fIdata-section\fR \fB\-mrodata=\fR\fIreadonly-data-section\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
587 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
588 |
\&\fITMS320C3x/C4x Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
589 |
\&\fB\-mcpu=\fR\fIcpu\fR \fB\-mbig \-msmall \-mregparm \-mmemparm |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
590 |
\&\-mfast-fix \-mmpyi \-mbk \-mti \-mdp-isr-reload |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
591 |
\&\-mrpts=\fR\fIcount\fR \fB\-mrptb \-mdb \-mloop-unsigned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
592 |
\&\-mparallel-insns \-mparallel-mpy \-mpreserve-float\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
593 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
594 |
\&\fIV850 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
595 |
\&\fB\-mlong-calls \-mno-long-calls \-mep \-mno-ep |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
596 |
\&\-mprolog-function \-mno-prolog-function \-mspace |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
597 |
\&\-mtda=\fR\fIn\fR \fB\-msda=\fR\fIn\fR \fB\-mzda=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
598 |
\&\fB\-mapp-regs \-mno-app-regs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
599 |
\&\-mdisable-callt \-mno-disable-callt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
600 |
\&\-mv850e1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
601 |
\&\-mv850e |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
602 |
\&\-mv850 \-mbig-switch\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
603 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
604 |
\&\fI\s-1NS32K\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
605 |
\&\fB\-m32032 \-m32332 \-m32532 \-m32081 \-m32381 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
606 |
\&\-mmult-add \-mnomult-add \-msoft-float \-mrtd \-mnortd |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
607 |
\&\-mregparam \-mnoregparam \-msb \-mnosb |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
608 |
\&\-mbitfield \-mnobitfield \-mhimem \-mnohimem\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
609 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
610 |
\&\fI\s-1AVR\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
611 |
\&\fB\-mmcu=\fR\fImcu\fR \fB\-msize \-minit-stack=\fR\fIn\fR \fB\-mno-interrupts |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
612 |
\&\-mcall-prologues \-mno-tablejump \-mtiny-stack\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
613 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
614 |
\&\fIMCore Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
615 |
\&\fB\-mhardlit \-mno-hardlit \-mdiv \-mno-div \-mrelax-immediates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
616 |
\&\-mno-relax-immediates \-mwide-bitfields \-mno-wide-bitfields |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
617 |
\&\-m4byte-functions \-mno-4byte-functions \-mcallgraph-data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
618 |
\&\-mno-callgraph-data \-mslow-bytes \-mno-slow-bytes \-mno-lsim |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
619 |
\&\-mlittle-endian \-mbig-endian \-m210 \-m340 \-mstack-increment\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
620 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
621 |
\&\fI\s-1MMIX\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
622 |
\&\fB\-mlibfuncs \-mno-libfuncs \-mepsilon \-mno-epsilon \-mabi=gnu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
623 |
\&\-mabi=mmixware \-mzero-extend \-mknuthdiv \-mtoplevel-symbols |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
624 |
\&\-melf \-mbranch-predict \-mno-branch-predict \-mbase-addresses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
625 |
\&\-mno-base-addresses \-msingle-exit \-mno-single-exit\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
626 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
627 |
\&\fI\s-1IA-64\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
628 |
\&\fB\-mbig-endian \-mlittle-endian \-mgnu-as \-mgnu-ld \-mno-pic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
629 |
\&\-mvolatile-asm-stop \-mb-step \-mregister-names \-mno-sdata |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
630 |
\&\-mconstant-gp \-mauto-pic \-minline-float-divide-min-latency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
631 |
\&\-minline-float-divide-max-throughput |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
632 |
\&\-minline-int-divide-min-latency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
633 |
\&\-minline-int-divide-max-throughput |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
634 |
\&\-minline-sqrt-min-latency \-minline-sqrt-max-throughput |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
635 |
\&\-mno-dwarf2\-asm \-mearly-stop-bits |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
636 |
\&\-mfixed-range=\fR\fIregister-range\fR \fB\-mtls-size=\fR\fItls-size\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
637 |
\&\fB\-mtune=\fR\fIcpu-type\fR \fB\-mt \-pthread \-milp32 \-mlp64\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
638 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
639 |
\&\fID30V Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
640 |
\&\fB\-mextmem \-mextmemory \-monchip \-mno-asm-optimize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
641 |
\&\-masm-optimize \-mbranch-cost=\fR\fIn\fR \fB\-mcond-exec=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
642 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
643 |
\&\fIS/390 and zSeries Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
644 |
\&\fB\-mtune=\fR\fIcpu-type\fR \fB\-march=\fR\fIcpu-type\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
645 |
\&\fB\-mhard-float \-msoft-float \-mbackchain \-mno-backchain |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
646 |
\&\-msmall-exec \-mno-small-exec \-mmvcle \-mno-mvcle |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
647 |
\&\-m64 \-m31 \-mdebug \-mno-debug \-mesa \-mzarch \-mfused-madd \-mno-fused-madd\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
648 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
649 |
\&\fI\s-1CRIS\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
650 |
\&\fB\-mcpu=\fR\fIcpu\fR \fB\-march=\fR\fIcpu\fR \fB\-mtune=\fR\fIcpu\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
651 |
\&\fB\-mmax-stack-frame=\fR\fIn\fR \fB\-melinux-stacksize=\fR\fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
652 |
\&\fB\-metrax4 \-metrax100 \-mpdebug \-mcc-init \-mno-side-effects |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
653 |
\&\-mstack-align \-mdata-align \-mconst-align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
654 |
\&\-m32\-bit \-m16\-bit \-m8\-bit \-mno-prologue-epilogue \-mno-gotplt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
655 |
\&\-melf \-maout \-melinux \-mlinux \-sim \-sim2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
656 |
\&\-mmul-bug-workaround \-mno-mul-bug-workaround\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
657 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
658 |
\&\fI\s-1PDP-11\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
659 |
\&\fB\-mfpu \-msoft-float \-mac0 \-mno-ac0 \-m40 \-m45 \-m10 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
660 |
\&\-mbcopy \-mbcopy-builtin \-mint32 \-mno-int16 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
661 |
\&\-mint16 \-mno-int32 \-mfloat32 \-mno-float64 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
662 |
\&\-mfloat64 \-mno-float32 \-mabshi \-mno-abshi |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
663 |
\&\-mbranch-expensive \-mbranch-cheap |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
664 |
\&\-msplit \-mno-split \-munix-asm \-mdec-asm\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
665 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
666 |
\&\fIXstormy16 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
667 |
\&\fB\-msim\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
668 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
669 |
\&\fIXtensa Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
670 |
\&\fB\-mconst16 \-mno-const16 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
671 |
\&\-mfused-madd \-mno-fused-madd |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
672 |
\&\-mtext-section-literals \-mno-text-section-literals |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
673 |
\&\-mtarget-align \-mno-target-align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
674 |
\&\-mlongcalls \-mno-longcalls\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
675 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
676 |
\&\fI\s-1FRV\s0 Options\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
677 |
\&\fB\-mgpr-32 \-mgpr-64 \-mfpr-32 \-mfpr-64 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
678 |
\&\-mhard-float \-msoft-float |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
679 |
\&\-malloc-cc \-mfixed-cc \-mdword \-mno-dword |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
680 |
\&\-mdouble \-mno-double |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
681 |
\&\-mmedia \-mno-media \-mmuladd \-mno-muladd |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
682 |
\&\-mlibrary-pic \-macc-4 \-macc-8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
683 |
\&\-mpack \-mno-pack \-mno-eflags \-mcond-move \-mno-cond-move |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
684 |
\&\-mscc \-mno-scc \-mcond-exec \-mno-cond-exec |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
685 |
\&\-mvliw-branch \-mno-vliw-branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
686 |
\&\-mmulti-cond-exec \-mno-multi-cond-exec \-mnested-cond-exec |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
687 |
\&\-mno-nested-cond-exec \-mtomcat-stats |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
688 |
\&\-mcpu=\fR\fIcpu\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
689 |
.Ip "\fICode Generation Options\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
690 |
.IX Item "Code Generation Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
691 |
\&\fB\-fcall-saved-\fR\fIreg\fR \fB\-fcall-used-\fR\fIreg\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
692 |
\&\fB\-ffixed-\fR\fIreg\fR \fB\-fexceptions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
693 |
\&\-fnon-call-exceptions \-funwind-tables |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
694 |
\&\-fasynchronous-unwind-tables |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
695 |
\&\-finhibit-size-directive \-finstrument-functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
696 |
\&\-fno-common \-fno-ident |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
697 |
\&\-fpcc-struct-return \-fpic \-fPIC \-fpie \-fPIE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
698 |
\&\-freg-struct-return \-fshared-data \-fshort-enums |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
699 |
\&\-fshort-double \-fshort-wchar |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
700 |
\&\-fverbose-asm \-fpack-struct \-fstack-check |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
701 |
\&\-fstack-limit-register=\fR\fIreg\fR \fB\-fstack-limit-symbol=\fR\fIsym\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
702 |
\&\fB\-fargument-alias \-fargument-noalias |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
703 |
\&\-fargument-noalias-global \-fleading-underscore |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
704 |
\&\-ftls-model=\fR\fImodel\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
705 |
\&\fB\-ftrapv \-fwrapv \-fbounds-check\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
706 |
.Sh "Options Controlling the Kind of Output" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
707 |
.IX Subsection "Options Controlling the Kind of Output" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
708 |
Compilation can involve up to four stages: preprocessing, compilation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
709 |
proper, assembly and linking, always in that order. \s-1GCC\s0 is capable of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
710 |
preprocessing and compiling several files either into several |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
711 |
assembler input files, or into one assembler input file; then each |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
712 |
assembler input file produces an object file, and linking combines all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
713 |
the object files (those newly compiled, and those specified as input) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
714 |
into an executable file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
715 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
716 |
For any given input file, the file name suffix determines what kind of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
717 |
compilation is done: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
718 |
.Ip "\fIfile\fR\fB.c\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
719 |
.IX Item "file.c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
720 |
C source code which must be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
721 |
.Ip "\fIfile\fR\fB.i\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
722 |
.IX Item "file.i" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
723 |
C source code which should not be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
724 |
.Ip "\fIfile\fR\fB.ii\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
725 |
.IX Item "file.ii" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
726 |
\&\*(C+ source code which should not be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
727 |
.Ip "\fIfile\fR\fB.m\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
728 |
.IX Item "file.m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
729 |
Objective-C source code. Note that you must link with the library |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
730 |
\&\fIlibobjc.a\fR to make an Objective-C program work. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
731 |
.Ip "\fIfile\fR\fB.mi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
732 |
.IX Item "file.mi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
733 |
Objective-C source code which should not be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
734 |
.Ip "\fIfile\fR\fB.h\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
735 |
.IX Item "file.h" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
736 |
C or \*(C+ header file to be turned into a precompiled header. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
737 |
.Ip "\fIfile\fR\fB.cc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
738 |
.IX Item "file.cc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
739 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
740 |
.Ip "\fIfile\fR\fB.cp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
741 |
.IX Item "file.cp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
742 |
.Ip "\fIfile\fR\fB.cxx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
743 |
.IX Item "file.cxx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
744 |
.Ip "\fIfile\fR\fB.cpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
745 |
.IX Item "file.cpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
746 |
.Ip "\fIfile\fR\fB.CPP\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
747 |
.IX Item "file.CPP" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
748 |
.Ip "\fIfile\fR\fB.c++\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
749 |
.IX Item "file.c++" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
750 |
.Ip "\fIfile\fR\fB.C\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
751 |
.IX Item "file.C" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
752 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
753 |
\&\*(C+ source code which must be preprocessed. Note that in \fB.cxx\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
754 |
the last two letters must both be literally \fBx\fR. Likewise, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
755 |
\&\fB.C\fR refers to a literal capital C. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
756 |
.Ip "\fIfile\fR\fB.hh\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
757 |
.IX Item "file.hh" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
758 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
759 |
.Ip "\fIfile\fR\fB.H\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
760 |
.IX Item "file.H" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
761 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
762 |
\&\*(C+ header file to be turned into a precompiled header. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
763 |
.Ip "\fIfile\fR\fB.f\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
764 |
.IX Item "file.f" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
765 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
766 |
.Ip "\fIfile\fR\fB.for\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
767 |
.IX Item "file.for" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
768 |
.Ip "\fIfile\fR\fB.FOR\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
769 |
.IX Item "file.FOR" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
770 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
771 |
Fortran source code which should not be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
772 |
.Ip "\fIfile\fR\fB.F\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
773 |
.IX Item "file.F" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
774 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
775 |
.Ip "\fIfile\fR\fB.fpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
776 |
.IX Item "file.fpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
777 |
.Ip "\fIfile\fR\fB.FPP\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
778 |
.IX Item "file.FPP" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
779 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
780 |
Fortran source code which must be preprocessed (with the traditional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
781 |
preprocessor). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
782 |
.Ip "\fIfile\fR\fB.r\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
783 |
.IX Item "file.r" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
784 |
Fortran source code which must be preprocessed with a \s-1RATFOR\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
785 |
preprocessor (not included with \s-1GCC\s0). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
786 |
.Ip "\fIfile\fR\fB.ads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
787 |
.IX Item "file.ads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
788 |
Ada source code file which contains a library unit declaration (a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
789 |
declaration of a package, subprogram, or generic, or a generic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
790 |
instantiation), or a library unit renaming declaration (a package, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
791 |
generic, or subprogram renaming declaration). Such files are also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
792 |
called \fIspecs\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
793 |
.Ip "\fIfile\fR\fB.adb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
794 |
.IX Item "file.adb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
795 |
Ada source code file containing a library unit body (a subprogram or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
796 |
package body). Such files are also called \fIbodies\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
797 |
.Ip "\fIfile\fR\fB.s\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
798 |
.IX Item "file.s" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
799 |
Assembler code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
800 |
.Ip "\fIfile\fR\fB.S\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
801 |
.IX Item "file.S" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
802 |
Assembler code which must be preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
803 |
.Ip "\fIother\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
804 |
.IX Item "other" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
805 |
An object file to be fed straight into linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
806 |
Any file name with no recognized suffix is treated this way. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
807 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
808 |
You can specify the input language explicitly with the \fB\-x\fR option: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
809 |
.Ip "\fB\-x\fR \fIlanguage\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
810 |
.IX Item "-x language" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
811 |
Specify explicitly the \fIlanguage\fR for the following input files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
812 |
(rather than letting the compiler choose a default based on the file |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
813 |
name suffix). This option applies to all following input files until |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
814 |
the next \fB\-x\fR option. Possible values for \fIlanguage\fR are: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
815 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
816 |
.Vb 8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
817 |
\& c c-header cpp-output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
818 |
\& c++ c++-header c++-cpp-output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
819 |
\& objective-c objective-c-header objc-cpp-output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
820 |
\& assembler assembler-with-cpp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
821 |
\& ada |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
822 |
\& f77 f77-cpp-input ratfor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
823 |
\& java |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
824 |
\& treelang |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
825 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
826 |
.Ip "\fB\-x none\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
827 |
.IX Item "-x none" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
828 |
Turn off any specification of a language, so that subsequent files are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
829 |
handled according to their file name suffixes (as they are if \fB\-x\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
830 |
has not been used at all). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
831 |
.Ip "\fB\-pass-exit-codes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
832 |
.IX Item "-pass-exit-codes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
833 |
Normally the \fBgcc\fR program will exit with the code of 1 if any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
834 |
phase of the compiler returns a non-success return code. If you specify |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
835 |
\&\fB\-pass-exit-codes\fR, the \fBgcc\fR program will instead return with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
836 |
numerically highest error produced by any phase that returned an error |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
837 |
indication. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
838 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
839 |
If you only want some of the stages of compilation, you can use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
840 |
\&\fB\-x\fR (or filename suffixes) to tell \fBgcc\fR where to start, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
841 |
one of the options \fB\-c\fR, \fB\-S\fR, or \fB\-E\fR to say where |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
842 |
\&\fBgcc\fR is to stop. Note that some combinations (for example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
843 |
\&\fB\-x cpp-output \-E\fR) instruct \fBgcc\fR to do nothing at all. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
844 |
.Ip "\fB\-c\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
845 |
.IX Item "-c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
846 |
Compile or assemble the source files, but do not link. The linking |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
847 |
stage simply is not done. The ultimate output is in the form of an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
848 |
object file for each source file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
849 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
850 |
By default, the object file name for a source file is made by replacing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
851 |
the suffix \fB.c\fR, \fB.i\fR, \fB.s\fR, etc., with \fB.o\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
852 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
853 |
Unrecognized input files, not requiring compilation or assembly, are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
854 |
ignored. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
855 |
.Ip "\fB\-S\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
856 |
.IX Item "-S" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
857 |
Stop after the stage of compilation proper; do not assemble. The output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
858 |
is in the form of an assembler code file for each non-assembler input |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
859 |
file specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
860 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
861 |
By default, the assembler file name for a source file is made by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
862 |
replacing the suffix \fB.c\fR, \fB.i\fR, etc., with \fB.s\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
863 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
864 |
Input files that don't require compilation are ignored. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
865 |
.Ip "\fB\-E\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
866 |
.IX Item "-E" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
867 |
Stop after the preprocessing stage; do not run the compiler proper. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
868 |
output is in the form of preprocessed source code, which is sent to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
869 |
standard output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
870 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
871 |
Input files which don't require preprocessing are ignored. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
872 |
.Ip "\fB\-o\fR \fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
873 |
.IX Item "-o file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
874 |
Place output in file \fIfile\fR. This applies regardless to whatever |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
875 |
sort of output is being produced, whether it be an executable file, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
876 |
an object file, an assembler file or preprocessed C code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
877 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
878 |
If you specify \fB\-o\fR when compiling more than one input file, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
879 |
you are producing an executable file as output, all the source files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
880 |
on the command line will be compiled at once. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
881 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
882 |
If \fB\-o\fR is not specified, the default is to put an executable file |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
883 |
in \fIa.out\fR, the object file for \fI\fIsource\fI.\fIsuffix\fI\fR in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
884 |
\&\fI\fIsource\fI.o\fR, its assembler file in \fI\fIsource\fI.s\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
885 |
all preprocessed C source on standard output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
886 |
.Ip "\fB\-v\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
887 |
.IX Item "-v" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
888 |
Print (on standard error output) the commands executed to run the stages |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
889 |
of compilation. Also print the version number of the compiler driver |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
890 |
program and of the preprocessor and the compiler proper. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
891 |
.Ip "\fB\-###\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
892 |
.IX Item "-###" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
893 |
Like \fB\-v\fR except the commands are not executed and all command |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
894 |
arguments are quoted. This is useful for shell scripts to capture the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
895 |
driver-generated command lines. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
896 |
.Ip "\fB\-pipe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
897 |
.IX Item "-pipe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
898 |
Use pipes rather than temporary files for communication between the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
899 |
various stages of compilation. This fails to work on some systems where |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
900 |
the assembler is unable to read from a pipe; but the \s-1GNU\s0 assembler has |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
901 |
no trouble. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
902 |
.Ip "\fB\*(--help\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
903 |
.IX Item "help" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
904 |
Print (on the standard output) a description of the command line options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
905 |
understood by \fBgcc\fR. If the \fB\-v\fR option is also specified |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
906 |
then \fB\*(--help\fR will also be passed on to the various processes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
907 |
invoked by \fBgcc\fR, so that they can display the command line options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
908 |
they accept. If the \fB\-Wextra\fR option is also specified then command |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
909 |
line options which have no documentation associated with them will also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
910 |
be displayed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
911 |
.Ip "\fB\*(--target-help\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
912 |
.IX Item "target-help" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
913 |
Print (on the standard output) a description of target specific command |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
914 |
line options for each tool. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
915 |
.Ip "\fB\*(--version\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
916 |
.IX Item "version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
917 |
Display the version number and copyrights of the invoked \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
918 |
.Sh "Compiling \*(C+ Programs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
919 |
.IX Subsection "Compiling Programs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
920 |
\&\*(C+ source files conventionally use one of the suffixes \fB.C\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
921 |
\&\fB.cc\fR, \fB.cpp\fR, \fB.CPP\fR, \fB.c++\fR, \fB.cp\fR, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
922 |
\&\fB.cxx\fR; \*(C+ header files often use \fB.hh\fR or \fB.H\fR; and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
923 |
preprocessed \*(C+ files use the suffix \fB.ii\fR. \s-1GCC\s0 recognizes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
924 |
files with these names and compiles them as \*(C+ programs even if you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
925 |
call the compiler the same way as for compiling C programs (usually |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
926 |
with the name \fBgcc\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
927 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
928 |
However, \*(C+ programs often require class libraries as well as a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
929 |
compiler that understands the \*(C+ language\-\-\-and under some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
930 |
circumstances, you might want to compile programs or header files from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
931 |
standard input, or otherwise without a suffix that flags them as \*(C+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
932 |
programs. You might also like to precompile a C header file with a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
933 |
\&\fB.h\fR extension to be used in \*(C+ compilations. \fBg++\fR is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
934 |
program that calls \s-1GCC\s0 with the default language set to \*(C+, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
935 |
automatically specifies linking against the \*(C+ library. On many |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
936 |
systems, \fBg++\fR is also installed with the name \fBc++\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
937 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
938 |
When you compile \*(C+ programs, you may specify many of the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
939 |
command-line options that you use for compiling programs in any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
940 |
language; or command-line options meaningful for C and related |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
941 |
languages; or options that are meaningful only for \*(C+ programs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
942 |
.Sh "Options Controlling C Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
943 |
.IX Subsection "Options Controlling C Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
944 |
The following options control the dialect of C (or languages derived |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
945 |
from C, such as \*(C+ and Objective-C) that the compiler accepts: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
946 |
.Ip "\fB\-ansi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
947 |
.IX Item "-ansi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
948 |
In C mode, support all \s-1ISO\s0 C90 programs. In \*(C+ mode, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
949 |
remove \s-1GNU\s0 extensions that conflict with \s-1ISO\s0 \*(C+. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
950 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
951 |
This turns off certain features of \s-1GCC\s0 that are incompatible with \s-1ISO\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
952 |
C90 (when compiling C code), or of standard \*(C+ (when compiling \*(C+ code), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
953 |
such as the \f(CW\*(C`asm\*(C'\fR and \f(CW\*(C`typeof\*(C'\fR keywords, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
954 |
predefined macros such as \f(CW\*(C`unix\*(C'\fR and \f(CW\*(C`vax\*(C'\fR that identify the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
955 |
type of system you are using. It also enables the undesirable and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
956 |
rarely used \s-1ISO\s0 trigraph feature. For the C compiler, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
957 |
it disables recognition of \*(C+ style \fB//\fR comments as well as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
958 |
the \f(CW\*(C`inline\*(C'\fR keyword. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
959 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
960 |
The alternate keywords \f(CW\*(C`_\|_asm_\|_\*(C'\fR, \f(CW\*(C`_\|_extension_\|_\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
961 |
\&\f(CW\*(C`_\|_inline_\|_\*(C'\fR and \f(CW\*(C`_\|_typeof_\|_\*(C'\fR continue to work despite |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
962 |
\&\fB\-ansi\fR. You would not want to use them in an \s-1ISO\s0 C program, of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
963 |
course, but it is useful to put them in header files that might be included |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
964 |
in compilations done with \fB\-ansi\fR. Alternate predefined macros |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
965 |
such as \f(CW\*(C`_\|_unix_\|_\*(C'\fR and \f(CW\*(C`_\|_vax_\|_\*(C'\fR are also available, with or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
966 |
without \fB\-ansi\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
967 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
968 |
The \fB\-ansi\fR option does not cause non-ISO programs to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
969 |
rejected gratuitously. For that, \fB\-pedantic\fR is required in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
970 |
addition to \fB\-ansi\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
971 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
972 |
The macro \f(CW\*(C`_\|_STRICT_ANSI_\|_\*(C'\fR is predefined when the \fB\-ansi\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
973 |
option is used. Some header files may notice this macro and refrain |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
974 |
from declaring certain functions or defining certain macros that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
975 |
\&\s-1ISO\s0 standard doesn't call for; this is to avoid interfering with any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
976 |
programs that might use these names for other things. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
977 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
978 |
Functions which would normally be built in but do not have semantics |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
979 |
defined by \s-1ISO\s0 C (such as \f(CW\*(C`alloca\*(C'\fR and \f(CW\*(C`ffs\*(C'\fR) are not built-in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
980 |
functions with \fB\-ansi\fR is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
981 |
.Ip "\fB\-std=\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
982 |
.IX Item "-std=" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
983 |
Determine the language standard. This option is currently only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
984 |
supported when compiling C or \*(C+. A value for this option must be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
985 |
provided; possible values are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
986 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
987 |
.Ip "\fBc89\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
988 |
.IX Item "c89" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
989 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
990 |
.Ip "\fBiso9899:1990\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
991 |
.IX Item "iso9899:1990" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
992 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
993 |
\&\s-1ISO\s0 C90 (same as \fB\-ansi\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
994 |
.Ip "\fBiso9899:199409\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
995 |
.IX Item "iso9899:199409" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
996 |
\&\s-1ISO\s0 C90 as modified in amendment 1. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
997 |
.Ip "\fBc99\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
998 |
.IX Item "c99" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
999 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1000 |
.Ip "\fBc9x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1001 |
.IX Item "c9x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1002 |
.Ip "\fBiso9899:1999\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1003 |
.IX Item "iso9899:1999" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1004 |
.Ip "\fBiso9899:199x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1005 |
.IX Item "iso9899:199x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1006 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1007 |
\&\s-1ISO\s0 C99. Note that this standard is not yet fully supported; see |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1008 |
<\fBhttp://gcc.gnu.org/gcc-3.4/c99status.html\fR> for more information. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1009 |
names \fBc9x\fR and \fBiso9899:199x\fR are deprecated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1010 |
.Ip "\fBgnu89\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1011 |
.IX Item "gnu89" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1012 |
Default, \s-1ISO\s0 C90 plus \s-1GNU\s0 extensions (including some C99 features). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1013 |
.Ip "\fBgnu99\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1014 |
.IX Item "gnu99" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1015 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1016 |
.Ip "\fBgnu9x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1017 |
.IX Item "gnu9x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1018 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1019 |
\&\s-1ISO\s0 C99 plus \s-1GNU\s0 extensions. When \s-1ISO\s0 C99 is fully implemented in \s-1GCC\s0, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1020 |
this will become the default. The name \fBgnu9x\fR is deprecated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1021 |
.Ip "\fBc++98\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1022 |
.IX Item "c++98" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1023 |
The 1998 \s-1ISO\s0 \*(C+ standard plus amendments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1024 |
.Ip "\fBgnu++98\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1025 |
.IX Item "gnu++98" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1026 |
The same as \fB\-std=c++98\fR plus \s-1GNU\s0 extensions. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1027 |
default for \*(C+ code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1028 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1029 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1030 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1031 |
Even when this option is not specified, you can still use some of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1032 |
features of newer standards in so far as they do not conflict with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1033 |
previous C standards. For example, you may use \f(CW\*(C`_\|_restrict_\|_\*(C'\fR even |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1034 |
when \fB\-std=c99\fR is not specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1035 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1036 |
The \fB\-std\fR options specifying some version of \s-1ISO\s0 C have the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1037 |
effects as \fB\-ansi\fR, except that features that were not in \s-1ISO\s0 C90 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1038 |
but are in the specified version (for example, \fB//\fR comments and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1039 |
the \f(CW\*(C`inline\*(C'\fR keyword in \s-1ISO\s0 C99) are not disabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1040 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1041 |
.Ip "\fB\-aux-info\fR \fIfilename\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1042 |
.IX Item "-aux-info filename" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1043 |
Output to the given filename prototyped declarations for all functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1044 |
declared and/or defined in a translation unit, including those in header |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1045 |
files. This option is silently ignored in any language other than C. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1046 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1047 |
Besides declarations, the file indicates, in comments, the origin of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1048 |
each declaration (source file and line), whether the declaration was |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1049 |
implicit, prototyped or unprototyped (\fBI\fR, \fBN\fR for new or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1050 |
\&\fBO\fR for old, respectively, in the first character after the line |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1051 |
number and the colon), and whether it came from a declaration or a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1052 |
definition (\fBC\fR or \fBF\fR, respectively, in the following |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1053 |
character). In the case of function definitions, a K&R-style list of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1054 |
arguments followed by their declarations is also provided, inside |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1055 |
comments, after the declaration. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1056 |
.Ip "\fB\-fno-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1057 |
.IX Item "-fno-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1058 |
Do not recognize \f(CW\*(C`asm\*(C'\fR, \f(CW\*(C`inline\*(C'\fR or \f(CW\*(C`typeof\*(C'\fR as a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1059 |
keyword, so that code can use these words as identifiers. You can use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1060 |
the keywords \f(CW\*(C`_\|_asm_\|_\*(C'\fR, \f(CW\*(C`_\|_inline_\|_\*(C'\fR and \f(CW\*(C`_\|_typeof_\|_\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1061 |
instead. \fB\-ansi\fR implies \fB\-fno-asm\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1062 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1063 |
In \*(C+, this switch only affects the \f(CW\*(C`typeof\*(C'\fR keyword, since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1064 |
\&\f(CW\*(C`asm\*(C'\fR and \f(CW\*(C`inline\*(C'\fR are standard keywords. You may want to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1065 |
use the \fB\-fno-gnu-keywords\fR flag instead, which has the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1066 |
effect. In C99 mode (\fB\-std=c99\fR or \fB\-std=gnu99\fR), this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1067 |
switch only affects the \f(CW\*(C`asm\*(C'\fR and \f(CW\*(C`typeof\*(C'\fR keywords, since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1068 |
\&\f(CW\*(C`inline\*(C'\fR is a standard keyword in \s-1ISO\s0 C99. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1069 |
.Ip "\fB\-fno-builtin\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1070 |
.IX Item "-fno-builtin" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1071 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1072 |
.Ip "\fB\-fno-builtin-\fR\fIfunction\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1073 |
.IX Item "-fno-builtin-function" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1074 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1075 |
Don't recognize built-in functions that do not begin with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1076 |
\&\fB_\|_builtin_\fR as prefix. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1077 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1078 |
\&\s-1GCC\s0 normally generates special code to handle certain built-in functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1079 |
more efficiently; for instance, calls to \f(CW\*(C`alloca\*(C'\fR may become single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1080 |
instructions that adjust the stack directly, and calls to \f(CW\*(C`memcpy\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1081 |
may become inline copy loops. The resulting code is often both smaller |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1082 |
and faster, but since the function calls no longer appear as such, you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1083 |
cannot set a breakpoint on those calls, nor can you change the behavior |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1084 |
of the functions by linking with a different library. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1085 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1086 |
With the \fB\-fno-builtin-\fR\fIfunction\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1087 |
only the built-in function \fIfunction\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1088 |
disabled. \fIfunction\fR must not begin with \fB_\|_builtin_\fR. If a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1089 |
function is named this is not built-in in this version of \s-1GCC\s0, this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1090 |
option is ignored. There is no corresponding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1091 |
\&\fB\-fbuiltin-\fR\fIfunction\fR option; if you wish to enable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1092 |
built-in functions selectively when using \fB\-fno-builtin\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1093 |
\&\fB\-ffreestanding\fR, you may define macros such as: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1094 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1095 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1096 |
\& #define abs(n) __builtin_abs ((n)) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1097 |
\& #define strcpy(d, s) __builtin_strcpy ((d), (s)) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1098 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1099 |
.Ip "\fB\-fhosted\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1100 |
.IX Item "-fhosted" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1101 |
Assert that compilation takes place in a hosted environment. This implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1102 |
\&\fB\-fbuiltin\fR. A hosted environment is one in which the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1103 |
entire standard library is available, and in which \f(CW\*(C`main\*(C'\fR has a return |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1104 |
type of \f(CW\*(C`int\*(C'\fR. Examples are nearly everything except a kernel. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1105 |
This is equivalent to \fB\-fno-freestanding\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1106 |
.Ip "\fB\-ffreestanding\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1107 |
.IX Item "-ffreestanding" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1108 |
Assert that compilation takes place in a freestanding environment. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1109 |
implies \fB\-fno-builtin\fR. A freestanding environment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1110 |
is one in which the standard library may not exist, and program startup may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1111 |
not necessarily be at \f(CW\*(C`main\*(C'\fR. The most obvious example is an \s-1OS\s0 kernel. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1112 |
This is equivalent to \fB\-fno-hosted\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1113 |
.Ip "\fB\-fms-extensions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1114 |
.IX Item "-fms-extensions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1115 |
Accept some non-standard constructs used in Microsoft header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1116 |
.Ip "\fB\-trigraphs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1117 |
.IX Item "-trigraphs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1118 |
Support \s-1ISO\s0 C trigraphs. The \fB\-ansi\fR option (and \fB\-std\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1119 |
options for strict \s-1ISO\s0 C conformance) implies \fB\-trigraphs\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1120 |
.Ip "\fB\-no-integrated-cpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1121 |
.IX Item "-no-integrated-cpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1122 |
Performs a compilation in two passes: preprocessing and compiling. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1123 |
option allows a user supplied \*(L"cc1\*(R", \*(L"cc1plus\*(R", or \*(L"cc1obj\*(R" via the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1124 |
\&\fB\-B\fR option. The user supplied compilation step can then add in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1125 |
an additional preprocessing step after normal preprocessing but before |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1126 |
compiling. The default is to use the integrated cpp (internal cpp) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1127 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1128 |
The semantics of this option will change if \*(L"cc1\*(R", \*(L"cc1plus\*(R", and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1129 |
\&\*(L"cc1obj\*(R" are merged. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1130 |
.Ip "\fB\-traditional\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1131 |
.IX Item "-traditional" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1132 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1133 |
.Ip "\fB\-traditional-cpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1134 |
.IX Item "-traditional-cpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1135 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1136 |
Formerly, these options caused \s-1GCC\s0 to attempt to emulate a pre-standard |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1137 |
C compiler. They are now only supported with the \fB\-E\fR switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1138 |
The preprocessor continues to support a pre-standard mode. See the \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1139 |
\&\s-1CPP\s0 manual for details. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1140 |
.Ip "\fB\-fcond-mismatch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1141 |
.IX Item "-fcond-mismatch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1142 |
Allow conditional expressions with mismatched types in the second and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1143 |
third arguments. The value of such an expression is void. This option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1144 |
is not supported for \*(C+. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1145 |
.Ip "\fB\-funsigned-char\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1146 |
.IX Item "-funsigned-char" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1147 |
Let the type \f(CW\*(C`char\*(C'\fR be unsigned, like \f(CW\*(C`unsigned char\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1148 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1149 |
Each kind of machine has a default for what \f(CW\*(C`char\*(C'\fR should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1150 |
be. It is either like \f(CW\*(C`unsigned char\*(C'\fR by default or like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1151 |
\&\f(CW\*(C`signed char\*(C'\fR by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1152 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1153 |
Ideally, a portable program should always use \f(CW\*(C`signed char\*(C'\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1154 |
\&\f(CW\*(C`unsigned char\*(C'\fR when it depends on the signedness of an object. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1155 |
But many programs have been written to use plain \f(CW\*(C`char\*(C'\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1156 |
expect it to be signed, or expect it to be unsigned, depending on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1157 |
machines they were written for. This option, and its inverse, let you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1158 |
make such a program work with the opposite default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1159 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1160 |
The type \f(CW\*(C`char\*(C'\fR is always a distinct type from each of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1161 |
\&\f(CW\*(C`signed char\*(C'\fR or \f(CW\*(C`unsigned char\*(C'\fR, even though its behavior |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1162 |
is always just like one of those two. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1163 |
.Ip "\fB\-fsigned-char\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1164 |
.IX Item "-fsigned-char" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1165 |
Let the type \f(CW\*(C`char\*(C'\fR be signed, like \f(CW\*(C`signed char\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1166 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1167 |
Note that this is equivalent to \fB\-fno-unsigned-char\fR, which is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1168 |
the negative form of \fB\-funsigned-char\fR. Likewise, the option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1169 |
\&\fB\-fno-signed-char\fR is equivalent to \fB\-funsigned-char\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1170 |
.Ip "\fB\-fsigned-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1171 |
.IX Item "-fsigned-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1172 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1173 |
.Ip "\fB\-funsigned-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1174 |
.IX Item "-funsigned-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1175 |
.Ip "\fB\-fno-signed-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1176 |
.IX Item "-fno-signed-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1177 |
.Ip "\fB\-fno-unsigned-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1178 |
.IX Item "-fno-unsigned-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1179 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1180 |
These options control whether a bit-field is signed or unsigned, when the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1181 |
declaration does not use either \f(CW\*(C`signed\*(C'\fR or \f(CW\*(C`unsigned\*(C'\fR. By |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1182 |
default, such a bit-field is signed, because this is consistent: the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1183 |
basic integer types such as \f(CW\*(C`int\*(C'\fR are signed types. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1184 |
.Ip "\fB\-fwritable-strings\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1185 |
.IX Item "-fwritable-strings" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1186 |
Store string constants in the writable data segment and don't uniquize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1187 |
them. This is for compatibility with old programs which assume they can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1188 |
write into string constants. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1189 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1190 |
Writing into string constants is a very bad idea; ``constants'' should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1191 |
be constant. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1192 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1193 |
This option is deprecated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1194 |
.Sh "Options Controlling \*(C+ Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1195 |
.IX Subsection "Options Controlling Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1196 |
This section describes the command-line options that are only meaningful |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1197 |
for \*(C+ programs; but you can also use most of the \s-1GNU\s0 compiler options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1198 |
regardless of what language your program is in. For example, you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1199 |
might compile a file \f(CW\*(C`firstClass.C\*(C'\fR like this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1200 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1201 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1202 |
\& g++ -g -frepo -O -c firstClass.C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1203 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1204 |
In this example, only \fB\-frepo\fR is an option meant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1205 |
only for \*(C+ programs; you can use the other options with any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1206 |
language supported by \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1207 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1208 |
Here is a list of options that are \fIonly\fR for compiling \*(C+ programs: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1209 |
.Ip "\fB\-fabi-version=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1210 |
.IX Item "-fabi-version=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1211 |
Use version \fIn\fR of the \*(C+ \s-1ABI\s0. Version 2 is the version of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1212 |
\&\*(C+ \s-1ABI\s0 that first appeared in G++ 3.4. Version 1 is the version of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1213 |
the \*(C+ \s-1ABI\s0 that first appeared in G++ 3.2. Version 0 will always be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1214 |
the version that conforms most closely to the \*(C+ \s-1ABI\s0 specification. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1215 |
Therefore, the \s-1ABI\s0 obtained using version 0 will change as \s-1ABI\s0 bugs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1216 |
are fixed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1217 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1218 |
The default is version 2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1219 |
.Ip "\fB\-fno-access-control\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1220 |
.IX Item "-fno-access-control" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1221 |
Turn off all access checking. This switch is mainly useful for working |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1222 |
around bugs in the access control code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1223 |
.Ip "\fB\-fcheck-new\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1224 |
.IX Item "-fcheck-new" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1225 |
Check that the pointer returned by \f(CW\*(C`operator new\*(C'\fR is non-null |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1226 |
before attempting to modify the storage allocated. This check is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1227 |
normally unnecessary because the \*(C+ standard specifies that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1228 |
\&\f(CW\*(C`operator new\*(C'\fR will only return \f(CW\*(C`0\*(C'\fR if it is declared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1229 |
\&\fB\f(BIthrow()\fB\fR, in which case the compiler will always check the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1230 |
return value even without this option. In all other cases, when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1231 |
\&\f(CW\*(C`operator new\*(C'\fR has a non-empty exception specification, memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1232 |
exhaustion is signalled by throwing \f(CW\*(C`std::bad_alloc\*(C'\fR. See also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1233 |
\&\fBnew (nothrow)\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1234 |
.Ip "\fB\-fconserve-space\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1235 |
.IX Item "-fconserve-space" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1236 |
Put uninitialized or runtime-initialized global variables into the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1237 |
common segment, as C does. This saves space in the executable at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1238 |
cost of not diagnosing duplicate definitions. If you compile with this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1239 |
flag and your program mysteriously crashes after \f(CW\*(C`main()\*(C'\fR has |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1240 |
completed, you may have an object that is being destroyed twice because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1241 |
two definitions were merged. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1242 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1243 |
This option is no longer useful on most targets, now that support has |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1244 |
been added for putting variables into \s-1BSS\s0 without making them common. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1245 |
.Ip "\fB\-fno-const-strings\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1246 |
.IX Item "-fno-const-strings" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1247 |
Give string constants type \f(CW\*(C`char *\*(C'\fR instead of type \f(CW\*(C`const |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1248 |
char *\*(C'\fR. By default, G++ uses type \f(CW\*(C`const char *\*(C'\fR as required by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1249 |
the standard. Even if you use \fB\-fno-const-strings\fR, you cannot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1250 |
actually modify the value of a string constant, unless you also use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1251 |
\&\fB\-fwritable-strings\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1252 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1253 |
This option might be removed in a future release of G++. For maximum |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1254 |
portability, you should structure your code so that it works with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1255 |
string constants that have type \f(CW\*(C`const char *\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1256 |
.Ip "\fB\-fno-elide-constructors\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1257 |
.IX Item "-fno-elide-constructors" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1258 |
The \*(C+ standard allows an implementation to omit creating a temporary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1259 |
which is only used to initialize another object of the same type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1260 |
Specifying this option disables that optimization, and forces G++ to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1261 |
call the copy constructor in all cases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1262 |
.Ip "\fB\-fno-enforce-eh-specs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1263 |
.IX Item "-fno-enforce-eh-specs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1264 |
Don't check for violation of exception specifications at runtime. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1265 |
option violates the \*(C+ standard, but may be useful for reducing code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1266 |
size in production builds, much like defining \fB\s-1NDEBUG\s0\fR. The compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1267 |
will still optimize based on the exception specifications. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1268 |
.Ip "\fB\-ffor-scope\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1269 |
.IX Item "-ffor-scope" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1270 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1271 |
.Ip "\fB\-fno-for-scope\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1272 |
.IX Item "-fno-for-scope" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1273 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1274 |
If \fB\-ffor-scope\fR is specified, the scope of variables declared in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1275 |
a \fIfor-init-statement\fR is limited to the \fBfor\fR loop itself, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1276 |
as specified by the \*(C+ standard. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1277 |
If \fB\-fno-for-scope\fR is specified, the scope of variables declared in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1278 |
a \fIfor-init-statement\fR extends to the end of the enclosing scope, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1279 |
as was the case in old versions of G++, and other (traditional) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1280 |
implementations of \*(C+. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1281 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1282 |
The default if neither flag is given to follow the standard, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1283 |
but to allow and give a warning for old-style code that would |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1284 |
otherwise be invalid, or have different behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1285 |
.Ip "\fB\-fno-gnu-keywords\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1286 |
.IX Item "-fno-gnu-keywords" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1287 |
Do not recognize \f(CW\*(C`typeof\*(C'\fR as a keyword, so that code can use this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1288 |
word as an identifier. You can use the keyword \f(CW\*(C`_\|_typeof_\|_\*(C'\fR instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1289 |
\&\fB\-ansi\fR implies \fB\-fno-gnu-keywords\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1290 |
.Ip "\fB\-fno-implicit-templates\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1291 |
.IX Item "-fno-implicit-templates" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1292 |
Never emit code for non-inline templates which are instantiated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1293 |
implicitly (i.e. by use); only emit code for explicit instantiations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1294 |
.Ip "\fB\-fno-implicit-inline-templates\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1295 |
.IX Item "-fno-implicit-inline-templates" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1296 |
Don't emit code for implicit instantiations of inline templates, either. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1297 |
The default is to handle inlines differently so that compiles with and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1298 |
without optimization will need the same set of explicit instantiations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1299 |
.Ip "\fB\-fno-implement-inlines\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1300 |
.IX Item "-fno-implement-inlines" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1301 |
To save space, do not emit out-of-line copies of inline functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1302 |
controlled by \fB#pragma implementation\fR. This will cause linker |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1303 |
errors if these functions are not inlined everywhere they are called. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1304 |
.Ip "\fB\-fms-extensions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1305 |
.IX Item "-fms-extensions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1306 |
Disable pedantic warnings about constructs used in \s-1MFC\s0, such as implicit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1307 |
int and getting a pointer to member function via non-standard syntax. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1308 |
.Ip "\fB\-fno-nonansi-builtins\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1309 |
.IX Item "-fno-nonansi-builtins" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1310 |
Disable built-in declarations of functions that are not mandated by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1311 |
\&\s-1ANSI/ISO\s0 C. These include \f(CW\*(C`ffs\*(C'\fR, \f(CW\*(C`alloca\*(C'\fR, \f(CW\*(C`_exit\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1312 |
\&\f(CW\*(C`index\*(C'\fR, \f(CW\*(C`bzero\*(C'\fR, \f(CW\*(C`conjf\*(C'\fR, and other related functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1313 |
.Ip "\fB\-fno-operator-names\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1314 |
.IX Item "-fno-operator-names" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1315 |
Do not treat the operator name keywords \f(CW\*(C`and\*(C'\fR, \f(CW\*(C`bitand\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1316 |
\&\f(CW\*(C`bitor\*(C'\fR, \f(CW\*(C`compl\*(C'\fR, \f(CW\*(C`not\*(C'\fR, \f(CW\*(C`or\*(C'\fR and \f(CW\*(C`xor\*(C'\fR as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1317 |
synonyms as keywords. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1318 |
.Ip "\fB\-fno-optional-diags\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1319 |
.IX Item "-fno-optional-diags" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1320 |
Disable diagnostics that the standard says a compiler does not need to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1321 |
issue. Currently, the only such diagnostic issued by G++ is the one for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1322 |
a name having multiple meanings within a class. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1323 |
.Ip "\fB\-fpermissive\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1324 |
.IX Item "-fpermissive" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1325 |
Downgrade some diagnostics about nonconformant code from errors to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1326 |
warnings. Thus, using \fB\-fpermissive\fR will allow some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1327 |
nonconforming code to compile. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1328 |
.Ip "\fB\-frepo\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1329 |
.IX Item "-frepo" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1330 |
Enable automatic template instantiation at link time. This option also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1331 |
implies \fB\-fno-implicit-templates\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1332 |
.Ip "\fB\-fno-rtti\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1333 |
.IX Item "-fno-rtti" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1334 |
Disable generation of information about every class with virtual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1335 |
functions for use by the \*(C+ runtime type identification features |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1336 |
(\fBdynamic_cast\fR and \fBtypeid\fR). If you don't use those parts |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1337 |
of the language, you can save some space by using this flag. Note that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1338 |
exception handling uses the same information, but it will generate it as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1339 |
needed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1340 |
.Ip "\fB\-fstats\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1341 |
.IX Item "-fstats" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1342 |
Emit statistics about front-end processing at the end of the compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1343 |
This information is generally only useful to the G++ development team. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1344 |
.Ip "\fB\-ftemplate-depth-\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1345 |
.IX Item "-ftemplate-depth-n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1346 |
Set the maximum instantiation depth for template classes to \fIn\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1347 |
A limit on the template instantiation depth is needed to detect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1348 |
endless recursions during template class instantiation. \s-1ANSI/ISO\s0 \*(C+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1349 |
conforming programs must not rely on a maximum depth greater than 17. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1350 |
.Ip "\fB\-fuse-cxa-atexit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1351 |
.IX Item "-fuse-cxa-atexit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1352 |
Register destructors for objects with static storage duration with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1353 |
\&\f(CW\*(C`_\|_cxa_atexit\*(C'\fR function rather than the \f(CW\*(C`atexit\*(C'\fR function. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1354 |
This option is required for fully standards-compliant handling of static |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1355 |
destructors, but will only work if your C library supports |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1356 |
\&\f(CW\*(C`_\|_cxa_atexit\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1357 |
.Ip "\fB\-fno-weak\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1358 |
.IX Item "-fno-weak" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1359 |
Do not use weak symbol support, even if it is provided by the linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1360 |
By default, G++ will use weak symbols if they are available. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1361 |
option exists only for testing, and should not be used by end-users; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1362 |
it will result in inferior code and has no benefits. This option may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1363 |
be removed in a future release of G++. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1364 |
.Ip "\fB\-nostdinc++\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1365 |
.IX Item "-nostdinc++" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1366 |
Do not search for header files in the standard directories specific to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1367 |
\&\*(C+, but do still search the other standard directories. (This option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1368 |
is used when building the \*(C+ library.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1369 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1370 |
In addition, these optimization, warning, and code generation options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1371 |
have meanings only for \*(C+ programs: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1372 |
.Ip "\fB\-fno-default-inline\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1373 |
.IX Item "-fno-default-inline" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1374 |
Do not assume \fBinline\fR for functions defined inside a class scope. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1375 |
Note that these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1376 |
functions will have linkage like inline functions; they just won't be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1377 |
inlined by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1378 |
.Ip "\fB\-Wabi\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1379 |
.IX Item "-Wabi ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1380 |
Warn when G++ generates code that is probably not compatible with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1381 |
vendor-neutral \*(C+ \s-1ABI\s0. Although an effort has been made to warn about |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1382 |
all such cases, there are probably some cases that are not warned about, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1383 |
even though G++ is generating incompatible code. There may also be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1384 |
cases where warnings are emitted even though the code that is generated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1385 |
will be compatible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1386 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1387 |
You should rewrite your code to avoid these warnings if you are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1388 |
concerned about the fact that code generated by G++ may not be binary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1389 |
compatible with code generated by other compilers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1390 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1391 |
The known incompatibilities at this point include: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1392 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1393 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1394 |
Incorrect handling of tail-padding for bit-fields. G++ may attempt to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1395 |
pack data into the same byte as a base class. For example: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1396 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1397 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1398 |
\& struct A { virtual void f(); int f1 : 1; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1399 |
\& struct B : public A { int f2 : 1; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1400 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1401 |
In this case, G++ will place \f(CW\*(C`B::f2\*(C'\fR into the same byte |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1402 |
as\f(CW\*(C`A::f1\*(C'\fR; other compilers will not. You can avoid this problem |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1403 |
by explicitly padding \f(CW\*(C`A\*(C'\fR so that its size is a multiple of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1404 |
byte size on your platform; that will cause G++ and other compilers to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1405 |
layout \f(CW\*(C`B\*(C'\fR identically. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1406 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1407 |
Incorrect handling of tail-padding for virtual bases. G++ does not use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1408 |
tail padding when laying out virtual bases. For example: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1409 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1410 |
.Vb 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1411 |
\& struct A { virtual void f(); char c1; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1412 |
\& struct B { B(); char c2; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1413 |
\& struct C : public A, public virtual B {}; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1414 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1415 |
In this case, G++ will not place \f(CW\*(C`B\*(C'\fR into the tail-padding for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1416 |
\&\f(CW\*(C`A\*(C'\fR; other compilers will. You can avoid this problem by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1417 |
explicitly padding \f(CW\*(C`A\*(C'\fR so that its size is a multiple of its |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1418 |
alignment (ignoring virtual base classes); that will cause G++ and other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1419 |
compilers to layout \f(CW\*(C`C\*(C'\fR identically. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1420 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1421 |
Incorrect handling of bit-fields with declared widths greater than that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1422 |
of their underlying types, when the bit-fields appear in a union. For |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1423 |
example: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1424 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1425 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1426 |
\& union U { int i : 4096; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1427 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1428 |
Assuming that an \f(CW\*(C`int\*(C'\fR does not have 4096 bits, G++ will make the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1429 |
union too small by the number of bits in an \f(CW\*(C`int\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1430 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1431 |
Empty classes can be placed at incorrect offsets. For example: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1432 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1433 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1434 |
\& struct A {}; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1435 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1436 |
.Vb 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1437 |
\& struct B { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1438 |
\& A a; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1439 |
\& virtual void f (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1440 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1441 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1442 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1443 |
\& struct C : public B, public A {}; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1444 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1445 |
G++ will place the \f(CW\*(C`A\*(C'\fR base class of \f(CW\*(C`C\*(C'\fR at a nonzero offset; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1446 |
it should be placed at offset zero. G++ mistakenly believes that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1447 |
\&\f(CW\*(C`A\*(C'\fR data member of \f(CW\*(C`B\*(C'\fR is already at offset zero. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1448 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1449 |
Names of template functions whose types involve \f(CW\*(C`typename\*(C'\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1450 |
template template parameters can be mangled incorrectly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1451 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1452 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1453 |
\& template <typename Q> |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1454 |
\& void f(typename Q::X) {} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1455 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1456 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1457 |
\& template <template <typename> class Q> |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1458 |
\& void f(typename Q<int>::X) {} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1459 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1460 |
Instantiations of these templates may be mangled incorrectly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1461 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1462 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1463 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1464 |
.Ip "\fB\-Wctor-dtor-privacy\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1465 |
.IX Item "-Wctor-dtor-privacy ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1466 |
Warn when a class seems unusable because all the constructors or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1467 |
destructors in that class are private, and it has neither friends nor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1468 |
public static member functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1469 |
.Ip "\fB\-Wnon-virtual-dtor\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1470 |
.IX Item "-Wnon-virtual-dtor ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1471 |
Warn when a class appears to be polymorphic, thereby requiring a virtual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1472 |
destructor, yet it declares a non-virtual one. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1473 |
This warning is enabled by \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1474 |
.Ip "\fB\-Wreorder\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1475 |
.IX Item "-Wreorder ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1476 |
Warn when the order of member initializers given in the code does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1477 |
match the order in which they must be executed. For instance: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1478 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1479 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1480 |
\& struct A { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1481 |
\& int i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1482 |
\& int j; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1483 |
\& A(): j (0), i (1) { } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1484 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1485 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1486 |
The compiler will rearrange the member initializers for \fBi\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1487 |
and \fBj\fR to match the declaration order of the members, emitting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1488 |
a warning to that effect. This warning is enabled by \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1489 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1490 |
The following \fB\-W...\fR options are not affected by \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1491 |
.Ip "\fB\-Weffc++\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1492 |
.IX Item "-Weffc++ ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1493 |
Warn about violations of the following style guidelines from Scott Meyers' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1494 |
\&\fIEffective \*(C+\fR book: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1495 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1496 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1497 |
Item 11: Define a copy constructor and an assignment operator for classes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1498 |
with dynamically allocated memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1499 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1500 |
Item 12: Prefer initialization to assignment in constructors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1501 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1502 |
Item 14: Make destructors virtual in base classes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1503 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1504 |
Item 15: Have \f(CW\*(C`operator=\*(C'\fR return a reference to \f(CW\*(C`*this\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1505 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1506 |
Item 23: Don't try to return a reference when you must return an object. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1507 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1508 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1509 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1510 |
Also warn about violations of the following style guidelines from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1511 |
Scott Meyers' \fIMore Effective \*(C+\fR book: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1512 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1513 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1514 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1515 |
Item 6: Distinguish between prefix and postfix forms of increment and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1516 |
decrement operators. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1517 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1518 |
Item 7: Never overload \f(CW\*(C`&&\*(C'\fR, \f(CW\*(C`||\*(C'\fR, or \f(CW\*(C`,\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1519 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1520 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1521 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1522 |
When selecting this option, be aware that the standard library |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1523 |
headers do not obey all of these guidelines; use \fBgrep \-v\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1524 |
to filter out those warnings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1525 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1526 |
.Ip "\fB\-Wno-deprecated\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1527 |
.IX Item "-Wno-deprecated ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1528 |
Do not warn about usage of deprecated features. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1529 |
.Ip "\fB\-Wno-non-template-friend\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1530 |
.IX Item "-Wno-non-template-friend ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1531 |
Disable warnings when non-templatized friend functions are declared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1532 |
within a template. Since the advent of explicit template specification |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1533 |
support in G++, if the name of the friend is an unqualified-id (i.e., |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1534 |
\&\fBfriend foo(int)\fR), the \*(C+ language specification demands that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1535 |
friend declare or define an ordinary, nontemplate function. (Section |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1536 |
14.5.3). Before G++ implemented explicit specification, unqualified-ids |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1537 |
could be interpreted as a particular specialization of a templatized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1538 |
function. Because this non-conforming behavior is no longer the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1539 |
behavior for G++, \fB\-Wnon-template-friend\fR allows the compiler to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1540 |
check existing code for potential trouble spots and is on by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1541 |
This new compiler behavior can be turned off with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1542 |
\&\fB\-Wno-non-template-friend\fR which keeps the conformant compiler code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1543 |
but disables the helpful warning. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1544 |
.Ip "\fB\-Wold-style-cast\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1545 |
.IX Item "-Wold-style-cast ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1546 |
Warn if an old-style (C-style) cast to a non-void type is used within |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1547 |
a \*(C+ program. The new-style casts (\fBstatic_cast\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1548 |
\&\fBreinterpret_cast\fR, and \fBconst_cast\fR) are less vulnerable to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1549 |
unintended effects and much easier to search for. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1550 |
.Ip "\fB\-Woverloaded-virtual\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1551 |
.IX Item "-Woverloaded-virtual ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1552 |
Warn when a function declaration hides virtual functions from a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1553 |
base class. For example, in: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1554 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1555 |
.Vb 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1556 |
\& struct A { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1557 |
\& virtual void f(); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1558 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1559 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1560 |
.Vb 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1561 |
\& struct B: public A { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1562 |
\& void f(int); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1563 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1564 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1565 |
the \f(CW\*(C`A\*(C'\fR class version of \f(CW\*(C`f\*(C'\fR is hidden in \f(CW\*(C`B\*(C'\fR, and code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1566 |
like: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1567 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1568 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1569 |
\& B* b; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1570 |
\& b->f(); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1571 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1572 |
will fail to compile. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1573 |
.Ip "\fB\-Wno-pmf-conversions\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1574 |
.IX Item "-Wno-pmf-conversions ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1575 |
Disable the diagnostic for converting a bound pointer to member function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1576 |
to a plain pointer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1577 |
.Ip "\fB\-Wsign-promo\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1578 |
.IX Item "-Wsign-promo ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1579 |
Warn when overload resolution chooses a promotion from unsigned or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1580 |
enumerated type to a signed type, over a conversion to an unsigned type of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1581 |
the same size. Previous versions of G++ would try to preserve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1582 |
unsignedness, but the standard mandates the current behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1583 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1584 |
.Vb 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1585 |
\& struct A { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1586 |
\& operator int (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1587 |
\& A& operator = (int); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1588 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1589 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1590 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1591 |
\& main () |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1592 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1593 |
\& A a,b; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1594 |
\& a = b; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1595 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1596 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1597 |
In this example, G++ will synthesize a default \fBA& operator = |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1598 |
(const A&);\fR, while cfront will use the user-defined \fBoperator =\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1599 |
.Sh "Options Controlling Objective-C Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1600 |
.IX Subsection "Options Controlling Objective-C Dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1601 |
(\s-1NOTE:\s0 This manual does not describe the Objective-C language itself. See |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1602 |
<\fBhttp://gcc.gnu.org/readings.html\fR> for references.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1603 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1604 |
This section describes the command-line options that are only meaningful |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1605 |
for Objective-C programs, but you can also use most of the \s-1GNU\s0 compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1606 |
options regardless of what language your program is in. For example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1607 |
you might compile a file \f(CW\*(C`some_class.m\*(C'\fR like this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1608 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1609 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1610 |
\& gcc -g -fgnu-runtime -O -c some_class.m |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1611 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1612 |
In this example, \fB\-fgnu-runtime\fR is an option meant only for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1613 |
Objective-C programs; you can use the other options with any language |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1614 |
supported by \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1615 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1616 |
Here is a list of options that are \fIonly\fR for compiling Objective-C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1617 |
programs: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1618 |
.Ip "\fB\-fconstant-string-class=\fR\fIclass-name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1619 |
.IX Item "-fconstant-string-class=class-name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1620 |
Use \fIclass-name\fR as the name of the class to instantiate for each |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1621 |
literal string specified with the syntax \f(CW\*(C`@"..."\*(C'\fR. The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1622 |
class name is \f(CW\*(C`NXConstantString\*(C'\fR if the \s-1GNU\s0 runtime is being used, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1623 |
\&\f(CW\*(C`NSConstantString\*(C'\fR if the NeXT runtime is being used (see below). The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1624 |
\&\fB\-fconstant-cfstrings\fR option, if also present, will override the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1625 |
\&\fB\-fconstant-string-class\fR setting and cause \f(CW\*(C`@"..."\*(C'\fR literals |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1626 |
to be laid out as constant CoreFoundation strings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1627 |
.Ip "\fB\-fgnu-runtime\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1628 |
.IX Item "-fgnu-runtime" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1629 |
Generate object code compatible with the standard \s-1GNU\s0 Objective-C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1630 |
runtime. This is the default for most types of systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1631 |
.Ip "\fB\-fnext-runtime\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1632 |
.IX Item "-fnext-runtime" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1633 |
Generate output compatible with the NeXT runtime. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1634 |
for NeXT-based systems, including Darwin and Mac \s-1OS\s0 X. The macro |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1635 |
\&\f(CW\*(C`_\|_NEXT_RUNTIME_\|_\*(C'\fR is predefined if (and only if) this option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1636 |
used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1637 |
.Ip "\fB\-fno-nil-receivers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1638 |
.IX Item "-fno-nil-receivers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1639 |
Assume that all Objective-C message dispatches (e.g., |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1640 |
\&\f(CW\*(C`[receiver message:arg]\*(C'\fR) in this translation unit ensure that the receiver |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1641 |
is not \f(CW\*(C`nil\*(C'\fR. This allows for more efficient entry points in the runtime to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1642 |
used. Currently, this option is only available in conjunction with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1643 |
the NeXT runtime on Mac \s-1OS\s0 X 10.3 and later. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1644 |
.Ip "\fB\-fobjc-exceptions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1645 |
.IX Item "-fobjc-exceptions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1646 |
Enable syntactic support for structured exception handling in Objective-C, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1647 |
similar to what is offered by \*(C+ and Java. Currently, this option is only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1648 |
available in conjunction with the NeXT runtime on Mac \s-1OS\s0 X 10.3 and later. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1649 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1650 |
.Vb 23 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1651 |
\& @try { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1652 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1653 |
\& @throw expr; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1654 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1655 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1656 |
\& @catch (AnObjCClass *exc) { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1657 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1658 |
\& @throw expr; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1659 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1660 |
\& @throw; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1661 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1662 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1663 |
\& @catch (AnotherClass *exc) { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1664 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1665 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1666 |
\& @catch (id allOthers) { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1667 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1668 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1669 |
\& @finally { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1670 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1671 |
\& @throw expr; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1672 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1673 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1674 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1675 |
The \f(CW\*(C`@throw\*(C'\fR statement may appear anywhere in an Objective-C or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1676 |
Objective-\*(C+ program; when used inside of a \f(CW\*(C`@catch\*(C'\fR block, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1677 |
\&\f(CW\*(C`@throw\*(C'\fR may appear without an argument (as shown above), in which case |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1678 |
the object caught by the \f(CW\*(C`@catch\*(C'\fR will be rethrown. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1679 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1680 |
Note that only (pointers to) Objective-C objects may be thrown and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1681 |
caught using this scheme. When an object is thrown, it will be caught |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1682 |
by the nearest \f(CW\*(C`@catch\*(C'\fR clause capable of handling objects of that type, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1683 |
analogously to how \f(CW\*(C`catch\*(C'\fR blocks work in \*(C+ and Java. A |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1684 |
\&\f(CW\*(C`@catch(id ...)\*(C'\fR clause (as shown above) may also be provided to catch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1685 |
any and all Objective-C exceptions not caught by previous \f(CW\*(C`@catch\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1686 |
clauses (if any). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1687 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1688 |
The \f(CW\*(C`@finally\*(C'\fR clause, if present, will be executed upon exit from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1689 |
immediately preceding \f(CW\*(C`@try ... @catch\*(C'\fR section. This will happen |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1690 |
regardless of whether any exceptions are thrown, caught or rethrown |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1691 |
inside the \f(CW\*(C`@try ... @catch\*(C'\fR section, analogously to the behavior |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1692 |
of the \f(CW\*(C`finally\*(C'\fR clause in Java. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1693 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1694 |
There are several caveats to using the new exception mechanism: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1695 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1696 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1697 |
Although currently designed to be binary compatible with \f(CW\*(C`NS_HANDLER\*(C'\fR\-style |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1698 |
idioms provided by the \f(CW\*(C`NSException\*(C'\fR class, the new |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1699 |
exceptions can only be used on Mac \s-1OS\s0 X 10.3 (Panther) and later |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1700 |
systems, due to additional functionality needed in the (NeXT) Objective-C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1701 |
runtime. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1702 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1703 |
As mentioned above, the new exceptions do not support handling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1704 |
types other than Objective-C objects. Furthermore, when used from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1705 |
Objective-\*(C+, the Objective-C exception model does not interoperate with \*(C+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1706 |
exceptions at this time. This means you cannot \f(CW\*(C`@throw\*(C'\fR an exception |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1707 |
from Objective-C and \f(CW\*(C`catch\*(C'\fR it in \*(C+, or vice versa |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1708 |
(i.e., \f(CW\*(C`throw ... @catch\*(C'\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1709 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1710 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1711 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1712 |
The \fB\-fobjc-exceptions\fR switch also enables the use of synchronization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1713 |
blocks for thread-safe execution: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1714 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1715 |
.Vb 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1716 |
\& @synchronized (ObjCClass *guard) { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1717 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1718 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1719 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1720 |
Upon entering the \f(CW\*(C`@synchronized\*(C'\fR block, a thread of execution shall |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1721 |
first check whether a lock has been placed on the corresponding \f(CW\*(C`guard\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1722 |
object by another thread. If it has, the current thread shall wait until |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1723 |
the other thread relinquishes its lock. Once \f(CW\*(C`guard\*(C'\fR becomes available, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1724 |
the current thread will place its own lock on it, execute the code contained in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1725 |
the \f(CW\*(C`@synchronized\*(C'\fR block, and finally relinquish the lock (thereby |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1726 |
making \f(CW\*(C`guard\*(C'\fR available to other threads). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1727 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1728 |
Unlike Java, Objective-C does not allow for entire methods to be marked |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1729 |
\&\f(CW\*(C`@synchronized\*(C'\fR. Note that throwing exceptions out of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1730 |
\&\f(CW\*(C`@synchronized\*(C'\fR blocks is allowed, and will cause the guarding object |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1731 |
to be unlocked properly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1732 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1733 |
.Ip "\fB\-freplace-objc-classes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1734 |
.IX Item "-freplace-objc-classes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1735 |
Emit a special marker instructing \fB\f(BIld\fB\|(1)\fR not to statically link in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1736 |
the resulting object file, and allow \fB\f(BIdyld\fB\|(1)\fR to load it in at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1737 |
run time instead. This is used in conjunction with the Fix-and-Continue |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1738 |
debugging mode, where the object file in question may be recompiled and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1739 |
dynamically reloaded in the course of program execution, without the need |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1740 |
to restart the program itself. Currently, Fix-and-Continue functionality |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1741 |
is only available in conjunction with the NeXT runtime on Mac \s-1OS\s0 X 10.3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1742 |
and later. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1743 |
.Ip "\fB\-fzero-link\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1744 |
.IX Item "-fzero-link" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1745 |
When compiling for the NeXT runtime, the compiler ordinarily replaces calls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1746 |
to \f(CW\*(C`objc_getClass("...")\*(C'\fR (when the name of the class is known at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1747 |
compile time) with static class references that get initialized at load time, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1748 |
which improves run-time performance. Specifying the \fB\-fzero-link\fR flag |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1749 |
suppresses this behavior and causes calls to \f(CW\*(C`objc_getClass("...")\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1750 |
to be retained. This is useful in Zero-Link debugging mode, since it allows |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1751 |
for individual class implementations to be modified during program execution. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1752 |
.Ip "\fB\-gen-decls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1753 |
.IX Item "-gen-decls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1754 |
Dump interface declarations for all classes seen in the source file to a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1755 |
file named \fI\fIsourcename\fI.decl\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1756 |
.Ip "\fB\-Wno-protocol\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1757 |
.IX Item "-Wno-protocol" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1758 |
If a class is declared to implement a protocol, a warning is issued for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1759 |
every method in the protocol that is not implemented by the class. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1760 |
default behavior is to issue a warning for every method not explicitly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1761 |
implemented in the class, even if a method implementation is inherited |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1762 |
from the superclass. If you use the \f(CW\*(C`\-Wno\-protocol\*(C'\fR option, then |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1763 |
methods inherited from the superclass are considered to be implemented, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1764 |
and no warning is issued for them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1765 |
.Ip "\fB\-Wselector\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1766 |
.IX Item "-Wselector" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1767 |
Warn if multiple methods of different types for the same selector are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1768 |
found during compilation. The check is performed on the list of methods |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1769 |
in the final stage of compilation. Additionally, a check is performed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1770 |
for each selector appearing in a \f(CW\*(C`@selector(...)\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1771 |
expression, and a corresponding method for that selector has been found |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1772 |
during compilation. Because these checks scan the method table only at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1773 |
the end of compilation, these warnings are not produced if the final |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1774 |
stage of compilation is not reached, for example because an error is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1775 |
found during compilation, or because the \f(CW\*(C`\-fsyntax\-only\*(C'\fR option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1776 |
being used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1777 |
.Ip "\fB\-Wundeclared-selector\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1778 |
.IX Item "-Wundeclared-selector" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1779 |
Warn if a \f(CW\*(C`@selector(...)\*(C'\fR expression referring to an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1780 |
undeclared selector is found. A selector is considered undeclared if no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1781 |
method with that name has been declared before the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1782 |
\&\f(CW\*(C`@selector(...)\*(C'\fR expression, either explicitly in an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1783 |
\&\f(CW\*(C`@interface\*(C'\fR or \f(CW\*(C`@protocol\*(C'\fR declaration, or implicitly in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1784 |
an \f(CW\*(C`@implementation\*(C'\fR section. This option always performs its |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1785 |
checks as soon as a \f(CW\*(C`@selector(...)\*(C'\fR expression is found, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1786 |
while \f(CW\*(C`\-Wselector\*(C'\fR only performs its checks in the final stage of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1787 |
compilation. This also enforces the coding style convention |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1788 |
that methods and selectors must be declared before being used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1789 |
.Ip "\fB\-print-objc-runtime-info\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1790 |
.IX Item "-print-objc-runtime-info" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1791 |
Generate C header describing the largest structure that is passed by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1792 |
value, if any. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1793 |
.Sh "Options to Control Diagnostic Messages Formatting" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1794 |
.IX Subsection "Options to Control Diagnostic Messages Formatting" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1795 |
Traditionally, diagnostic messages have been formatted irrespective of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1796 |
the output device's aspect (e.g. its width, ...). The options described |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1797 |
below can be used to control the diagnostic messages formatting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1798 |
algorithm, e.g. how many characters per line, how often source location |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1799 |
information should be reported. Right now, only the \*(C+ front end can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1800 |
honor these options. However it is expected, in the near future, that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1801 |
the remaining front ends would be able to digest them correctly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1802 |
.Ip "\fB\-fmessage-length=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1803 |
.IX Item "-fmessage-length=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1804 |
Try to format error messages so that they fit on lines of about \fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1805 |
characters. The default is 72 characters for \fBg++\fR and 0 for the rest of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1806 |
the front ends supported by \s-1GCC\s0. If \fIn\fR is zero, then no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1807 |
line-wrapping will be done; each error message will appear on a single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1808 |
line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1809 |
.Ip "\fB\-fdiagnostics-show-location=once\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1810 |
.IX Item "-fdiagnostics-show-location=once" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1811 |
Only meaningful in line-wrapping mode. Instructs the diagnostic messages |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1812 |
reporter to emit \fIonce\fR source location information; that is, in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1813 |
case the message is too long to fit on a single physical line and has to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1814 |
be wrapped, the source location won't be emitted (as prefix) again, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1815 |
over and over, in subsequent continuation lines. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1816 |
behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1817 |
.Ip "\fB\-fdiagnostics-show-location=every-line\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1818 |
.IX Item "-fdiagnostics-show-location=every-line" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1819 |
Only meaningful in line-wrapping mode. Instructs the diagnostic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1820 |
messages reporter to emit the same source location information (as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1821 |
prefix) for physical lines that result from the process of breaking |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1822 |
a message which is too long to fit on a single line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1823 |
.Sh "Options to Request or Suppress Warnings" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1824 |
.IX Subsection "Options to Request or Suppress Warnings" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1825 |
Warnings are diagnostic messages that report constructions which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1826 |
are not inherently erroneous but which are risky or suggest there |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1827 |
may have been an error. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1828 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1829 |
You can request many specific warnings with options beginning \fB\-W\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1830 |
for example \fB\-Wimplicit\fR to request warnings on implicit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1831 |
declarations. Each of these specific warning options also has a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1832 |
negative form beginning \fB\-Wno-\fR to turn off warnings; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1833 |
for example, \fB\-Wno-implicit\fR. This manual lists only one of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1834 |
two forms, whichever is not the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1835 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1836 |
The following options control the amount and kinds of warnings produced |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1837 |
by \s-1GCC\s0; for further, language-specific options also refer to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1838 |
\&\fB\*(C+ Dialect Options\fR and \fBObjective-C Dialect Options\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1839 |
.Ip "\fB\-fsyntax-only\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1840 |
.IX Item "-fsyntax-only" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1841 |
Check the code for syntax errors, but don't do anything beyond that. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1842 |
.Ip "\fB\-pedantic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1843 |
.IX Item "-pedantic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1844 |
Issue all the warnings demanded by strict \s-1ISO\s0 C and \s-1ISO\s0 \*(C+; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1845 |
reject all programs that use forbidden extensions, and some other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1846 |
programs that do not follow \s-1ISO\s0 C and \s-1ISO\s0 \*(C+. For \s-1ISO\s0 C, follows the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1847 |
version of the \s-1ISO\s0 C standard specified by any \fB\-std\fR option used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1848 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1849 |
Valid \s-1ISO\s0 C and \s-1ISO\s0 \*(C+ programs should compile properly with or without |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1850 |
this option (though a rare few will require \fB\-ansi\fR or a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1851 |
\&\fB\-std\fR option specifying the required version of \s-1ISO\s0 C). However, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1852 |
without this option, certain \s-1GNU\s0 extensions and traditional C and \*(C+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1853 |
features are supported as well. With this option, they are rejected. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1854 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1855 |
\&\fB\-pedantic\fR does not cause warning messages for use of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1856 |
alternate keywords whose names begin and end with \fB_\|_\fR. Pedantic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1857 |
warnings are also disabled in the expression that follows |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1858 |
\&\f(CW\*(C`_\|_extension_\|_\*(C'\fR. However, only system header files should use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1859 |
these escape routes; application programs should avoid them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1860 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1861 |
Some users try to use \fB\-pedantic\fR to check programs for strict \s-1ISO\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1862 |
C conformance. They soon find that it does not do quite what they want: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1863 |
it finds some non-ISO practices, but not all\-\-\-only those for which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1864 |
\&\s-1ISO\s0 C \fIrequires\fR a diagnostic, and some others for which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1865 |
diagnostics have been added. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1866 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1867 |
A feature to report any failure to conform to \s-1ISO\s0 C might be useful in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1868 |
some instances, but would require considerable additional work and would |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1869 |
be quite different from \fB\-pedantic\fR. We don't have plans to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1870 |
support such a feature in the near future. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1871 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1872 |
Where the standard specified with \fB\-std\fR represents a \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1873 |
extended dialect of C, such as \fBgnu89\fR or \fBgnu99\fR, there is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1874 |
corresponding \fIbase standard\fR, the version of \s-1ISO\s0 C on which the \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1875 |
extended dialect is based. Warnings from \fB\-pedantic\fR are given |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1876 |
where they are required by the base standard. (It would not make sense |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1877 |
for such warnings to be given only for features not in the specified \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1878 |
C dialect, since by definition the \s-1GNU\s0 dialects of C include all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1879 |
features the compiler supports with the given option, and there would be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1880 |
nothing to warn about.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1881 |
.Ip "\fB\-pedantic-errors\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1882 |
.IX Item "-pedantic-errors" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1883 |
Like \fB\-pedantic\fR, except that errors are produced rather than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1884 |
warnings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1885 |
.Ip "\fB\-w\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1886 |
.IX Item "-w" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1887 |
Inhibit all warning messages. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1888 |
.Ip "\fB\-Wno-import\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1889 |
.IX Item "-Wno-import" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1890 |
Inhibit warning messages about the use of \fB#import\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1891 |
.Ip "\fB\-Wchar-subscripts\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1892 |
.IX Item "-Wchar-subscripts" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1893 |
Warn if an array subscript has type \f(CW\*(C`char\*(C'\fR. This is a common cause |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1894 |
of error, as programmers often forget that this type is signed on some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1895 |
machines. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1896 |
.Ip "\fB\-Wcomment\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1897 |
.IX Item "-Wcomment" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1898 |
Warn whenever a comment-start sequence \fB/*\fR appears in a \fB/*\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1899 |
comment, or whenever a Backslash-Newline appears in a \fB//\fR comment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1900 |
.Ip "\fB\-Wformat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1901 |
.IX Item "-Wformat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1902 |
Check calls to \f(CW\*(C`printf\*(C'\fR and \f(CW\*(C`scanf\*(C'\fR, etc., to make sure that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1903 |
the arguments supplied have types appropriate to the format string |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1904 |
specified, and that the conversions specified in the format string make |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1905 |
sense. This includes standard functions, and others specified by format |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1906 |
attributes, in the \f(CW\*(C`printf\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1907 |
\&\f(CW\*(C`scanf\*(C'\fR, \f(CW\*(C`strftime\*(C'\fR and \f(CW\*(C`strfmon\*(C'\fR (an X/Open extension, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1908 |
not in the C standard) families. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1909 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1910 |
The formats are checked against the format features supported by \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1911 |
libc version 2.2. These include all \s-1ISO\s0 C90 and C99 features, as well |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1912 |
as features from the Single Unix Specification and some \s-1BSD\s0 and \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1913 |
extensions. Other library implementations may not support all these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1914 |
features; \s-1GCC\s0 does not support warning about features that go beyond a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1915 |
particular library's limitations. However, if \fB\-pedantic\fR is used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1916 |
with \fB\-Wformat\fR, warnings will be given about format features not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1917 |
in the selected standard version (but not for \f(CW\*(C`strfmon\*(C'\fR formats, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1918 |
since those are not in any version of the C standard). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1919 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1920 |
Since \fB\-Wformat\fR also checks for null format arguments for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1921 |
several functions, \fB\-Wformat\fR also implies \fB\-Wnonnull\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1922 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1923 |
\&\fB\-Wformat\fR is included in \fB\-Wall\fR. For more control over some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1924 |
aspects of format checking, the options \fB\-Wformat-y2k\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1925 |
\&\fB\-Wno-format-extra-args\fR, \fB\-Wno-format-zero-length\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1926 |
\&\fB\-Wformat-nonliteral\fR, \fB\-Wformat-security\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1927 |
\&\fB\-Wformat=2\fR are available, but are not included in \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1928 |
.Ip "\fB\-Wformat-y2k\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1929 |
.IX Item "-Wformat-y2k" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1930 |
If \fB\-Wformat\fR is specified, also warn about \f(CW\*(C`strftime\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1931 |
formats which may yield only a two-digit year. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1932 |
.Ip "\fB\-Wno-format-extra-args\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1933 |
.IX Item "-Wno-format-extra-args" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1934 |
If \fB\-Wformat\fR is specified, do not warn about excess arguments to a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1935 |
\&\f(CW\*(C`printf\*(C'\fR or \f(CW\*(C`scanf\*(C'\fR format function. The C standard specifies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1936 |
that such arguments are ignored. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1937 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1938 |
Where the unused arguments lie between used arguments that are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1939 |
specified with \fB$\fR operand number specifications, normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1940 |
warnings are still given, since the implementation could not know what |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1941 |
type to pass to \f(CW\*(C`va_arg\*(C'\fR to skip the unused arguments. However, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1942 |
in the case of \f(CW\*(C`scanf\*(C'\fR formats, this option will suppress the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1943 |
warning if the unused arguments are all pointers, since the Single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1944 |
Unix Specification says that such unused arguments are allowed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1945 |
.Ip "\fB\-Wno-format-zero-length\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1946 |
.IX Item "-Wno-format-zero-length" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1947 |
If \fB\-Wformat\fR is specified, do not warn about zero-length formats. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1948 |
The C standard specifies that zero-length formats are allowed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1949 |
.Ip "\fB\-Wformat-nonliteral\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1950 |
.IX Item "-Wformat-nonliteral" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1951 |
If \fB\-Wformat\fR is specified, also warn if the format string is not a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1952 |
string literal and so cannot be checked, unless the format function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1953 |
takes its format arguments as a \f(CW\*(C`va_list\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1954 |
.Ip "\fB\-Wformat-security\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1955 |
.IX Item "-Wformat-security" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1956 |
If \fB\-Wformat\fR is specified, also warn about uses of format |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1957 |
functions that represent possible security problems. At present, this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1958 |
warns about calls to \f(CW\*(C`printf\*(C'\fR and \f(CW\*(C`scanf\*(C'\fR functions where the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1959 |
format string is not a string literal and there are no format arguments, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1960 |
as in \f(CW\*(C`printf (foo);\*(C'\fR. This may be a security hole if the format |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1961 |
string came from untrusted input and contains \fB%n\fR. (This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1962 |
currently a subset of what \fB\-Wformat-nonliteral\fR warns about, but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1963 |
in future warnings may be added to \fB\-Wformat-security\fR that are not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1964 |
included in \fB\-Wformat-nonliteral\fR.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1965 |
.Ip "\fB\-Wformat=2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1966 |
.IX Item "-Wformat=2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1967 |
Enable \fB\-Wformat\fR plus format checks not included in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1968 |
\&\fB\-Wformat\fR. Currently equivalent to \fB\-Wformat |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1969 |
\&\-Wformat-nonliteral \-Wformat-security \-Wformat-y2k\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1970 |
.Ip "\fB\-Wnonnull\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1971 |
.IX Item "-Wnonnull" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1972 |
Warn about passing a null pointer for arguments marked as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1973 |
requiring a non-null value by the \f(CW\*(C`nonnull\*(C'\fR function attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1974 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1975 |
\&\fB\-Wnonnull\fR is included in \fB\-Wall\fR and \fB\-Wformat\fR. It |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1976 |
can be disabled with the \fB\-Wno-nonnull\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1977 |
.Ip "\fB\-Winit-self\fR (C, \*(C+, and Objective-C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1978 |
.IX Item "-Winit-self (C, , and Objective-C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1979 |
Warn about uninitialized variables which are initialized with themselves. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1980 |
Note this option can only be used with the \fB\-Wuninitialized\fR option, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1981 |
which in turn only works with \fB\-O1\fR and above. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1982 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1983 |
For example, \s-1GCC\s0 will warn about \f(CW\*(C`i\*(C'\fR being uninitialized in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1984 |
following snippet only when \fB\-Winit-self\fR has been specified: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1985 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1986 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1987 |
\& int f() |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1988 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1989 |
\& int i = i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1990 |
\& return i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1991 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1992 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1993 |
.Ip "\fB\-Wimplicit-int\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1994 |
.IX Item "-Wimplicit-int" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1995 |
Warn when a declaration does not specify a type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1996 |
.Ip "\fB\-Wimplicit-function-declaration\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1997 |
.IX Item "-Wimplicit-function-declaration" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1998 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
1999 |
.Ip "\fB\-Werror-implicit-function-declaration\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2000 |
.IX Item "-Werror-implicit-function-declaration" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2001 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2002 |
Give a warning (or error) whenever a function is used before being |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2003 |
declared. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2004 |
.Ip "\fB\-Wimplicit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2005 |
.IX Item "-Wimplicit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2006 |
Same as \fB\-Wimplicit-int\fR and \fB\-Wimplicit-function-declaration\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2007 |
.Ip "\fB\-Wmain\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2008 |
.IX Item "-Wmain" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2009 |
Warn if the type of \fBmain\fR is suspicious. \fBmain\fR should be a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2010 |
function with external linkage, returning int, taking either zero |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2011 |
arguments, two, or three arguments of appropriate types. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2012 |
.Ip "\fB\-Wmissing-braces\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2013 |
.IX Item "-Wmissing-braces" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2014 |
Warn if an aggregate or union initializer is not fully bracketed. In |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2015 |
the following example, the initializer for \fBa\fR is not fully |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2016 |
bracketed, but that for \fBb\fR is fully bracketed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2017 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2018 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2019 |
\& int a[2][2] = { 0, 1, 2, 3 }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2020 |
\& int b[2][2] = { { 0, 1 }, { 2, 3 } }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2021 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2022 |
.Ip "\fB\-Wparentheses\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2023 |
.IX Item "-Wparentheses" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2024 |
Warn if parentheses are omitted in certain contexts, such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2025 |
as when there is an assignment in a context where a truth value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2026 |
is expected, or when operators are nested whose precedence people |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2027 |
often get confused about. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2028 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2029 |
Also warn about constructions where there may be confusion to which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2030 |
\&\f(CW\*(C`if\*(C'\fR statement an \f(CW\*(C`else\*(C'\fR branch belongs. Here is an example of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2031 |
such a case: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2032 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2033 |
.Vb 7 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2034 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2035 |
\& if (a) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2036 |
\& if (b) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2037 |
\& foo (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2038 |
\& else |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2039 |
\& bar (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2040 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2041 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2042 |
In C, every \f(CW\*(C`else\*(C'\fR branch belongs to the innermost possible \f(CW\*(C`if\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2043 |
statement, which in this example is \f(CW\*(C`if (b)\*(C'\fR. This is often not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2044 |
what the programmer expected, as illustrated in the above example by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2045 |
indentation the programmer chose. When there is the potential for this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2046 |
confusion, \s-1GCC\s0 will issue a warning when this flag is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2047 |
To eliminate the warning, add explicit braces around the innermost |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2048 |
\&\f(CW\*(C`if\*(C'\fR statement so there is no way the \f(CW\*(C`else\*(C'\fR could belong to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2049 |
the enclosing \f(CW\*(C`if\*(C'\fR. The resulting code would look like this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2050 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2051 |
.Vb 9 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2052 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2053 |
\& if (a) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2054 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2055 |
\& if (b) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2056 |
\& foo (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2057 |
\& else |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2058 |
\& bar (); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2059 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2060 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2061 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2062 |
.Ip "\fB\-Wsequence-point\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2063 |
.IX Item "-Wsequence-point" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2064 |
Warn about code that may have undefined semantics because of violations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2065 |
of sequence point rules in the C standard. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2066 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2067 |
The C standard defines the order in which expressions in a C program are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2068 |
evaluated in terms of \fIsequence points\fR, which represent a partial |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2069 |
ordering between the execution of parts of the program: those executed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2070 |
before the sequence point, and those executed after it. These occur |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2071 |
after the evaluation of a full expression (one which is not part of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2072 |
larger expression), after the evaluation of the first operand of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2073 |
\&\f(CW\*(C`&&\*(C'\fR, \f(CW\*(C`||\*(C'\fR, \f(CW\*(C`? :\*(C'\fR or \f(CW\*(C`,\*(C'\fR (comma) operator, before a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2074 |
function is called (but after the evaluation of its arguments and the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2075 |
expression denoting the called function), and in certain other places. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2076 |
Other than as expressed by the sequence point rules, the order of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2077 |
evaluation of subexpressions of an expression is not specified. All |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2078 |
these rules describe only a partial order rather than a total order, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2079 |
since, for example, if two functions are called within one expression |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2080 |
with no sequence point between them, the order in which the functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2081 |
are called is not specified. However, the standards committee have |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2082 |
ruled that function calls do not overlap. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2083 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2084 |
It is not specified when between sequence points modifications to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2085 |
values of objects take effect. Programs whose behavior depends on this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2086 |
have undefined behavior; the C standard specifies that ``Between the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2087 |
previous and next sequence point an object shall have its stored value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2088 |
modified at most once by the evaluation of an expression. Furthermore, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2089 |
the prior value shall be read only to determine the value to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2090 |
stored.''. If a program breaks these rules, the results on any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2091 |
particular implementation are entirely unpredictable. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2092 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2093 |
Examples of code with undefined behavior are \f(CW\*(C`a = a++;\*(C'\fR, \f(CW\*(C`a[n] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2094 |
= b[n++]\*(C'\fR and \f(CW\*(C`a[i++] = i;\*(C'\fR. Some more complicated cases are not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2095 |
diagnosed by this option, and it may give an occasional false positive |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2096 |
result, but in general it has been found fairly effective at detecting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2097 |
this sort of problem in programs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2098 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2099 |
The present implementation of this option only works for C programs. A |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2100 |
future implementation may also work for \*(C+ programs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2101 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2102 |
The C standard is worded confusingly, therefore there is some debate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2103 |
over the precise meaning of the sequence point rules in subtle cases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2104 |
Links to discussions of the problem, including proposed formal |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2105 |
definitions, may be found on the \s-1GCC\s0 readings page, at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2106 |
<\fBhttp://gcc.gnu.org/readings.html\fR>. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2107 |
.Ip "\fB\-Wreturn-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2108 |
.IX Item "-Wreturn-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2109 |
Warn whenever a function is defined with a return-type that defaults to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2110 |
\&\f(CW\*(C`int\*(C'\fR. Also warn about any \f(CW\*(C`return\*(C'\fR statement with no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2111 |
return-value in a function whose return-type is not \f(CW\*(C`void\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2112 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2113 |
For \*(C+, a function without return type always produces a diagnostic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2114 |
message, even when \fB\-Wno-return-type\fR is specified. The only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2115 |
exceptions are \fBmain\fR and functions defined in system headers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2116 |
.Ip "\fB\-Wswitch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2117 |
.IX Item "-Wswitch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2118 |
Warn whenever a \f(CW\*(C`switch\*(C'\fR statement has an index of enumerated type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2119 |
and lacks a \f(CW\*(C`case\*(C'\fR for one or more of the named codes of that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2120 |
enumeration. (The presence of a \f(CW\*(C`default\*(C'\fR label prevents this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2121 |
warning.) \f(CW\*(C`case\*(C'\fR labels outside the enumeration range also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2122 |
provoke warnings when this option is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2123 |
.Ip "\fB\-Wswitch-default\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2124 |
.IX Item "-Wswitch-default" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2125 |
Warn whenever a \f(CW\*(C`switch\*(C'\fR statement does not have a \f(CW\*(C`default\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2126 |
case. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2127 |
.Ip "\fB\-Wswitch-enum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2128 |
.IX Item "-Wswitch-enum" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2129 |
Warn whenever a \f(CW\*(C`switch\*(C'\fR statement has an index of enumerated type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2130 |
and lacks a \f(CW\*(C`case\*(C'\fR for one or more of the named codes of that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2131 |
enumeration. \f(CW\*(C`case\*(C'\fR labels outside the enumeration range also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2132 |
provoke warnings when this option is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2133 |
.Ip "\fB\-Wtrigraphs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2134 |
.IX Item "-Wtrigraphs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2135 |
Warn if any trigraphs are encountered that might change the meaning of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2136 |
the program (trigraphs within comments are not warned about). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2137 |
.Ip "\fB\-Wunused-function\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2138 |
.IX Item "-Wunused-function" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2139 |
Warn whenever a static function is declared but not defined or a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2140 |
non\e-inline static function is unused. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2141 |
.Ip "\fB\-Wunused-label\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2142 |
.IX Item "-Wunused-label" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2143 |
Warn whenever a label is declared but not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2144 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2145 |
To suppress this warning use the \fBunused\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2146 |
.Ip "\fB\-Wunused-parameter\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2147 |
.IX Item "-Wunused-parameter" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2148 |
Warn whenever a function parameter is unused aside from its declaration. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2149 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2150 |
To suppress this warning use the \fBunused\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2151 |
.Ip "\fB\-Wunused-variable\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2152 |
.IX Item "-Wunused-variable" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2153 |
Warn whenever a local variable or non-constant static variable is unused |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2154 |
aside from its declaration |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2155 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2156 |
To suppress this warning use the \fBunused\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2157 |
.Ip "\fB\-Wunused-value\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2158 |
.IX Item "-Wunused-value" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2159 |
Warn whenever a statement computes a result that is explicitly not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2160 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2161 |
To suppress this warning cast the expression to \fBvoid\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2162 |
.Ip "\fB\-Wunused\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2163 |
.IX Item "-Wunused" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2164 |
All the above \fB\-Wunused\fR options combined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2165 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2166 |
In order to get a warning about an unused function parameter, you must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2167 |
either specify \fB\-Wextra \-Wunused\fR (note that \fB\-Wall\fR implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2168 |
\&\fB\-Wunused\fR), or separately specify \fB\-Wunused-parameter\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2169 |
.Ip "\fB\-Wuninitialized\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2170 |
.IX Item "-Wuninitialized" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2171 |
Warn if an automatic variable is used without first being initialized or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2172 |
if a variable may be clobbered by a \f(CW\*(C`setjmp\*(C'\fR call. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2173 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2174 |
These warnings are possible only in optimizing compilation, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2175 |
because they require data flow information that is computed only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2176 |
when optimizing. If you don't specify \fB\-O\fR, you simply won't |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2177 |
get these warnings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2178 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2179 |
If you want to warn about code which uses the uninitialized value of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2180 |
variable in its own initializer, use the \fB\-Winit-self\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2181 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2182 |
These warnings occur only for variables that are candidates for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2183 |
register allocation. Therefore, they do not occur for a variable that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2184 |
is declared \f(CW\*(C`volatile\*(C'\fR, or whose address is taken, or whose size |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2185 |
is other than 1, 2, 4 or 8 bytes. Also, they do not occur for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2186 |
structures, unions or arrays, even when they are in registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2187 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2188 |
Note that there may be no warning about a variable that is used only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2189 |
to compute a value that itself is never used, because such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2190 |
computations may be deleted by data flow analysis before the warnings |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2191 |
are printed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2192 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2193 |
These warnings are made optional because \s-1GCC\s0 is not smart |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2194 |
enough to see all the reasons why the code might be correct |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2195 |
despite appearing to have an error. Here is one example of how |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2196 |
this can happen: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2197 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2198 |
.Vb 12 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2199 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2200 |
\& int x; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2201 |
\& switch (y) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2202 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2203 |
\& case 1: x = 1; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2204 |
\& break; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2205 |
\& case 2: x = 4; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2206 |
\& break; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2207 |
\& case 3: x = 5; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2208 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2209 |
\& foo (x); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2210 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2211 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2212 |
If the value of \f(CW\*(C`y\*(C'\fR is always 1, 2 or 3, then \f(CW\*(C`x\*(C'\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2213 |
always initialized, but \s-1GCC\s0 doesn't know this. Here is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2214 |
another common case: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2215 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2216 |
.Vb 6 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2217 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2218 |
\& int save_y; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2219 |
\& if (change_y) save_y = y, y = new_y; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2220 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2221 |
\& if (change_y) y = save_y; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2222 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2223 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2224 |
This has no bug because \f(CW\*(C`save_y\*(C'\fR is used only if it is set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2225 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2226 |
This option also warns when a non-volatile automatic variable might be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2227 |
changed by a call to \f(CW\*(C`longjmp\*(C'\fR. These warnings as well are possible |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2228 |
only in optimizing compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2229 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2230 |
The compiler sees only the calls to \f(CW\*(C`setjmp\*(C'\fR. It cannot know |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2231 |
where \f(CW\*(C`longjmp\*(C'\fR will be called; in fact, a signal handler could |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2232 |
call it at any point in the code. As a result, you may get a warning |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2233 |
even when there is in fact no problem because \f(CW\*(C`longjmp\*(C'\fR cannot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2234 |
in fact be called at the place which would cause a problem. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2235 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2236 |
Some spurious warnings can be avoided if you declare all the functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2237 |
you use that never return as \f(CW\*(C`noreturn\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2238 |
.Ip "\fB\-Wunknown-pragmas\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2239 |
.IX Item "-Wunknown-pragmas" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2240 |
Warn when a #pragma directive is encountered which is not understood by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2241 |
\&\s-1GCC\s0. If this command line option is used, warnings will even be issued |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2242 |
for unknown pragmas in system header files. This is not the case if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2243 |
the warnings were only enabled by the \fB\-Wall\fR command line option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2244 |
.Ip "\fB\-Wstrict-aliasing\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2245 |
.IX Item "-Wstrict-aliasing" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2246 |
This option is only active when \fB\-fstrict-aliasing\fR is active. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2247 |
It warns about code which might break the strict aliasing rules that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2248 |
compiler is using for optimization. The warning does not catch all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2249 |
cases, but does attempt to catch the more common pitfalls. It is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2250 |
included in \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2251 |
.Ip "\fB\-Wall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2252 |
.IX Item "-Wall" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2253 |
All of the above \fB\-W\fR options combined. This enables all the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2254 |
warnings about constructions that some users consider questionable, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2255 |
that are easy to avoid (or modify to prevent the warning), even in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2256 |
conjunction with macros. This also enables some language-specific |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2257 |
warnings described in \fB\*(C+ Dialect Options\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2258 |
\&\fBObjective-C Dialect Options\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2259 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2260 |
The following \fB\-W...\fR options are not implied by \fB\-Wall\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2261 |
Some of them warn about constructions that users generally do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2262 |
consider questionable, but which occasionally you might wish to check |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2263 |
for; others warn about constructions that are necessary or hard to avoid |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2264 |
in some cases, and there is no simple way to modify the code to suppress |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2265 |
the warning. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2266 |
.Ip "\fB\-Wextra\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2267 |
.IX Item "-Wextra" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2268 |
(This option used to be called \fB\-W\fR. The older name is still |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2269 |
supported, but the newer name is more descriptive.) Print extra warning |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2270 |
messages for these events: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2271 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2272 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2273 |
A function can return either with or without a value. (Falling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2274 |
off the end of the function body is considered returning without |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2275 |
a value.) For example, this function would evoke such a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2276 |
warning: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2277 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2278 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2279 |
\& foo (a) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2280 |
\& { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2281 |
\& if (a > 0) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2282 |
\& return a; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2283 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2284 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2285 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2286 |
An expression-statement or the left-hand side of a comma expression |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2287 |
contains no side effects. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2288 |
To suppress the warning, cast the unused expression to void. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2289 |
For example, an expression such as \fBx[i,j]\fR will cause a warning, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2290 |
but \fBx[(void)i,j]\fR will not. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2291 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2292 |
An unsigned value is compared against zero with \fB<\fR or \fB>=\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2293 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2294 |
A comparison like \fBx<=y<=z\fR appears; this is equivalent to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2295 |
\&\fB(x<=y ? 1 : 0) <= z\fR, which is a different interpretation from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2296 |
that of ordinary mathematical notation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2297 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2298 |
Storage-class specifiers like \f(CW\*(C`static\*(C'\fR are not the first things in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2299 |
a declaration. According to the C Standard, this usage is obsolescent. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2300 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2301 |
The return type of a function has a type qualifier such as \f(CW\*(C`const\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2302 |
Such a type qualifier has no effect, since the value returned by a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2303 |
function is not an lvalue. (But don't warn about the \s-1GNU\s0 extension of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2304 |
\&\f(CW\*(C`volatile void\*(C'\fR return types. That extension will be warned about |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2305 |
if \fB\-pedantic\fR is specified.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2306 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2307 |
If \fB\-Wall\fR or \fB\-Wunused\fR is also specified, warn about unused |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2308 |
arguments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2309 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2310 |
A comparison between signed and unsigned values could produce an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2311 |
incorrect result when the signed value is converted to unsigned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2312 |
(But don't warn if \fB\-Wno-sign-compare\fR is also specified.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2313 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2314 |
An aggregate has an initializer which does not initialize all members. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2315 |
For example, the following code would cause such a warning, because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2316 |
\&\f(CW\*(C`x.h\*(C'\fR would be implicitly initialized to zero: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2317 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2318 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2319 |
\& struct s { int f, g, h; }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2320 |
\& struct s x = { 3, 4 }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2321 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2322 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2323 |
A function parameter is declared without a type specifier in K&R-style |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2324 |
functions: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2325 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2326 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2327 |
\& void foo(bar) { } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2328 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2329 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2330 |
An empty body occurs in an \fBif\fR or \fBelse\fR statement. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2331 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2332 |
A pointer is compared against integer zero with \fB<\fR, \fB<=\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2333 |
\&\fB>\fR, or \fB>=\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2334 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2335 |
A variable might be changed by \fBlongjmp\fR or \fBvfork\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2336 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2337 |
Any of several floating-point events that often indicate errors, such as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2338 |
overflow, underflow, loss of precision, etc. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2339 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2340 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2341 |
An enumerator and a non-enumerator both appear in a conditional expression. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2342 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2343 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2344 |
A non-static reference or non-static \fBconst\fR member appears in a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2345 |
class without constructors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2346 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2347 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2348 |
Ambiguous virtual bases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2349 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2350 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2351 |
Subscripting an array which has been declared \fBregister\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2352 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2353 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2354 |
Taking the address of a variable which has been declared \fBregister\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2355 |
.Ip "*<(\*(C+ only)>" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2356 |
.IX Item "*<( only)>" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2357 |
A base class is not initialized in a derived class' copy constructor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2358 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2359 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2360 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2361 |
.Ip "\fB\-Wno-div-by-zero\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2362 |
.IX Item "-Wno-div-by-zero" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2363 |
Do not warn about compile-time integer division by zero. Floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2364 |
division by zero is not warned about, as it can be a legitimate way of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2365 |
obtaining infinities and NaNs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2366 |
.Ip "\fB\-Wsystem-headers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2367 |
.IX Item "-Wsystem-headers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2368 |
Print warning messages for constructs found in system header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2369 |
Warnings from system headers are normally suppressed, on the assumption |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2370 |
that they usually do not indicate real problems and would only make the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2371 |
compiler output harder to read. Using this command line option tells |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2372 |
\&\s-1GCC\s0 to emit warnings from system headers as if they occurred in user |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2373 |
code. However, note that using \fB\-Wall\fR in conjunction with this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2374 |
option will \fInot\fR warn about unknown pragmas in system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2375 |
headers\-\-\-for that, \fB\-Wunknown-pragmas\fR must also be used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2376 |
.Ip "\fB\-Wfloat-equal\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2377 |
.IX Item "-Wfloat-equal" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2378 |
Warn if floating point values are used in equality comparisons. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2379 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2380 |
The idea behind this is that sometimes it is convenient (for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2381 |
programmer) to consider floating-point values as approximations to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2382 |
infinitely precise real numbers. If you are doing this, then you need |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2383 |
to compute (by analyzing the code, or in some other way) the maximum or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2384 |
likely maximum error that the computation introduces, and allow for it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2385 |
when performing comparisons (and when producing output, but that's a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2386 |
different problem). In particular, instead of testing for equality, you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2387 |
would check to see whether the two values have ranges that overlap; and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2388 |
this is done with the relational operators, so equality comparisons are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2389 |
probably mistaken. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2390 |
.Ip "\fB\-Wtraditional\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2391 |
.IX Item "-Wtraditional (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2392 |
Warn about certain constructs that behave differently in traditional and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2393 |
\&\s-1ISO\s0 C. Also warn about \s-1ISO\s0 C constructs that have no traditional C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2394 |
equivalent, and/or problematic constructs which should be avoided. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2395 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2396 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2397 |
Macro parameters that appear within string literals in the macro body. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2398 |
In traditional C macro replacement takes place within string literals, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2399 |
but does not in \s-1ISO\s0 C. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2400 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2401 |
In traditional C, some preprocessor directives did not exist. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2402 |
Traditional preprocessors would only consider a line to be a directive |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2403 |
if the \fB#\fR appeared in column 1 on the line. Therefore |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2404 |
\&\fB\-Wtraditional\fR warns about directives that traditional C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2405 |
understands but would ignore because the \fB#\fR does not appear as the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2406 |
first character on the line. It also suggests you hide directives like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2407 |
\&\fB#pragma\fR not understood by traditional C by indenting them. Some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2408 |
traditional implementations would not recognize \fB#elif\fR, so it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2409 |
suggests avoiding it altogether. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2410 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2411 |
A function-like macro that appears without arguments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2412 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2413 |
The unary plus operator. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2414 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2415 |
The \fBU\fR integer constant suffix, or the \fBF\fR or \fBL\fR floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2416 |
constant suffixes. (Traditional C does support the \fBL\fR suffix on integer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2417 |
constants.) Note, these suffixes appear in macros defined in the system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2418 |
headers of most modern systems, e.g. the \fB_MIN\fR/\fB_MAX\fR macros in \f(CW\*(C`<limits.h>\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2419 |
Use of these macros in user code might normally lead to spurious |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2420 |
warnings, however \s-1GCC\s0's integrated preprocessor has enough context to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2421 |
avoid warning in these cases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2422 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2423 |
A function declared external in one block and then used after the end of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2424 |
the block. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2425 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2426 |
A \f(CW\*(C`switch\*(C'\fR statement has an operand of type \f(CW\*(C`long\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2427 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2428 |
A non-\f(CW\*(C`static\*(C'\fR function declaration follows a \f(CW\*(C`static\*(C'\fR one. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2429 |
This construct is not accepted by some traditional C compilers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2430 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2431 |
The \s-1ISO\s0 type of an integer constant has a different width or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2432 |
signedness from its traditional type. This warning is only issued if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2433 |
the base of the constant is ten. I.e. hexadecimal or octal values, which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2434 |
typically represent bit patterns, are not warned about. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2435 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2436 |
Usage of \s-1ISO\s0 string concatenation is detected. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2437 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2438 |
Initialization of automatic aggregates. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2439 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2440 |
Identifier conflicts with labels. Traditional C lacks a separate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2441 |
namespace for labels. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2442 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2443 |
Initialization of unions. If the initializer is zero, the warning is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2444 |
omitted. This is done under the assumption that the zero initializer in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2445 |
user code appears conditioned on e.g. \f(CW\*(C`_\|_STDC_\|_\*(C'\fR to avoid missing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2446 |
initializer warnings and relies on default initialization to zero in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2447 |
traditional C case. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2448 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2449 |
Conversions by prototypes between fixed/floating point values and vice |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2450 |
versa. The absence of these prototypes when compiling with traditional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2451 |
C would cause serious problems. This is a subset of the possible |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2452 |
conversion warnings, for the full set use \fB\-Wconversion\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2453 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2454 |
Use of \s-1ISO\s0 C style function definitions. This warning intentionally is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2455 |
\&\fInot\fR issued for prototype declarations or variadic functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2456 |
because these \s-1ISO\s0 C features will appear in your code when using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2457 |
libiberty's traditional C compatibility macros, \f(CW\*(C`PARAMS\*(C'\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2458 |
\&\f(CW\*(C`VPARAMS\*(C'\fR. This warning is also bypassed for nested functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2459 |
because that feature is already a \s-1GCC\s0 extension and thus not relevant to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2460 |
traditional C compatibility. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2461 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2462 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2463 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2464 |
.Ip "\fB\-Wdeclaration-after-statement\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2465 |
.IX Item "-Wdeclaration-after-statement (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2466 |
Warn when a declaration is found after a statement in a block. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2467 |
construct, known from \*(C+, was introduced with \s-1ISO\s0 C99 and is by default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2468 |
allowed in \s-1GCC\s0. It is not supported by \s-1ISO\s0 C90 and was not supported by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2469 |
\&\s-1GCC\s0 versions before \s-1GCC\s0 3.0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2470 |
.Ip "\fB\-Wundef\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2471 |
.IX Item "-Wundef" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2472 |
Warn if an undefined identifier is evaluated in an \fB#if\fR directive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2473 |
.Ip "\fB\-Wendif-labels\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2474 |
.IX Item "-Wendif-labels" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2475 |
Warn whenever an \fB#else\fR or an \fB#endif\fR are followed by text. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2476 |
.Ip "\fB\-Wshadow\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2477 |
.IX Item "-Wshadow" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2478 |
Warn whenever a local variable shadows another local variable, parameter or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2479 |
global variable or whenever a built-in function is shadowed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2480 |
.Ip "\fB\-Wlarger-than-\fR\fIlen\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2481 |
.IX Item "-Wlarger-than-len" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2482 |
Warn whenever an object of larger than \fIlen\fR bytes is defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2483 |
.Ip "\fB\-Wpointer-arith\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2484 |
.IX Item "-Wpointer-arith" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2485 |
Warn about anything that depends on the ``size of'' a function type or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2486 |
of \f(CW\*(C`void\*(C'\fR. \s-1GNU\s0 C assigns these types a size of 1, for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2487 |
convenience in calculations with \f(CW\*(C`void *\*(C'\fR pointers and pointers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2488 |
to functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2489 |
.Ip "\fB\-Wbad-function-cast\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2490 |
.IX Item "-Wbad-function-cast (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2491 |
Warn whenever a function call is cast to a non-matching type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2492 |
For example, warn if \f(CW\*(C`int malloc()\*(C'\fR is cast to \f(CW\*(C`anything *\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2493 |
.Ip "\fB\-Wcast-qual\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2494 |
.IX Item "-Wcast-qual" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2495 |
Warn whenever a pointer is cast so as to remove a type qualifier from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2496 |
the target type. For example, warn if a \f(CW\*(C`const char *\*(C'\fR is cast |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2497 |
to an ordinary \f(CW\*(C`char *\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2498 |
.Ip "\fB\-Wcast-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2499 |
.IX Item "-Wcast-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2500 |
Warn whenever a pointer is cast such that the required alignment of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2501 |
target is increased. For example, warn if a \f(CW\*(C`char *\*(C'\fR is cast to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2502 |
an \f(CW\*(C`int *\*(C'\fR on machines where integers can only be accessed at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2503 |
two- or four-byte boundaries. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2504 |
.Ip "\fB\-Wwrite-strings\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2505 |
.IX Item "-Wwrite-strings" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2506 |
When compiling C, give string constants the type \f(CW\*(C`const |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2507 |
char[\f(CIlength\f(CW]\*(C'\fR so that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2508 |
copying the address of one into a non-\f(CW\*(C`const\*(C'\fR \f(CW\*(C`char *\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2509 |
pointer will get a warning; when compiling \*(C+, warn about the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2510 |
deprecated conversion from string constants to \f(CW\*(C`char *\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2511 |
These warnings will help you find at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2512 |
compile time code that can try to write into a string constant, but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2513 |
only if you have been very careful about using \f(CW\*(C`const\*(C'\fR in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2514 |
declarations and prototypes. Otherwise, it will just be a nuisance; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2515 |
this is why we did not make \fB\-Wall\fR request these warnings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2516 |
.Ip "\fB\-Wconversion\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2517 |
.IX Item "-Wconversion" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2518 |
Warn if a prototype causes a type conversion that is different from what |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2519 |
would happen to the same argument in the absence of a prototype. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2520 |
includes conversions of fixed point to floating and vice versa, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2521 |
conversions changing the width or signedness of a fixed point argument |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2522 |
except when the same as the default promotion. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2523 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2524 |
Also, warn if a negative integer constant expression is implicitly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2525 |
converted to an unsigned type. For example, warn about the assignment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2526 |
\&\f(CW\*(C`x = \-1\*(C'\fR if \f(CW\*(C`x\*(C'\fR is unsigned. But do not warn about explicit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2527 |
casts like \f(CW\*(C`(unsigned) \-1\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2528 |
.Ip "\fB\-Wsign-compare\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2529 |
.IX Item "-Wsign-compare" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2530 |
Warn when a comparison between signed and unsigned values could produce |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2531 |
an incorrect result when the signed value is converted to unsigned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2532 |
This warning is also enabled by \fB\-Wextra\fR; to get the other warnings |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2533 |
of \fB\-Wextra\fR without this warning, use \fB\-Wextra \-Wno-sign-compare\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2534 |
.Ip "\fB\-Waggregate-return\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2535 |
.IX Item "-Waggregate-return" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2536 |
Warn if any functions that return structures or unions are defined or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2537 |
called. (In languages where you can return an array, this also elicits |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2538 |
a warning.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2539 |
.Ip "\fB\-Wstrict-prototypes\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2540 |
.IX Item "-Wstrict-prototypes (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2541 |
Warn if a function is declared or defined without specifying the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2542 |
argument types. (An old-style function definition is permitted without |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2543 |
a warning if preceded by a declaration which specifies the argument |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2544 |
types.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2545 |
.Ip "\fB\-Wold-style-definition\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2546 |
.IX Item "-Wold-style-definition (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2547 |
Warn if an old-style function definition is used. A warning is given |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2548 |
even if there is a previous prototype. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2549 |
.Ip "\fB\-Wmissing-prototypes\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2550 |
.IX Item "-Wmissing-prototypes (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2551 |
Warn if a global function is defined without a previous prototype |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2552 |
declaration. This warning is issued even if the definition itself |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2553 |
provides a prototype. The aim is to detect global functions that fail |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2554 |
to be declared in header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2555 |
.Ip "\fB\-Wmissing-declarations\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2556 |
.IX Item "-Wmissing-declarations (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2557 |
Warn if a global function is defined without a previous declaration. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2558 |
Do so even if the definition itself provides a prototype. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2559 |
Use this option to detect global functions that are not declared in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2560 |
header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2561 |
.Ip "\fB\-Wmissing-noreturn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2562 |
.IX Item "-Wmissing-noreturn" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2563 |
Warn about functions which might be candidates for attribute \f(CW\*(C`noreturn\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2564 |
Note these are only possible candidates, not absolute ones. Care should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2565 |
be taken to manually verify functions actually do not ever return before |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2566 |
adding the \f(CW\*(C`noreturn\*(C'\fR attribute, otherwise subtle code generation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2567 |
bugs could be introduced. You will not get a warning for \f(CW\*(C`main\*(C'\fR in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2568 |
hosted C environments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2569 |
.Ip "\fB\-Wmissing-format-attribute\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2570 |
.IX Item "-Wmissing-format-attribute" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2571 |
If \fB\-Wformat\fR is enabled, also warn about functions which might be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2572 |
candidates for \f(CW\*(C`format\*(C'\fR attributes. Note these are only possible |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2573 |
candidates, not absolute ones. \s-1GCC\s0 will guess that \f(CW\*(C`format\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2574 |
attributes might be appropriate for any function that calls a function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2575 |
like \f(CW\*(C`vprintf\*(C'\fR or \f(CW\*(C`vscanf\*(C'\fR, but this might not always be the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2576 |
case, and some functions for which \f(CW\*(C`format\*(C'\fR attributes are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2577 |
appropriate may not be detected. This option has no effect unless |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2578 |
\&\fB\-Wformat\fR is enabled (possibly by \fB\-Wall\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2579 |
.Ip "\fB\-Wno-multichar\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2580 |
.IX Item "-Wno-multichar" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2581 |
Do not warn if a multicharacter constant (\fB'\s-1FOOF\s0'\fR) is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2582 |
Usually they indicate a typo in the user's code, as they have |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2583 |
implementation-defined values, and should not be used in portable code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2584 |
.Ip "\fB\-Wno-deprecated-declarations\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2585 |
.IX Item "-Wno-deprecated-declarations" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2586 |
Do not warn about uses of functions, variables, and types marked as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2587 |
deprecated by using the \f(CW\*(C`deprecated\*(C'\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2588 |
(@pxref{Function Attributes}, \f(CW@pxref\fR{Variable Attributes}, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2589 |
\&\f(CW@pxref\fR{Type Attributes}.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2590 |
.Ip "\fB\-Wpacked\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2591 |
.IX Item "-Wpacked" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2592 |
Warn if a structure is given the packed attribute, but the packed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2593 |
attribute has no effect on the layout or size of the structure. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2594 |
Such structures may be mis-aligned for little benefit. For |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2595 |
instance, in this code, the variable \f(CW\*(C`f.x\*(C'\fR in \f(CW\*(C`struct bar\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2596 |
will be misaligned even though \f(CW\*(C`struct bar\*(C'\fR does not itself |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2597 |
have the packed attribute: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2598 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2599 |
.Vb 8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2600 |
\& struct foo { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2601 |
\& int x; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2602 |
\& char a, b, c, d; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2603 |
\& } __attribute__((packed)); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2604 |
\& struct bar { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2605 |
\& char z; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2606 |
\& struct foo f; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2607 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2608 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2609 |
.Ip "\fB\-Wpadded\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2610 |
.IX Item "-Wpadded" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2611 |
Warn if padding is included in a structure, either to align an element |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2612 |
of the structure or to align the whole structure. Sometimes when this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2613 |
happens it is possible to rearrange the fields of the structure to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2614 |
reduce the padding and so make the structure smaller. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2615 |
.Ip "\fB\-Wredundant-decls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2616 |
.IX Item "-Wredundant-decls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2617 |
Warn if anything is declared more than once in the same scope, even in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2618 |
cases where multiple declaration is valid and changes nothing. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2619 |
.Ip "\fB\-Wnested-externs\fR (C only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2620 |
.IX Item "-Wnested-externs (C only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2621 |
Warn if an \f(CW\*(C`extern\*(C'\fR declaration is encountered within a function. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2622 |
.Ip "\fB\-Wunreachable-code\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2623 |
.IX Item "-Wunreachable-code" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2624 |
Warn if the compiler detects that code will never be executed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2625 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2626 |
This option is intended to warn when the compiler detects that at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2627 |
least a whole line of source code will never be executed, because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2628 |
some condition is never satisfied or because it is after a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2629 |
procedure that never returns. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2630 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2631 |
It is possible for this option to produce a warning even though there |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2632 |
are circumstances under which part of the affected line can be executed, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2633 |
so care should be taken when removing apparently-unreachable code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2634 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2635 |
For instance, when a function is inlined, a warning may mean that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2636 |
line is unreachable in only one inlined copy of the function. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2637 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2638 |
This option is not made part of \fB\-Wall\fR because in a debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2639 |
version of a program there is often substantial code which checks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2640 |
correct functioning of the program and is, hopefully, unreachable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2641 |
because the program does work. Another common use of unreachable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2642 |
code is to provide behavior which is selectable at compile-time. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2643 |
.Ip "\fB\-Winline\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2644 |
.IX Item "-Winline" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2645 |
Warn if a function can not be inlined and it was declared as inline. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2646 |
Even with this option, the compiler will not warn about failures to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2647 |
inline functions declared in system headers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2648 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2649 |
The compiler uses a variety of heuristics to determine whether or not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2650 |
to inline a function. For example, the compiler takes into account |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2651 |
the size of the function being inlined and the the amount of inlining |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2652 |
that has already been done in the current function. Therefore, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2653 |
seemingly insignificant changes in the source program can cause the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2654 |
warnings produced by \fB\-Winline\fR to appear or disappear. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2655 |
.Ip "\fB\-Wno-invalid-offsetof\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2656 |
.IX Item "-Wno-invalid-offsetof ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2657 |
Suppress warnings from applying the \fBoffsetof\fR macro to a non-POD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2658 |
type. According to the 1998 \s-1ISO\s0 \*(C+ standard, applying \fBoffsetof\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2659 |
to a non-POD type is undefined. In existing \*(C+ implementations, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2660 |
however, \fBoffsetof\fR typically gives meaningful results even when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2661 |
applied to certain kinds of non-POD types. (Such as a simple |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2662 |
\&\fBstruct\fR that fails to be a \s-1POD\s0 type only by virtue of having a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2663 |
constructor.) This flag is for users who are aware that they are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2664 |
writing nonportable code and who have deliberately chosen to ignore the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2665 |
warning about it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2666 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2667 |
The restrictions on \fBoffsetof\fR may be relaxed in a future version |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2668 |
of the \*(C+ standard. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2669 |
.Ip "\fB\-Winvalid-pch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2670 |
.IX Item "-Winvalid-pch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2671 |
Warn if a precompiled header is found in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2672 |
the search path but can't be used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2673 |
.Ip "\fB\-Wlong-long\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2674 |
.IX Item "-Wlong-long" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2675 |
Warn if \fBlong long\fR type is used. This is default. To inhibit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2676 |
the warning messages, use \fB\-Wno-long-long\fR. Flags |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2677 |
\&\fB\-Wlong-long\fR and \fB\-Wno-long-long\fR are taken into account |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2678 |
only when \fB\-pedantic\fR flag is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2679 |
.Ip "\fB\-Wdisabled-optimization\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2680 |
.IX Item "-Wdisabled-optimization" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2681 |
Warn if a requested optimization pass is disabled. This warning does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2682 |
not generally indicate that there is anything wrong with your code; it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2683 |
merely indicates that \s-1GCC\s0's optimizers were unable to handle the code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2684 |
effectively. Often, the problem is that your code is too big or too |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2685 |
complex; \s-1GCC\s0 will refuse to optimize programs when the optimization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2686 |
itself is likely to take inordinate amounts of time. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2687 |
.Ip "\fB\-Werror\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2688 |
.IX Item "-Werror" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2689 |
Make all warnings into errors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2690 |
.Sh "Options for Debugging Your Program or \s-1GCC\s0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2691 |
.IX Subsection "Options for Debugging Your Program or GCC" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2692 |
\&\s-1GCC\s0 has various special options that are used for debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2693 |
either your program or \s-1GCC:\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2694 |
.Ip "\fB\-g\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2695 |
.IX Item "-g" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2696 |
Produce debugging information in the operating system's native format |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2697 |
(stabs, \s-1COFF\s0, \s-1XCOFF\s0, or \s-1DWARF\s0). \s-1GDB\s0 can work with this debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2698 |
information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2699 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2700 |
On most systems that use stabs format, \fB\-g\fR enables use of extra |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2701 |
debugging information that only \s-1GDB\s0 can use; this extra information |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2702 |
makes debugging work better in \s-1GDB\s0 but will probably make other debuggers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2703 |
crash or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2704 |
refuse to read the program. If you want to control for certain whether |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2705 |
to generate the extra information, use \fB\-gstabs+\fR, \fB\-gstabs\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2706 |
\&\fB\-gxcoff+\fR, \fB\-gxcoff\fR, or \fB\-gvms\fR (see below). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2707 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2708 |
Unlike most other C compilers, \s-1GCC\s0 allows you to use \fB\-g\fR with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2709 |
\&\fB\-O\fR. The shortcuts taken by optimized code may occasionally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2710 |
produce surprising results: some variables you declared may not exist |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2711 |
at all; flow of control may briefly move where you did not expect it; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2712 |
some statements may not be executed because they compute constant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2713 |
results or their values were already at hand; some statements may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2714 |
execute in different places because they were moved out of loops. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2715 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2716 |
Nevertheless it proves possible to debug optimized output. This makes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2717 |
it reasonable to use the optimizer for programs that might have bugs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2718 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2719 |
The following options are useful when \s-1GCC\s0 is generated with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2720 |
capability for more than one debugging format. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2721 |
.Ip "\fB\-ggdb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2722 |
.IX Item "-ggdb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2723 |
Produce debugging information for use by \s-1GDB\s0. This means to use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2724 |
most expressive format available (\s-1DWARF\s0 2, stabs, or the native format |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2725 |
if neither of those are supported), including \s-1GDB\s0 extensions if at all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2726 |
possible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2727 |
.Ip "\fB\-gstabs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2728 |
.IX Item "-gstabs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2729 |
Produce debugging information in stabs format (if that is supported), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2730 |
without \s-1GDB\s0 extensions. This is the format used by \s-1DBX\s0 on most \s-1BSD\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2731 |
systems. On \s-1MIPS\s0, Alpha and System V Release 4 systems this option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2732 |
produces stabs debugging output which is not understood by \s-1DBX\s0 or \s-1SDB\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2733 |
On System V Release 4 systems this option requires the \s-1GNU\s0 assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2734 |
.Ip "\fB\-feliminate-unused-debug-symbols\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2735 |
.IX Item "-feliminate-unused-debug-symbols" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2736 |
Produce debugging information in stabs format (if that is supported), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2737 |
for only symbols that are actually used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2738 |
.Ip "\fB\-gstabs+\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2739 |
.IX Item "-gstabs+" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2740 |
Produce debugging information in stabs format (if that is supported), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2741 |
using \s-1GNU\s0 extensions understood only by the \s-1GNU\s0 debugger (\s-1GDB\s0). The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2742 |
use of these extensions is likely to make other debuggers crash or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2743 |
refuse to read the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2744 |
.Ip "\fB\-gcoff\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2745 |
.IX Item "-gcoff" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2746 |
Produce debugging information in \s-1COFF\s0 format (if that is supported). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2747 |
This is the format used by \s-1SDB\s0 on most System V systems prior to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2748 |
System V Release 4. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2749 |
.Ip "\fB\-gxcoff\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2750 |
.IX Item "-gxcoff" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2751 |
Produce debugging information in \s-1XCOFF\s0 format (if that is supported). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2752 |
This is the format used by the \s-1DBX\s0 debugger on \s-1IBM\s0 \s-1RS/6000\s0 systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2753 |
.Ip "\fB\-gxcoff+\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2754 |
.IX Item "-gxcoff+" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2755 |
Produce debugging information in \s-1XCOFF\s0 format (if that is supported), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2756 |
using \s-1GNU\s0 extensions understood only by the \s-1GNU\s0 debugger (\s-1GDB\s0). The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2757 |
use of these extensions is likely to make other debuggers crash or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2758 |
refuse to read the program, and may cause assemblers other than the \s-1GNU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2759 |
assembler (\s-1GAS\s0) to fail with an error. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2760 |
.Ip "\fB\-gdwarf-2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2761 |
.IX Item "-gdwarf-2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2762 |
Produce debugging information in \s-1DWARF\s0 version 2 format (if that is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2763 |
supported). This is the format used by \s-1DBX\s0 on \s-1IRIX\s0 6. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2764 |
.Ip "\fB\-gvms\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2765 |
.IX Item "-gvms" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2766 |
Produce debugging information in \s-1VMS\s0 debug format (if that is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2767 |
supported). This is the format used by \s-1DEBUG\s0 on \s-1VMS\s0 systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2768 |
.Ip "\fB\-g\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2769 |
.IX Item "-glevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2770 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2771 |
.Ip "\fB\-ggdb\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2772 |
.IX Item "-ggdblevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2773 |
.Ip "\fB\-gstabs\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2774 |
.IX Item "-gstabslevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2775 |
.Ip "\fB\-gcoff\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2776 |
.IX Item "-gcofflevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2777 |
.Ip "\fB\-gxcoff\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2778 |
.IX Item "-gxcofflevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2779 |
.Ip "\fB\-gvms\fR\fIlevel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2780 |
.IX Item "-gvmslevel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2781 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2782 |
Request debugging information and also use \fIlevel\fR to specify how |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2783 |
much information. The default level is 2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2784 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2785 |
Level 1 produces minimal information, enough for making backtraces in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2786 |
parts of the program that you don't plan to debug. This includes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2787 |
descriptions of functions and external variables, but no information |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2788 |
about local variables and no line numbers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2789 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2790 |
Level 3 includes extra information, such as all the macro definitions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2791 |
present in the program. Some debuggers support macro expansion when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2792 |
you use \fB\-g3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2793 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2794 |
Note that in order to avoid confusion between \s-1DWARF1\s0 debug level 2, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2795 |
and \s-1DWARF2\s0 \fB\-gdwarf-2\fR does not accept a concatenated debug |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2796 |
level. Instead use an additional \fB\-g\fR\fIlevel\fR option to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2797 |
change the debug level for \s-1DWARF2\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2798 |
.Ip "\fB\-feliminate-dwarf2\-dups\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2799 |
.IX Item "-feliminate-dwarf2-dups" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2800 |
Compress \s-1DWARF2\s0 debugging information by eliminating duplicated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2801 |
information about each symbol. This option only makes sense when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2802 |
generating \s-1DWARF2\s0 debugging information with \fB\-gdwarf-2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2803 |
.Ip "\fB\-p\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2804 |
.IX Item "-p" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2805 |
Generate extra code to write profile information suitable for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2806 |
analysis program \fBprof\fR. You must use this option when compiling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2807 |
the source files you want data about, and you must also use it when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2808 |
linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2809 |
.Ip "\fB\-pg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2810 |
.IX Item "-pg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2811 |
Generate extra code to write profile information suitable for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2812 |
analysis program \fBgprof\fR. You must use this option when compiling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2813 |
the source files you want data about, and you must also use it when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2814 |
linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2815 |
.Ip "\fB\-Q\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2816 |
.IX Item "-Q" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2817 |
Makes the compiler print out each function name as it is compiled, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2818 |
print some statistics about each pass when it finishes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2819 |
.Ip "\fB\-ftime-report\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2820 |
.IX Item "-ftime-report" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2821 |
Makes the compiler print some statistics about the time consumed by each |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2822 |
pass when it finishes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2823 |
.Ip "\fB\-fmem-report\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2824 |
.IX Item "-fmem-report" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2825 |
Makes the compiler print some statistics about permanent memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2826 |
allocation when it finishes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2827 |
.Ip "\fB\-fprofile-arcs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2828 |
.IX Item "-fprofile-arcs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2829 |
Add code so that program flow \fIarcs\fR are instrumented. During |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2830 |
execution the program records how many times each branch and call is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2831 |
executed and how many times it is taken or returns. When the compiled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2832 |
program exits it saves this data to a file called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2833 |
\&\fI\fIauxname\fI.gcda\fR for each source file. The data may be used for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2834 |
profile-directed optimizations (\fB\-fbranch-probabilities\fR), or for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2835 |
test coverage analysis (\fB\-ftest-coverage\fR). Each object file's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2836 |
\&\fIauxname\fR is generated from the name of the output file, if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2837 |
explicitly specified and it is not the final executable, otherwise it is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2838 |
the basename of the source file. In both cases any suffix is removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2839 |
(e.g. \fIfoo.gcda\fR for input file \fIdir/foo.c\fR, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2840 |
\&\fIdir/foo.gcda\fR for output file specified as \fB\-o dir/foo.o\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2841 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2842 |
.Ip "@bullet" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2843 |
.IX Item "@bullet" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2844 |
Compile the source files with \fB\-fprofile-arcs\fR plus optimization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2845 |
and code generation options. For test coverage analysis, use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2846 |
additional \fB\-ftest-coverage\fR option. You do not need to profile |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2847 |
every source file in a program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2848 |
.Ip "@cvmmfu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2849 |
.IX Item "@cvmmfu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2850 |
Link your object files with \fB\-lgcov\fR or \fB\-fprofile-arcs\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2851 |
(the latter implies the former). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2852 |
.Ip "@dwnngv" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2853 |
.IX Item "@dwnngv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2854 |
Run the program on a representative workload to generate the arc profile |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2855 |
information. This may be repeated any number of times. You can run |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2856 |
concurrent instances of your program, and provided that the file system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2857 |
supports locking, the data files will be correctly updated. Also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2858 |
\&\f(CW\*(C`fork\*(C'\fR calls are detected and correctly handled (double counting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2859 |
will not happen). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2860 |
.Ip "@exoohw" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2861 |
.IX Item "@exoohw" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2862 |
For profile-directed optimizations, compile the source files again with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2863 |
the same optimization and code generation options plus |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2864 |
\&\fB\-fbranch-probabilities\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2865 |
.Ip "@fyppix" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2866 |
.IX Item "@fyppix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2867 |
For test coverage analysis, use \fBgcov\fR to produce human readable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2868 |
information from the \fI.gcno\fR and \fI.gcda\fR files. Refer to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2869 |
\&\fBgcov\fR documentation for further information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2870 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2871 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2872 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2873 |
With \fB\-fprofile-arcs\fR, for each function of your program \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2874 |
creates a program flow graph, then finds a spanning tree for the graph. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2875 |
Only arcs that are not on the spanning tree have to be instrumented: the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2876 |
compiler adds code to count the number of times that these arcs are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2877 |
executed. When an arc is the only exit or only entrance to a block, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2878 |
instrumentation code can be added to the block; otherwise, a new basic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2879 |
block must be created to hold the instrumentation code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2880 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2881 |
.Ip "\fB\-ftest-coverage\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2882 |
.IX Item "-ftest-coverage" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2883 |
Produce a notes file that the \fBgcov\fR code-coverage utility can use to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2884 |
show program coverage. Each source file's note file is called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2885 |
\&\fI\fIauxname\fI.gcno\fR. Refer to the \fB\-fprofile-arcs\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2886 |
above for a description of \fIauxname\fR and instructions on how to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2887 |
generate test coverage data. Coverage data will match the source files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2888 |
more closely, if you do not optimize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2889 |
.Ip "\fB\-d\fR\fIletters\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2890 |
.IX Item "-dletters" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2891 |
Says to make debugging dumps during compilation at times specified by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2892 |
\&\fIletters\fR. This is used for debugging the compiler. The file names |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2893 |
for most of the dumps are made by appending a pass number and a word to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2894 |
the \fIdumpname\fR. \fIdumpname\fR is generated from the name of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2895 |
output file, if explicitly specified and it is not an executable, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2896 |
otherwise it is the basename of the source file. In both cases any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2897 |
suffix is removed (e.g. \fIfoo.01.rtl\fR or \fIfoo.02.sibling\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2898 |
Here are the possible letters for use in \fIletters\fR, and their |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2899 |
meanings: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2900 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2901 |
.Ip "\fBA\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2902 |
.IX Item "A" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2903 |
Annotate the assembler output with miscellaneous debugging information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2904 |
.Ip "\fBb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2905 |
.IX Item "b" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2906 |
Dump after computing branch probabilities, to \fI\fIfile\fI.12.bp\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2907 |
.Ip "\fBB\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2908 |
.IX Item "B" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2909 |
Dump after block reordering, to \fI\fIfile\fI.31.bbro\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2910 |
.Ip "\fBc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2911 |
.IX Item "c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2912 |
Dump after instruction combination, to the file \fI\fIfile\fI.20.combine\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2913 |
.Ip "\fBC\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2914 |
.IX Item "C" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2915 |
Dump after the first if conversion, to the file \fI\fIfile\fI.14.ce1\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2916 |
Also dump after the second if conversion, to the file \fI\fIfile\fI.21.ce2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2917 |
.Ip "\fBd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2918 |
.IX Item "d" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2919 |
Dump after branch target load optimization, to to \fI\fIfile\fI.32.btl\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2920 |
Also dump after delayed branch scheduling, to \fI\fIfile\fI.36.dbr\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2921 |
.Ip "\fBD\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2922 |
.IX Item "D" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2923 |
Dump all macro definitions, at the end of preprocessing, in addition to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2924 |
normal output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2925 |
.Ip "\fBE\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2926 |
.IX Item "E" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2927 |
Dump after the third if conversion, to \fI\fIfile\fI.30.ce3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2928 |
.Ip "\fBf\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2929 |
.IX Item "f" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2930 |
Dump after control and data flow analysis, to \fI\fIfile\fI.11.cfg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2931 |
Also dump after life analysis, to \fI\fIfile\fI.19.life\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2932 |
.Ip "\fBF\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2933 |
.IX Item "F" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2934 |
Dump after purging \f(CW\*(C`ADDRESSOF\*(C'\fR codes, to \fI\fIfile\fI.07.addressof\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2935 |
.Ip "\fBg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2936 |
.IX Item "g" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2937 |
Dump after global register allocation, to \fI\fIfile\fI.25.greg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2938 |
.Ip "\fBG\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2939 |
.IX Item "G" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2940 |
Dump after \s-1GCSE\s0, to \fI\fIfile\fI.08.gcse\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2941 |
Also dump after jump bypassing and control flow optimizations, to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2942 |
\&\fI\fIfile\fI.10.bypass\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2943 |
.Ip "\fBh\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2944 |
.IX Item "h" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2945 |
Dump after finalization of \s-1EH\s0 handling code, to \fI\fIfile\fI.03.eh\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2946 |
.Ip "\fBi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2947 |
.IX Item "i" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2948 |
Dump after sibling call optimizations, to \fI\fIfile\fI.02.sibling\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2949 |
.Ip "\fBj\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2950 |
.IX Item "j" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2951 |
Dump after the first jump optimization, to \fI\fIfile\fI.04.jump\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2952 |
.Ip "\fBk\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2953 |
.IX Item "k" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2954 |
Dump after conversion from registers to stack, to \fI\fIfile\fI.34.stack\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2955 |
.Ip "\fBl\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2956 |
.IX Item "l" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2957 |
Dump after local register allocation, to \fI\fIfile\fI.24.lreg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2958 |
.Ip "\fBL\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2959 |
.IX Item "L" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2960 |
Dump after loop optimization passes, to \fI\fIfile\fI.09.loop\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2961 |
\&\fI\fIfile\fI.16.loop2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2962 |
.Ip "\fBM\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2963 |
.IX Item "M" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2964 |
Dump after performing the machine dependent reorganization pass, to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2965 |
\&\fI\fIfile\fI.35.mach\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2966 |
.Ip "\fBn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2967 |
.IX Item "n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2968 |
Dump after register renumbering, to \fI\fIfile\fI.29.rnreg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2969 |
.Ip "\fBN\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2970 |
.IX Item "N" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2971 |
Dump after the register move pass, to \fI\fIfile\fI.22.regmove\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2972 |
.Ip "\fBo\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2973 |
.IX Item "o" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2974 |
Dump after post-reload optimizations, to \fI\fIfile\fI.26.postreload\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2975 |
.Ip "\fBr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2976 |
.IX Item "r" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2977 |
Dump after \s-1RTL\s0 generation, to \fI\fIfile\fI.01.rtl\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2978 |
.Ip "\fBR\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2979 |
.IX Item "R" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2980 |
Dump after the second scheduling pass, to \fI\fIfile\fI.33.sched2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2981 |
.Ip "\fBs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2982 |
.IX Item "s" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2983 |
Dump after \s-1CSE\s0 (including the jump optimization that sometimes follows |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2984 |
\&\s-1CSE\s0), to \fI\fIfile\fI.06.cse\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2985 |
.Ip "\fBS\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2986 |
.IX Item "S" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2987 |
Dump after the first scheduling pass, to \fI\fIfile\fI.23.sched\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2988 |
.Ip "\fBt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2989 |
.IX Item "t" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2990 |
Dump after the second \s-1CSE\s0 pass (including the jump optimization that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2991 |
sometimes follows \s-1CSE\s0), to \fI\fIfile\fI.18.cse2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2992 |
.Ip "\fBT\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2993 |
.IX Item "T" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2994 |
Dump after running tracer, to \fI\fIfile\fI.15.tracer\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2995 |
.Ip "\fBu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2996 |
.IX Item "u" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2997 |
Dump after null pointer elimination pass to \fI\fIfile\fI.05.null\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2998 |
.Ip "\fBU\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
2999 |
.IX Item "U" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3000 |
Dump callgraph and unit-at-a-time optimization \fI\fIfile\fI.00.unit\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3001 |
.Ip "\fBV\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3002 |
.IX Item "V" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3003 |
Dump after the value profile transformations, to \fI\fIfile\fI.13.vpt\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3004 |
.Ip "\fBw\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3005 |
.IX Item "w" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3006 |
Dump after the second flow pass, to \fI\fIfile\fI.27.flow2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3007 |
.Ip "\fBz\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3008 |
.IX Item "z" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3009 |
Dump after the peephole pass, to \fI\fIfile\fI.28.peephole2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3010 |
.Ip "\fBZ\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3011 |
.IX Item "Z" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3012 |
Dump after constructing the web, to \fI\fIfile\fI.17.web\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3013 |
.Ip "\fBa\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3014 |
.IX Item "a" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3015 |
Produce all the dumps listed above. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3016 |
.Ip "\fBH\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3017 |
.IX Item "H" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3018 |
Produce a core dump whenever an error occurs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3019 |
.Ip "\fBm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3020 |
.IX Item "m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3021 |
Print statistics on memory usage, at the end of the run, to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3022 |
standard error. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3023 |
.Ip "\fBp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3024 |
.IX Item "p" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3025 |
Annotate the assembler output with a comment indicating which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3026 |
pattern and alternative was used. The length of each instruction is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3027 |
also printed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3028 |
.Ip "\fBP\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3029 |
.IX Item "P" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3030 |
Dump the \s-1RTL\s0 in the assembler output as a comment before each instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3031 |
Also turns on \fB\-dp\fR annotation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3032 |
.Ip "\fBv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3033 |
.IX Item "v" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3034 |
For each of the other indicated dump files (except for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3035 |
\&\fI\fIfile\fI.01.rtl\fR), dump a representation of the control flow graph |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3036 |
suitable for viewing with \s-1VCG\s0 to \fI\fIfile\fI.\fIpass\fI.vcg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3037 |
.Ip "\fBx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3038 |
.IX Item "x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3039 |
Just generate \s-1RTL\s0 for a function instead of compiling it. Usually used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3040 |
with \fBr\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3041 |
.Ip "\fBy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3042 |
.IX Item "y" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3043 |
Dump debugging information during parsing, to standard error. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3044 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3045 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3046 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3047 |
.Ip "\fB\-fdump-unnumbered\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3048 |
.IX Item "-fdump-unnumbered" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3049 |
When doing debugging dumps (see \fB\-d\fR option above), suppress instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3050 |
numbers and line number note output. This makes it more feasible to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3051 |
use diff on debugging dumps for compiler invocations with different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3052 |
options, in particular with and without \fB\-g\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3053 |
.Ip "\fB\-fdump-translation-unit\fR (C and \*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3054 |
.IX Item "-fdump-translation-unit (C and only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3055 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3056 |
.Ip "\fB\-fdump-translation-unit-\fR\fIoptions\fR\fB \fR(C and \*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3057 |
.IX Item "-fdump-translation-unit-options (C and only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3058 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3059 |
Dump a representation of the tree structure for the entire translation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3060 |
unit to a file. The file name is made by appending \fI.tu\fR to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3061 |
source file name. If the \fB-\fR\fIoptions\fR form is used, \fIoptions\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3062 |
controls the details of the dump as described for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3063 |
\&\fB\-fdump-tree\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3064 |
.Ip "\fB\-fdump-class-hierarchy\fR (\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3065 |
.IX Item "-fdump-class-hierarchy ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3066 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3067 |
.Ip "\fB\-fdump-class-hierarchy-\fR\fIoptions\fR\fB \fR(\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3068 |
.IX Item "-fdump-class-hierarchy-options ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3069 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3070 |
Dump a representation of each class's hierarchy and virtual function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3071 |
table layout to a file. The file name is made by appending \fI.class\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3072 |
to the source file name. If the \fB-\fR\fIoptions\fR form is used, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3073 |
\&\fIoptions\fR controls the details of the dump as described for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3074 |
\&\fB\-fdump-tree\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3075 |
.Ip "\fB\-fdump-tree-\fR\fIswitch\fR\fB \fR(\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3076 |
.IX Item "-fdump-tree-switch ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3077 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3078 |
.Ip "\fB\-fdump-tree-\fR\fIswitch\fR\fB-\fR\fIoptions\fR\fB \fR(\*(C+ only)" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3079 |
.IX Item "-fdump-tree-switch-options ( only)" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3080 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3081 |
Control the dumping at various stages of processing the intermediate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3082 |
language tree to a file. The file name is generated by appending a switch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3083 |
specific suffix to the source file name. If the \fB-\fR\fIoptions\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3084 |
form is used, \fIoptions\fR is a list of \fB-\fR separated options that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3085 |
control the details of the dump. Not all options are applicable to all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3086 |
dumps, those which are not meaningful will be ignored. The following |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3087 |
options are available |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3088 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3089 |
.Ip "\fBaddress\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3090 |
.IX Item "address" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3091 |
Print the address of each node. Usually this is not meaningful as it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3092 |
changes according to the environment and source file. Its primary use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3093 |
is for tying up a dump file with a debug environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3094 |
.Ip "\fBslim\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3095 |
.IX Item "slim" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3096 |
Inhibit dumping of members of a scope or body of a function merely |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3097 |
because that scope has been reached. Only dump such items when they |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3098 |
are directly reachable by some other path. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3099 |
.Ip "\fBall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3100 |
.IX Item "all" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3101 |
Turn on all options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3102 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3103 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3104 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3105 |
The following tree dumps are possible: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3106 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3107 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3108 |
.Ip "\fBoriginal\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3109 |
.IX Item "original" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3110 |
Dump before any tree based optimization, to \fI\fIfile\fI.original\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3111 |
.Ip "\fBoptimized\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3112 |
.IX Item "optimized" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3113 |
Dump after all tree based optimization, to \fI\fIfile\fI.optimized\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3114 |
.Ip "\fBinlined\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3115 |
.IX Item "inlined" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3116 |
Dump after function inlining, to \fI\fIfile\fI.inlined\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3117 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3118 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3119 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3120 |
.Ip "\fB\-frandom-seed=\fR\fIstring\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3121 |
.IX Item "-frandom-seed=string" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3122 |
This option provides a seed that \s-1GCC\s0 uses when it would otherwise use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3123 |
random numbers. It is used to generate certain symbol names |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3124 |
that have to be different in every compiled file. It is also used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3125 |
place unique stamps in coverage data files and the object files that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3126 |
produce them. You can use the \fB\-frandom-seed\fR option to produce |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3127 |
reproducibly identical object files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3128 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3129 |
The \fIstring\fR should be different for every file you compile. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3130 |
.Ip "\fB\-fsched-verbose=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3131 |
.IX Item "-fsched-verbose=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3132 |
On targets that use instruction scheduling, this option controls the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3133 |
amount of debugging output the scheduler prints. This information is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3134 |
written to standard error, unless \fB\-dS\fR or \fB\-dR\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3135 |
specified, in which case it is output to the usual dump |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3136 |
listing file, \fI.sched\fR or \fI.sched2\fR respectively. However |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3137 |
for \fIn\fR greater than nine, the output is always printed to standard |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3138 |
error. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3139 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3140 |
For \fIn\fR greater than zero, \fB\-fsched-verbose\fR outputs the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3141 |
same information as \fB\-dRS\fR. For \fIn\fR greater than one, it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3142 |
also output basic block probabilities, detailed ready list information |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3143 |
and unit/insn info. For \fIn\fR greater than two, it includes \s-1RTL\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3144 |
at abort point, control-flow and regions info. And for \fIn\fR over |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3145 |
four, \fB\-fsched-verbose\fR also includes dependence info. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3146 |
.Ip "\fB\-save-temps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3147 |
.IX Item "-save-temps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3148 |
Store the usual ``temporary'' intermediate files permanently; place them |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3149 |
in the current directory and name them based on the source file. Thus, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3150 |
compiling \fIfoo.c\fR with \fB\-c \-save-temps\fR would produce files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3151 |
\&\fIfoo.i\fR and \fIfoo.s\fR, as well as \fIfoo.o\fR. This creates a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3152 |
preprocessed \fIfoo.i\fR output file even though the compiler now |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3153 |
normally uses an integrated preprocessor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3154 |
.Ip "\fB\-time\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3155 |
.IX Item "-time" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3156 |
Report the \s-1CPU\s0 time taken by each subprocess in the compilation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3157 |
sequence. For C source files, this is the compiler proper and assembler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3158 |
(plus the linker if linking is done). The output looks like this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3159 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3160 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3161 |
\& # cc1 0.12 0.01 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3162 |
\& # as 0.00 0.01 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3163 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3164 |
The first number on each line is the ``user time,'' that is time spent |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3165 |
executing the program itself. The second number is ``system time,'' |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3166 |
time spent executing operating system routines on behalf of the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3167 |
Both numbers are in seconds. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3168 |
.Ip "\fB\-print-file-name=\fR\fIlibrary\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3169 |
.IX Item "-print-file-name=library" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3170 |
Print the full absolute name of the library file \fIlibrary\fR that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3171 |
would be used when linking\-\-\-and don't do anything else. With this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3172 |
option, \s-1GCC\s0 does not compile or link anything; it just prints the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3173 |
file name. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3174 |
.Ip "\fB\-print-multi-directory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3175 |
.IX Item "-print-multi-directory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3176 |
Print the directory name corresponding to the multilib selected by any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3177 |
other switches present in the command line. This directory is supposed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3178 |
to exist in \fB\s-1GCC_EXEC_PREFIX\s0\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3179 |
.Ip "\fB\-print-multi-lib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3180 |
.IX Item "-print-multi-lib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3181 |
Print the mapping from multilib directory names to compiler switches |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3182 |
that enable them. The directory name is separated from the switches by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3183 |
\&\fB;\fR, and each switch starts with an \fB@} instead of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3184 |
\&\f(CB@samp\fB{-\fR, without spaces between multiple switches. This is supposed to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3185 |
ease shell-processing. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3186 |
.Ip "\fB\-print-prog-name=\fR\fIprogram\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3187 |
.IX Item "-print-prog-name=program" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3188 |
Like \fB\-print-file-name\fR, but searches for a program such as \fBcpp\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3189 |
.Ip "\fB\-print-libgcc-file-name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3190 |
.IX Item "-print-libgcc-file-name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3191 |
Same as \fB\-print-file-name=libgcc.a\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3192 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3193 |
This is useful when you use \fB\-nostdlib\fR or \fB\-nodefaultlibs\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3194 |
but you do want to link with \fIlibgcc.a\fR. You can do |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3195 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3196 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3197 |
\& gcc -nostdlib <files>... `gcc -print-libgcc-file-name` |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3198 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3199 |
.Ip "\fB\-print-search-dirs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3200 |
.IX Item "-print-search-dirs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3201 |
Print the name of the configured installation directory and a list of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3202 |
program and library directories \fBgcc\fR will search\-\-\-and don't do anything else. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3203 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3204 |
This is useful when \fBgcc\fR prints the error message |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3205 |
\&\fBinstallation problem, cannot exec cpp0: No such file or directory\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3206 |
To resolve this you either need to put \fIcpp0\fR and the other compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3207 |
components where \fBgcc\fR expects to find them, or you can set the environment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3208 |
variable \fB\s-1GCC_EXEC_PREFIX\s0\fR to the directory where you installed them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3209 |
Don't forget the trailing '/'. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3210 |
.Ip "\fB\-dumpmachine\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3211 |
.IX Item "-dumpmachine" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3212 |
Print the compiler's target machine (for example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3213 |
\&\fBi686\-pc-linux-gnu\fR)\-\-\-and don't do anything else. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3214 |
.Ip "\fB\-dumpversion\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3215 |
.IX Item "-dumpversion" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3216 |
Print the compiler version (for example, \fB3.0\fR)\-\-\-and don't do |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3217 |
anything else. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3218 |
.Ip "\fB\-dumpspecs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3219 |
.IX Item "-dumpspecs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3220 |
Print the compiler's built-in specs\-\-\-and don't do anything else. (This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3221 |
is used when \s-1GCC\s0 itself is being built.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3222 |
.Ip "\fB\-feliminate-unused-debug-types\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3223 |
.IX Item "-feliminate-unused-debug-types" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3224 |
Normally, when producing \s-1DWARF2\s0 output, \s-1GCC\s0 will emit debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3225 |
information for all types declared in a compilation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3226 |
unit, regardless of whether or not they are actually used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3227 |
in that compilation unit. Sometimes this is useful, such as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3228 |
if, in the debugger, you want to cast a value to a type that is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3229 |
not actually used in your program (but is declared). More often, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3230 |
however, this results in a significant amount of wasted space. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3231 |
With this option, \s-1GCC\s0 will avoid producing debug symbol output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3232 |
for types that are nowhere used in the source file being compiled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3233 |
.Sh "Options That Control Optimization" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3234 |
.IX Subsection "Options That Control Optimization" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3235 |
These options control various sorts of optimizations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3236 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3237 |
Without any optimization option, the compiler's goal is to reduce the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3238 |
cost of compilation and to make debugging produce the expected |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3239 |
results. Statements are independent: if you stop the program with a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3240 |
breakpoint between statements, you can then assign a new value to any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3241 |
variable or change the program counter to any other statement in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3242 |
function and get exactly the results you would expect from the source |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3243 |
code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3244 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3245 |
Turning on optimization flags makes the compiler attempt to improve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3246 |
the performance and/or code size at the expense of compilation time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3247 |
and possibly the ability to debug the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3248 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3249 |
The compiler performs optimization based on the knowledge it has of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3250 |
the program. Using the \fB\-funit-at-a-time\fR flag will allow the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3251 |
compiler to consider information gained from later functions in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3252 |
file when compiling a function. Compiling multiple files at once to a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3253 |
single output file (and using \fB\-funit-at-a-time\fR) will allow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3254 |
the compiler to use information gained from all of the files when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3255 |
compiling each of them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3256 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3257 |
Not all optimizations are controlled directly by a flag. Only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3258 |
optimizations that have a flag are listed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3259 |
.Ip "\fB\-O\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3260 |
.IX Item "-O" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3261 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3262 |
.Ip "\fB\-O1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3263 |
.IX Item "-O1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3264 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3265 |
Optimize. Optimizing compilation takes somewhat more time, and a lot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3266 |
more memory for a large function. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3267 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3268 |
With \fB\-O\fR, the compiler tries to reduce code size and execution |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3269 |
time, without performing any optimizations that take a great deal of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3270 |
compilation time. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3271 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3272 |
\&\fB\-O\fR turns on the following optimization flags: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3273 |
\&\fB\-fdefer-pop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3274 |
\&\-fmerge-constants |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3275 |
\&\-fthread-jumps |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3276 |
\&\-floop-optimize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3277 |
\&\-fif-conversion |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3278 |
\&\-fif-conversion2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3279 |
\&\-fdelayed-branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3280 |
\&\-fguess-branch-probability |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3281 |
\&\-fcprop-registers\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3282 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3283 |
\&\fB\-O\fR also turns on \fB\-fomit-frame-pointer\fR on machines |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3284 |
where doing so does not interfere with debugging. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3285 |
.Ip "\fB\-O2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3286 |
.IX Item "-O2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3287 |
Optimize even more. \s-1GCC\s0 performs nearly all supported optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3288 |
that do not involve a space-speed tradeoff. The compiler does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3289 |
perform loop unrolling or function inlining when you specify \fB\-O2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3290 |
As compared to \fB\-O\fR, this option increases both compilation time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3291 |
and the performance of the generated code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3292 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3293 |
\&\fB\-O2\fR turns on all optimization flags specified by \fB\-O\fR. It |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3294 |
also turns on the following optimization flags: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3295 |
\&\fB\-fforce-mem |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3296 |
\&\-foptimize-sibling-calls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3297 |
\&\-fstrength-reduce |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3298 |
\&\-fcse-follow-jumps \-fcse-skip-blocks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3299 |
\&\-frerun-cse-after-loop \-frerun-loop-opt |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3300 |
\&\-fgcse \-fgcse-lm \-fgcse-sm \-fgcse-las |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3301 |
\&\-fdelete-null-pointer-checks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3302 |
\&\-fexpensive-optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3303 |
\&\-fregmove |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3304 |
\&\-fschedule-insns \-fschedule-insns2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3305 |
\&\-fsched-interblock \-fsched-spec |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3306 |
\&\-fcaller-saves |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3307 |
\&\-fpeephole2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3308 |
\&\-freorder-blocks \-freorder-functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3309 |
\&\-fstrict-aliasing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3310 |
\&\-funit-at-a-time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3311 |
\&\-falign-functions \-falign-jumps |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3312 |
\&\-falign-loops \-falign-labels |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3313 |
\&\-fcrossjumping\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3314 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3315 |
Please note the warning under \fB\-fgcse\fR about |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3316 |
invoking \fB\-O2\fR on programs that use computed gotos. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3317 |
.Ip "\fB\-O3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3318 |
.IX Item "-O3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3319 |
Optimize yet more. \fB\-O3\fR turns on all optimizations specified by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3320 |
\&\fB\-O2\fR and also turns on the \fB\-finline-functions\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3321 |
\&\fB\-fweb\fR, \fB\-frename-registers\fR and \fB\-funswitch-loops\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3322 |
options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3323 |
.Ip "\fB\-O0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3324 |
.IX Item "-O0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3325 |
Do not optimize. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3326 |
.Ip "\fB\-Os\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3327 |
.IX Item "-Os" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3328 |
Optimize for size. \fB\-Os\fR enables all \fB\-O2\fR optimizations that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3329 |
do not typically increase code size. It also performs further |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3330 |
optimizations designed to reduce code size. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3331 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3332 |
\&\fB\-Os\fR disables the following optimization flags: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3333 |
\&\fB\-falign-functions \-falign-jumps \-falign-loops |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3334 |
\&\-falign-labels \-freorder-blocks \-fprefetch-loop-arrays\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3335 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3336 |
If you use multiple \fB\-O\fR options, with or without level numbers, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3337 |
the last such option is the one that is effective. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3338 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3339 |
Options of the form \fB\-f\fR\fIflag\fR specify machine-independent |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3340 |
flags. Most flags have both positive and negative forms; the negative |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3341 |
form of \fB\-ffoo\fR would be \fB\-fno-foo\fR. In the table |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3342 |
below, only one of the forms is listed\-\-\-the one you typically will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3343 |
use. You can figure out the other form by either removing \fBno-\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3344 |
or adding it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3345 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3346 |
The following options control specific optimizations. They are either |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3347 |
activated by \fB\-O\fR options or are related to ones that are. You |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3348 |
can use the following flags in the rare cases when ``fine-tuning'' of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3349 |
optimizations to be performed is desired. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3350 |
.Ip "\fB\-fno-default-inline\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3351 |
.IX Item "-fno-default-inline" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3352 |
Do not make member functions inline by default merely because they are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3353 |
defined inside the class scope (\*(C+ only). Otherwise, when you specify |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3354 |
\&\fB\-O\fR, member functions defined inside class scope are compiled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3355 |
inline by default; i.e., you don't need to add \fBinline\fR in front of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3356 |
the member function name. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3357 |
.Ip "\fB\-fno-defer-pop\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3358 |
.IX Item "-fno-defer-pop" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3359 |
Always pop the arguments to each function call as soon as that function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3360 |
returns. For machines which must pop arguments after a function call, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3361 |
the compiler normally lets arguments accumulate on the stack for several |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3362 |
function calls and pops them all at once. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3363 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3364 |
Disabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3365 |
.Ip "\fB\-fforce-mem\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3366 |
.IX Item "-fforce-mem" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3367 |
Force memory operands to be copied into registers before doing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3368 |
arithmetic on them. This produces better code by making all memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3369 |
references potential common subexpressions. When they are not common |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3370 |
subexpressions, instruction combination should eliminate the separate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3371 |
register-load. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3372 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3373 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3374 |
.Ip "\fB\-fforce-addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3375 |
.IX Item "-fforce-addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3376 |
Force memory address constants to be copied into registers before |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3377 |
doing arithmetic on them. This may produce better code just as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3378 |
\&\fB\-fforce-mem\fR may. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3379 |
.Ip "\fB\-fomit-frame-pointer\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3380 |
.IX Item "-fomit-frame-pointer" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3381 |
Don't keep the frame pointer in a register for functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3382 |
don't need one. This avoids the instructions to save, set up and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3383 |
restore frame pointers; it also makes an extra register available |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3384 |
in many functions. \fBIt also makes debugging impossible on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3385 |
some machines.\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3386 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3387 |
On some machines, such as the \s-1VAX\s0, this flag has no effect, because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3388 |
the standard calling sequence automatically handles the frame pointer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3389 |
and nothing is saved by pretending it doesn't exist. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3390 |
machine-description macro \f(CW\*(C`FRAME_POINTER_REQUIRED\*(C'\fR controls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3391 |
whether a target machine supports this flag. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3392 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3393 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3394 |
.Ip "\fB\-foptimize-sibling-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3395 |
.IX Item "-foptimize-sibling-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3396 |
Optimize sibling and tail recursive calls. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3397 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3398 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3399 |
.Ip "\fB\-fno-inline\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3400 |
.IX Item "-fno-inline" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3401 |
Don't pay attention to the \f(CW\*(C`inline\*(C'\fR keyword. Normally this option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3402 |
is used to keep the compiler from expanding any functions inline. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3403 |
Note that if you are not optimizing, no functions can be expanded inline. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3404 |
.Ip "\fB\-finline-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3405 |
.IX Item "-finline-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3406 |
Integrate all simple functions into their callers. The compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3407 |
heuristically decides which functions are simple enough to be worth |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3408 |
integrating in this way. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3409 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3410 |
If all calls to a given function are integrated, and the function is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3411 |
declared \f(CW\*(C`static\*(C'\fR, then the function is normally not output as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3412 |
assembler code in its own right. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3413 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3414 |
Enabled at level \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3415 |
.Ip "\fB\-finline-limit=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3416 |
.IX Item "-finline-limit=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3417 |
By default, \s-1GCC\s0 limits the size of functions that can be inlined. This flag |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3418 |
allows the control of this limit for functions that are explicitly marked as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3419 |
inline (i.e., marked with the inline keyword or defined within the class |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3420 |
definition in c++). \fIn\fR is the size of functions that can be inlined in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3421 |
number of pseudo instructions (not counting parameter handling). The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3422 |
value of \fIn\fR is 600. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3423 |
Increasing this value can result in more inlined code at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3424 |
the cost of compilation time and memory consumption. Decreasing usually makes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3425 |
the compilation faster and less code will be inlined (which presumably |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3426 |
means slower programs). This option is particularly useful for programs that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3427 |
use inlining heavily such as those based on recursive templates with \*(C+. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3428 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3429 |
Inlining is actually controlled by a number of parameters, which may be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3430 |
specified individually by using \fB\*(--param\fR \fIname\fR\fB=\fR\fIvalue\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3431 |
The \fB\-finline-limit=\fR\fIn\fR option sets some of these parameters |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3432 |
as follows: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3433 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3434 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3435 |
.Vb 8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3436 |
\& @item max-inline-insns-single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3437 |
\& is set to I<n>/2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3438 |
\& @item max-inline-insns-auto |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3439 |
\& is set to I<n>/2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3440 |
\& @item min-inline-insns |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3441 |
\& is set to 130 or I<n>/4, whichever is smaller. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3442 |
\& @item max-inline-insns-rtl |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3443 |
\& is set to I<n>. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3444 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3445 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3446 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3447 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3448 |
See below for a documentation of the individual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3449 |
parameters controlling inlining. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3450 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3451 |
\&\fINote:\fR pseudo instruction represents, in this particular context, an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3452 |
abstract measurement of function's size. In no way, it represents a count |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3453 |
of assembly instructions and as such its exact meaning might change from one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3454 |
release to an another. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3455 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3456 |
.Ip "\fB\-fkeep-inline-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3457 |
.IX Item "-fkeep-inline-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3458 |
Even if all calls to a given function are integrated, and the function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3459 |
is declared \f(CW\*(C`static\*(C'\fR, nevertheless output a separate run-time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3460 |
callable version of the function. This switch does not affect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3461 |
\&\f(CW\*(C`extern inline\*(C'\fR functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3462 |
.Ip "\fB\-fkeep-static-consts\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3463 |
.IX Item "-fkeep-static-consts" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3464 |
Emit variables declared \f(CW\*(C`static const\*(C'\fR when optimization isn't turned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3465 |
on, even if the variables aren't referenced. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3466 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3467 |
\&\s-1GCC\s0 enables this option by default. If you want to force the compiler to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3468 |
check if the variable was referenced, regardless of whether or not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3469 |
optimization is turned on, use the \fB\-fno-keep-static-consts\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3470 |
.Ip "\fB\-fmerge-constants\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3471 |
.IX Item "-fmerge-constants" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3472 |
Attempt to merge identical constants (string constants and floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3473 |
constants) across compilation units. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3474 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3475 |
This option is the default for optimized compilation if the assembler and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3476 |
linker support it. Use \fB\-fno-merge-constants\fR to inhibit this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3477 |
behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3478 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3479 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3480 |
.Ip "\fB\-fmerge-all-constants\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3481 |
.IX Item "-fmerge-all-constants" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3482 |
Attempt to merge identical constants and identical variables. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3483 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3484 |
This option implies \fB\-fmerge-constants\fR. In addition to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3485 |
\&\fB\-fmerge-constants\fR this considers e.g. even constant initialized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3486 |
arrays or initialized constant variables with integral or floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3487 |
types. Languages like C or \*(C+ require each non-automatic variable to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3488 |
have distinct location, so using this option will result in non-conforming |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3489 |
behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3490 |
.Ip "\fB\-fnew-ra\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3491 |
.IX Item "-fnew-ra" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3492 |
Use a graph coloring register allocator. Currently this option is meant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3493 |
only for testing. Users should not specify this option, since it is not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3494 |
yet ready for production use. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3495 |
.Ip "\fB\-fno-branch-count-reg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3496 |
.IX Item "-fno-branch-count-reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3497 |
Do not use ``decrement and branch'' instructions on a count register, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3498 |
but instead generate a sequence of instructions that decrement a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3499 |
register, compare it against zero, then branch based upon the result. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3500 |
This option is only meaningful on architectures that support such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3501 |
instructions, which include x86, PowerPC, \s-1IA-64\s0 and S/390. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3502 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3503 |
The default is \fB\-fbranch-count-reg\fR, enabled when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3504 |
\&\fB\-fstrength-reduce\fR is enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3505 |
.Ip "\fB\-fno-function-cse\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3506 |
.IX Item "-fno-function-cse" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3507 |
Do not put function addresses in registers; make each instruction that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3508 |
calls a constant function contain the function's address explicitly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3509 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3510 |
This option results in less efficient code, but some strange hacks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3511 |
that alter the assembler output may be confused by the optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3512 |
performed when this option is not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3513 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3514 |
The default is \fB\-ffunction-cse\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3515 |
.Ip "\fB\-fno-zero-initialized-in-bss\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3516 |
.IX Item "-fno-zero-initialized-in-bss" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3517 |
If the target supports a \s-1BSS\s0 section, \s-1GCC\s0 by default puts variables that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3518 |
are initialized to zero into \s-1BSS\s0. This can save space in the resulting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3519 |
code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3520 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3521 |
This option turns off this behavior because some programs explicitly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3522 |
rely on variables going to the data section. E.g., so that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3523 |
resulting executable can find the beginning of that section and/or make |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3524 |
assumptions based on that. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3525 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3526 |
The default is \fB\-fzero-initialized-in-bss\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3527 |
.Ip "\fB\-fstrength-reduce\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3528 |
.IX Item "-fstrength-reduce" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3529 |
Perform the optimizations of loop strength reduction and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3530 |
elimination of iteration variables. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3531 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3532 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3533 |
.Ip "\fB\-fthread-jumps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3534 |
.IX Item "-fthread-jumps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3535 |
Perform optimizations where we check to see if a jump branches to a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3536 |
location where another comparison subsumed by the first is found. If |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3537 |
so, the first branch is redirected to either the destination of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3538 |
second branch or a point immediately following it, depending on whether |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3539 |
the condition is known to be true or false. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3540 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3541 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3542 |
.Ip "\fB\-fcse-follow-jumps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3543 |
.IX Item "-fcse-follow-jumps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3544 |
In common subexpression elimination, scan through jump instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3545 |
when the target of the jump is not reached by any other path. For |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3546 |
example, when \s-1CSE\s0 encounters an \f(CW\*(C`if\*(C'\fR statement with an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3547 |
\&\f(CW\*(C`else\*(C'\fR clause, \s-1CSE\s0 will follow the jump when the condition |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3548 |
tested is false. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3549 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3550 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3551 |
.Ip "\fB\-fcse-skip-blocks\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3552 |
.IX Item "-fcse-skip-blocks" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3553 |
This is similar to \fB\-fcse-follow-jumps\fR, but causes \s-1CSE\s0 to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3554 |
follow jumps which conditionally skip over blocks. When \s-1CSE\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3555 |
encounters a simple \f(CW\*(C`if\*(C'\fR statement with no else clause, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3556 |
\&\fB\-fcse-skip-blocks\fR causes \s-1CSE\s0 to follow the jump around the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3557 |
body of the \f(CW\*(C`if\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3558 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3559 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3560 |
.Ip "\fB\-frerun-cse-after-loop\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3561 |
.IX Item "-frerun-cse-after-loop" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3562 |
Re-run common subexpression elimination after loop optimizations has been |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3563 |
performed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3564 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3565 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3566 |
.Ip "\fB\-frerun-loop-opt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3567 |
.IX Item "-frerun-loop-opt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3568 |
Run the loop optimizer twice. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3569 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3570 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3571 |
.Ip "\fB\-fgcse\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3572 |
.IX Item "-fgcse" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3573 |
Perform a global common subexpression elimination pass. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3574 |
This pass also performs global constant and copy propagation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3575 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3576 |
\&\fINote:\fR When compiling a program using computed gotos, a \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3577 |
extension, you may get better runtime performance if you disable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3578 |
the global common subexpression elimination pass by adding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3579 |
\&\fB\-fno-gcse\fR to the command line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3580 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3581 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3582 |
.Ip "\fB\-fgcse-lm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3583 |
.IX Item "-fgcse-lm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3584 |
When \fB\-fgcse-lm\fR is enabled, global common subexpression elimination will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3585 |
attempt to move loads which are only killed by stores into themselves. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3586 |
allows a loop containing a load/store sequence to be changed to a load outside |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3587 |
the loop, and a copy/store within the loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3588 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3589 |
Enabled by default when gcse is enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3590 |
.Ip "\fB\-fgcse-sm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3591 |
.IX Item "-fgcse-sm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3592 |
When \fB\-fgcse-sm\fR is enabled, a store motion pass is run after |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3593 |
global common subexpression elimination. This pass will attempt to move |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3594 |
stores out of loops. When used in conjunction with \fB\-fgcse-lm\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3595 |
loops containing a load/store sequence can be changed to a load before |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3596 |
the loop and a store after the loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3597 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3598 |
Enabled by default when gcse is enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3599 |
.Ip "\fB\-fgcse-las\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3600 |
.IX Item "-fgcse-las" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3601 |
When \fB\-fgcse-las\fR is enabled, the global common subexpression |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3602 |
elimination pass eliminates redundant loads that come after stores to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3603 |
same memory location (both partial and full redundancies). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3604 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3605 |
Enabled by default when gcse is enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3606 |
.Ip "\fB\-floop-optimize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3607 |
.IX Item "-floop-optimize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3608 |
Perform loop optimizations: move constant expressions out of loops, simplify |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3609 |
exit test conditions and optionally do strength-reduction and loop unrolling as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3610 |
well. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3611 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3612 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3613 |
.Ip "\fB\-fcrossjumping\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3614 |
.IX Item "-fcrossjumping" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3615 |
Perform cross-jumping transformation. This transformation unifies equivalent code and save code size. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3616 |
resulting code may or may not perform better than without cross-jumping. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3617 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3618 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3619 |
.Ip "\fB\-fif-conversion\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3620 |
.IX Item "-fif-conversion" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3621 |
Attempt to transform conditional jumps into branch-less equivalents. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3622 |
include use of conditional moves, min, max, set flags and abs instructions, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3623 |
some tricks doable by standard arithmetics. The use of conditional execution |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3624 |
on chips where it is available is controlled by \f(CW\*(C`if\-conversion2\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3625 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3626 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3627 |
.Ip "\fB\-fif-conversion2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3628 |
.IX Item "-fif-conversion2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3629 |
Use conditional execution (where available) to transform conditional jumps into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3630 |
branch-less equivalents. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3631 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3632 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3633 |
.Ip "\fB\-fdelete-null-pointer-checks\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3634 |
.IX Item "-fdelete-null-pointer-checks" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3635 |
Use global dataflow analysis to identify and eliminate useless checks |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3636 |
for null pointers. The compiler assumes that dereferencing a null |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3637 |
pointer would have halted the program. If a pointer is checked after |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3638 |
it has already been dereferenced, it cannot be null. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3639 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3640 |
In some environments, this assumption is not true, and programs can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3641 |
safely dereference null pointers. Use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3642 |
\&\fB\-fno-delete-null-pointer-checks\fR to disable this optimization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3643 |
for programs which depend on that behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3644 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3645 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3646 |
.Ip "\fB\-fexpensive-optimizations\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3647 |
.IX Item "-fexpensive-optimizations" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3648 |
Perform a number of minor optimizations that are relatively expensive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3649 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3650 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3651 |
.Ip "\fB\-foptimize-register-move\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3652 |
.IX Item "-foptimize-register-move" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3653 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3654 |
.Ip "\fB\-fregmove\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3655 |
.IX Item "-fregmove" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3656 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3657 |
Attempt to reassign register numbers in move instructions and as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3658 |
operands of other simple instructions in order to maximize the amount of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3659 |
register tying. This is especially helpful on machines with two-operand |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3660 |
instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3661 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3662 |
Note \fB\-fregmove\fR and \fB\-foptimize-register-move\fR are the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3663 |
optimization. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3664 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3665 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3666 |
.Ip "\fB\-fdelayed-branch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3667 |
.IX Item "-fdelayed-branch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3668 |
If supported for the target machine, attempt to reorder instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3669 |
to exploit instruction slots available after delayed branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3670 |
instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3671 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3672 |
Enabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3673 |
.Ip "\fB\-fschedule-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3674 |
.IX Item "-fschedule-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3675 |
If supported for the target machine, attempt to reorder instructions to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3676 |
eliminate execution stalls due to required data being unavailable. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3677 |
helps machines that have slow floating point or memory load instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3678 |
by allowing other instructions to be issued until the result of the load |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3679 |
or floating point instruction is required. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3680 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3681 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3682 |
.Ip "\fB\-fschedule-insns2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3683 |
.IX Item "-fschedule-insns2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3684 |
Similar to \fB\-fschedule-insns\fR, but requests an additional pass of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3685 |
instruction scheduling after register allocation has been done. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3686 |
especially useful on machines with a relatively small number of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3687 |
registers and where memory load instructions take more than one cycle. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3688 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3689 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3690 |
.Ip "\fB\-fno-sched-interblock\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3691 |
.IX Item "-fno-sched-interblock" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3692 |
Don't schedule instructions across basic blocks. This is normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3693 |
enabled by default when scheduling before register allocation, i.e. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3694 |
with \fB\-fschedule-insns\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3695 |
.Ip "\fB\-fno-sched-spec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3696 |
.IX Item "-fno-sched-spec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3697 |
Don't allow speculative motion of non-load instructions. This is normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3698 |
enabled by default when scheduling before register allocation, i.e. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3699 |
with \fB\-fschedule-insns\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3700 |
.Ip "\fB\-fsched-spec-load\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3701 |
.IX Item "-fsched-spec-load" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3702 |
Allow speculative motion of some load instructions. This only makes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3703 |
sense when scheduling before register allocation, i.e. with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3704 |
\&\fB\-fschedule-insns\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3705 |
.Ip "\fB\-fsched-spec-load-dangerous\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3706 |
.IX Item "-fsched-spec-load-dangerous" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3707 |
Allow speculative motion of more load instructions. This only makes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3708 |
sense when scheduling before register allocation, i.e. with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3709 |
\&\fB\-fschedule-insns\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3710 |
.Ip "\fB\-fsched-stalled-insns=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3711 |
.IX Item "-fsched-stalled-insns=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3712 |
Define how many insns (if any) can be moved prematurely from the queue |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3713 |
of stalled insns into the ready list, during the second scheduling pass. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3714 |
.Ip "\fB\-fsched-stalled-insns-dep=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3715 |
.IX Item "-fsched-stalled-insns-dep=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3716 |
Define how many insn groups (cycles) will be examined for a dependency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3717 |
on a stalled insn that is candidate for premature removal from the queue |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3718 |
of stalled insns. Has an effect only during the second scheduling pass, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3719 |
and only if \fB\-fsched-stalled-insns\fR is used and its value is not zero. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3720 |
.Ip "\fB\-fsched2\-use-superblocks\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3721 |
.IX Item "-fsched2-use-superblocks" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3722 |
When scheduling after register allocation, do use superblock scheduling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3723 |
algorithm. Superblock scheduling allows motion across basic block boundaries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3724 |
resulting on faster schedules. This option is experimental, as not all machine |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3725 |
descriptions used by \s-1GCC\s0 model the \s-1CPU\s0 closely enough to avoid unreliable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3726 |
results from the algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3727 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3728 |
This only makes sense when scheduling after register allocation, i.e. with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3729 |
\&\fB\-fschedule-insns2\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3730 |
.Ip "\fB\-fsched2\-use-traces\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3731 |
.IX Item "-fsched2-use-traces" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3732 |
Use \fB\-fsched2\-use-superblocks\fR algorithm when scheduling after register |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3733 |
allocation and additionally perform code duplication in order to increase the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3734 |
size of superblocks using tracer pass. See \fB\-ftracer\fR for details on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3735 |
trace formation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3736 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3737 |
This mode should produce faster but significantly longer programs. Also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3738 |
without \f(CW\*(C`\-fbranch\-probabilities\*(C'\fR the traces constructed may not match the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3739 |
reality and hurt the performance. This only makes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3740 |
sense when scheduling after register allocation, i.e. with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3741 |
\&\fB\-fschedule-insns2\fR or at \fB\-O2\fR or higher. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3742 |
.Ip "\fB\-fcaller-saves\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3743 |
.IX Item "-fcaller-saves" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3744 |
Enable values to be allocated in registers that will be clobbered by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3745 |
function calls, by emitting extra instructions to save and restore the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3746 |
registers around such calls. Such allocation is done only when it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3747 |
seems to result in better code than would otherwise be produced. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3748 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3749 |
This option is always enabled by default on certain machines, usually |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3750 |
those which have no call-preserved registers to use instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3751 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3752 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3753 |
.Ip "\fB\-fmove-all-movables\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3754 |
.IX Item "-fmove-all-movables" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3755 |
Forces all invariant computations in loops to be moved |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3756 |
outside the loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3757 |
.Ip "\fB\-freduce-all-givs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3758 |
.IX Item "-freduce-all-givs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3759 |
Forces all general-induction variables in loops to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3760 |
strength-reduced. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3761 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3762 |
\&\fINote:\fR When compiling programs written in Fortran, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3763 |
\&\fB\-fmove-all-movables\fR and \fB\-freduce-all-givs\fR are enabled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3764 |
by default when you use the optimizer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3765 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3766 |
These options may generate better or worse code; results are highly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3767 |
dependent on the structure of loops within the source code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3768 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3769 |
These two options are intended to be removed someday, once |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3770 |
they have helped determine the efficacy of various |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3771 |
approaches to improving loop optimizations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3772 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3773 |
Please contact <\fBgcc@gcc.gnu.org\fR>, and describe how use of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3774 |
these options affects the performance of your production code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3775 |
Examples of code that runs \fIslower\fR when these options are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3776 |
\&\fIenabled\fR are very valuable. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3777 |
.Ip "\fB\-fno-peephole\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3778 |
.IX Item "-fno-peephole" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3779 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3780 |
.Ip "\fB\-fno-peephole2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3781 |
.IX Item "-fno-peephole2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3782 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3783 |
Disable any machine-specific peephole optimizations. The difference |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3784 |
between \fB\-fno-peephole\fR and \fB\-fno-peephole2\fR is in how they |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3785 |
are implemented in the compiler; some targets use one, some use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3786 |
other, a few use both. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3787 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3788 |
\&\fB\-fpeephole\fR is enabled by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3789 |
\&\fB\-fpeephole2\fR enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3790 |
.Ip "\fB\-fno-guess-branch-probability\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3791 |
.IX Item "-fno-guess-branch-probability" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3792 |
Do not guess branch probabilities using a randomized model. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3793 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3794 |
Sometimes \s-1GCC\s0 will opt to use a randomized model to guess branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3795 |
probabilities, when none are available from either profiling feedback |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3796 |
(\fB\-fprofile-arcs\fR) or \fB_\|_builtin_expect\fR. This means that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3797 |
different runs of the compiler on the same program may produce different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3798 |
object code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3799 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3800 |
In a hard real-time system, people don't want different runs of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3801 |
compiler to produce code that has different behavior; minimizing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3802 |
non-determinism is of paramount import. This switch allows users to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3803 |
reduce non-determinism, possibly at the expense of inferior |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3804 |
optimization. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3805 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3806 |
The default is \fB\-fguess-branch-probability\fR at levels |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3807 |
\&\fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3808 |
.Ip "\fB\-freorder-blocks\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3809 |
.IX Item "-freorder-blocks" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3810 |
Reorder basic blocks in the compiled function in order to reduce number of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3811 |
taken branches and improve code locality. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3812 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3813 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3814 |
.Ip "\fB\-freorder-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3815 |
.IX Item "-freorder-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3816 |
Reorder basic blocks in the compiled function in order to reduce number of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3817 |
taken branches and improve code locality. This is implemented by using special |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3818 |
subsections \f(CW\*(C`.text.hot\*(C'\fR for most frequently executed functions and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3819 |
\&\f(CW\*(C`.text.unlikely\*(C'\fR for unlikely executed functions. Reordering is done by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3820 |
the linker so object file format must support named sections and linker must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3821 |
place them in a reasonable way. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3822 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3823 |
Also profile feedback must be available in to make this option effective. See |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3824 |
\&\fB\-fprofile-arcs\fR for details. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3825 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3826 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3827 |
.Ip "\fB\-fstrict-aliasing\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3828 |
.IX Item "-fstrict-aliasing" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3829 |
Allows the compiler to assume the strictest aliasing rules applicable to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3830 |
the language being compiled. For C (and \*(C+), this activates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3831 |
optimizations based on the type of expressions. In particular, an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3832 |
object of one type is assumed never to reside at the same address as an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3833 |
object of a different type, unless the types are almost the same. For |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3834 |
example, an \f(CW\*(C`unsigned int\*(C'\fR can alias an \f(CW\*(C`int\*(C'\fR, but not a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3835 |
\&\f(CW\*(C`void*\*(C'\fR or a \f(CW\*(C`double\*(C'\fR. A character type may alias any other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3836 |
type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3837 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3838 |
Pay special attention to code like this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3839 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3840 |
.Vb 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3841 |
\& union a_union { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3842 |
\& int i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3843 |
\& double d; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3844 |
\& }; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3845 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3846 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3847 |
\& int f() { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3848 |
\& a_union t; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3849 |
\& t.d = 3.0; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3850 |
\& return t.i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3851 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3852 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3853 |
The practice of reading from a different union member than the one most |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3854 |
recently written to (called ``type-punning'') is common. Even with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3855 |
\&\fB\-fstrict-aliasing\fR, type-punning is allowed, provided the memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3856 |
is accessed through the union type. So, the code above will work as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3857 |
expected. However, this code might not: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3858 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3859 |
.Vb 7 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3860 |
\& int f() { |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3861 |
\& a_union t; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3862 |
\& int* ip; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3863 |
\& t.d = 3.0; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3864 |
\& ip = &t.i; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3865 |
\& return *ip; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3866 |
\& } |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3867 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3868 |
Every language that wishes to perform language-specific alias analysis |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3869 |
should define a function that computes, given an \f(CW\*(C`tree\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3870 |
node, an alias set for the node. Nodes in different alias sets are not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3871 |
allowed to alias. For an example, see the C front-end function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3872 |
\&\f(CW\*(C`c_get_alias_set\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3873 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3874 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3875 |
.Ip "\fB\-falign-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3876 |
.IX Item "-falign-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3877 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3878 |
.Ip "\fB\-falign-functions=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3879 |
.IX Item "-falign-functions=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3880 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3881 |
Align the start of functions to the next power-of-two greater than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3882 |
\&\fIn\fR, skipping up to \fIn\fR bytes. For instance, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3883 |
\&\fB\-falign-functions=32\fR aligns functions to the next 32\-byte |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3884 |
boundary, but \fB\-falign-functions=24\fR would align to the next |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3885 |
32\-byte boundary only if this can be done by skipping 23 bytes or less. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3886 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3887 |
\&\fB\-fno-align-functions\fR and \fB\-falign-functions=1\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3888 |
equivalent and mean that functions will not be aligned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3889 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3890 |
Some assemblers only support this flag when \fIn\fR is a power of two; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3891 |
in that case, it is rounded up. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3892 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3893 |
If \fIn\fR is not specified or is zero, use a machine-dependent default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3894 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3895 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3896 |
.Ip "\fB\-falign-labels\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3897 |
.IX Item "-falign-labels" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3898 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3899 |
.Ip "\fB\-falign-labels=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3900 |
.IX Item "-falign-labels=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3901 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3902 |
Align all branch targets to a power-of-two boundary, skipping up to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3903 |
\&\fIn\fR bytes like \fB\-falign-functions\fR. This option can easily |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3904 |
make code slower, because it must insert dummy operations for when the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3905 |
branch target is reached in the usual flow of the code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3906 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3907 |
\&\fB\-fno-align-labels\fR and \fB\-falign-labels=1\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3908 |
equivalent and mean that labels will not be aligned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3909 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3910 |
If \fB\-falign-loops\fR or \fB\-falign-jumps\fR are applicable and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3911 |
are greater than this value, then their values are used instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3912 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3913 |
If \fIn\fR is not specified or is zero, use a machine-dependent default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3914 |
which is very likely to be \fB1\fR, meaning no alignment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3915 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3916 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3917 |
.Ip "\fB\-falign-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3918 |
.IX Item "-falign-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3919 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3920 |
.Ip "\fB\-falign-loops=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3921 |
.IX Item "-falign-loops=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3922 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3923 |
Align loops to a power-of-two boundary, skipping up to \fIn\fR bytes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3924 |
like \fB\-falign-functions\fR. The hope is that the loop will be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3925 |
executed many times, which will make up for any execution of the dummy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3926 |
operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3927 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3928 |
\&\fB\-fno-align-loops\fR and \fB\-falign-loops=1\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3929 |
equivalent and mean that loops will not be aligned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3930 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3931 |
If \fIn\fR is not specified or is zero, use a machine-dependent default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3932 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3933 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3934 |
.Ip "\fB\-falign-jumps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3935 |
.IX Item "-falign-jumps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3936 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3937 |
.Ip "\fB\-falign-jumps=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3938 |
.IX Item "-falign-jumps=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3939 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3940 |
Align branch targets to a power-of-two boundary, for branch targets |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3941 |
where the targets can only be reached by jumping, skipping up to \fIn\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3942 |
bytes like \fB\-falign-functions\fR. In this case, no dummy operations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3943 |
need be executed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3944 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3945 |
\&\fB\-fno-align-jumps\fR and \fB\-falign-jumps=1\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3946 |
equivalent and mean that loops will not be aligned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3947 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3948 |
If \fIn\fR is not specified or is zero, use a machine-dependent default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3949 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3950 |
Enabled at levels \fB\-O2\fR, \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3951 |
.Ip "\fB\-frename-registers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3952 |
.IX Item "-frename-registers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3953 |
Attempt to avoid false dependencies in scheduled code by making use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3954 |
of registers left over after register allocation. This optimization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3955 |
will most benefit processors with lots of registers. It can, however, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3956 |
make debugging impossible, since variables will no longer stay in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3957 |
a ``home register''. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3958 |
.Ip "\fB\-fweb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3959 |
.IX Item "-fweb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3960 |
Constructs webs as commonly used for register allocation purposes and assign |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3961 |
each web individual pseudo register. This allows the register allocation pass |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3962 |
to operate on pseudos directly, but also strengthens several other optimization |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3963 |
passes, such as \s-1CSE\s0, loop optimizer and trivial dead code remover. It can, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3964 |
however, make debugging impossible, since variables will no longer stay in a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3965 |
``home register''. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3966 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3967 |
Enabled at levels \fB\-O3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3968 |
.Ip "\fB\-fno-cprop-registers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3969 |
.IX Item "-fno-cprop-registers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3970 |
After register allocation and post-register allocation instruction splitting, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3971 |
we perform a copy-propagation pass to try to reduce scheduling dependencies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3972 |
and occasionally eliminate the copy. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3973 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3974 |
Disabled at levels \fB\-O\fR, \fB\-O2\fR, \fB\-O3\fR, \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3975 |
.Ip "\fB\-fprofile-generate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3976 |
.IX Item "-fprofile-generate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3977 |
Enable options usually used for instrumenting application to produce |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3978 |
profile useful for later recompilation with profile feedback based |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3979 |
optimization. You must use \f(CW\*(C`\-fprofile\-generate\*(C'\fR both when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3980 |
compiling and when linking your program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3981 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3982 |
The following options are enabled: \f(CW\*(C`\-fprofile\-arcs\*(C'\fR, \f(CW\*(C`\-fprofile\-values\*(C'\fR, \f(CW\*(C`\-fvpt\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3983 |
.Ip "\fB\-fprofile-use\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3984 |
.IX Item "-fprofile-use" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3985 |
Enable profile feedback directed optimizations, and optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3986 |
generally profitable only with profile feedback available. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3987 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3988 |
The following options are enabled: \f(CW\*(C`\-fbranch\-probabilities\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3989 |
\&\f(CW\*(C`\-fvpt\*(C'\fR, \f(CW\*(C`\-funroll\-loops\*(C'\fR, \f(CW\*(C`\-fpeel\-loops\*(C'\fR, \f(CW\*(C`\-ftracer\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3990 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3991 |
The following options control compiler behavior regarding floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3992 |
point arithmetic. These options trade off between speed and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3993 |
correctness. All must be specifically enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3994 |
.Ip "\fB\-ffloat-store\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3995 |
.IX Item "-ffloat-store" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3996 |
Do not store floating point variables in registers, and inhibit other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3997 |
options that might change whether a floating point value is taken from a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3998 |
register or memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
3999 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4000 |
This option prevents undesirable excess precision on machines such as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4001 |
the 68000 where the floating registers (of the 68881) keep more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4002 |
precision than a \f(CW\*(C`double\*(C'\fR is supposed to have. Similarly for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4003 |
x86 architecture. For most programs, the excess precision does only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4004 |
good, but a few programs rely on the precise definition of \s-1IEEE\s0 floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4005 |
point. Use \fB\-ffloat-store\fR for such programs, after modifying |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4006 |
them to store all pertinent intermediate computations into variables. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4007 |
.Ip "\fB\-ffast-math\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4008 |
.IX Item "-ffast-math" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4009 |
Sets \fB\-fno-math-errno\fR, \fB\-funsafe-math-optimizations\fR, \fB\-fno-trapping-math\fR, \fB\-ffinite-math-only\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4010 |
\&\fB\-fno-rounding-math\fR and \fB\-fno-signaling-nans\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4011 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4012 |
This option causes the preprocessor macro \f(CW\*(C`_\|_FAST_MATH_\|_\*(C'\fR to be defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4013 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4014 |
This option should never be turned on by any \fB\-O\fR option since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4015 |
it can result in incorrect output for programs which depend on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4016 |
an exact implementation of \s-1IEEE\s0 or \s-1ISO\s0 rules/specifications for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4017 |
math functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4018 |
.Ip "\fB\-fno-math-errno\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4019 |
.IX Item "-fno-math-errno" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4020 |
Do not set \s-1ERRNO\s0 after calling math functions that are executed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4021 |
with a single instruction, e.g., sqrt. A program that relies on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4022 |
\&\s-1IEEE\s0 exceptions for math error handling may want to use this flag |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4023 |
for speed while maintaining \s-1IEEE\s0 arithmetic compatibility. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4024 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4025 |
This option should never be turned on by any \fB\-O\fR option since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4026 |
it can result in incorrect output for programs which depend on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4027 |
an exact implementation of \s-1IEEE\s0 or \s-1ISO\s0 rules/specifications for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4028 |
math functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4029 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4030 |
The default is \fB\-fmath-errno\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4031 |
.Ip "\fB\-funsafe-math-optimizations\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4032 |
.IX Item "-funsafe-math-optimizations" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4033 |
Allow optimizations for floating-point arithmetic that (a) assume |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4034 |
that arguments and results are valid and (b) may violate \s-1IEEE\s0 or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4035 |
\&\s-1ANSI\s0 standards. When used at link-time, it may include libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4036 |
or startup files that change the default \s-1FPU\s0 control word or other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4037 |
similar optimizations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4038 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4039 |
This option should never be turned on by any \fB\-O\fR option since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4040 |
it can result in incorrect output for programs which depend on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4041 |
an exact implementation of \s-1IEEE\s0 or \s-1ISO\s0 rules/specifications for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4042 |
math functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4043 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4044 |
The default is \fB\-fno-unsafe-math-optimizations\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4045 |
.Ip "\fB\-ffinite-math-only\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4046 |
.IX Item "-ffinite-math-only" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4047 |
Allow optimizations for floating-point arithmetic that assume |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4048 |
that arguments and results are not NaNs or +\-Infs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4049 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4050 |
This option should never be turned on by any \fB\-O\fR option since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4051 |
it can result in incorrect output for programs which depend on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4052 |
an exact implementation of \s-1IEEE\s0 or \s-1ISO\s0 rules/specifications. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4053 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4054 |
The default is \fB\-fno-finite-math-only\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4055 |
.Ip "\fB\-fno-trapping-math\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4056 |
.IX Item "-fno-trapping-math" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4057 |
Compile code assuming that floating-point operations cannot generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4058 |
user-visible traps. These traps include division by zero, overflow, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4059 |
underflow, inexact result and invalid operation. This option implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4060 |
\&\fB\-fno-signaling-nans\fR. Setting this option may allow faster |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4061 |
code if one relies on ``non-stop'' \s-1IEEE\s0 arithmetic, for example. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4062 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4063 |
This option should never be turned on by any \fB\-O\fR option since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4064 |
it can result in incorrect output for programs which depend on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4065 |
an exact implementation of \s-1IEEE\s0 or \s-1ISO\s0 rules/specifications for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4066 |
math functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4067 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4068 |
The default is \fB\-ftrapping-math\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4069 |
.Ip "\fB\-frounding-math\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4070 |
.IX Item "-frounding-math" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4071 |
Disable transformations and optimizations that assume default floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4072 |
point rounding behavior. This is round-to-zero for all floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4073 |
to integer conversions, and round-to-nearest for all other arithmetic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4074 |
truncations. This option should be specified for programs that change |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4075 |
the \s-1FP\s0 rounding mode dynamically, or that may be executed with a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4076 |
non-default rounding mode. This option disables constant folding of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4077 |
floating point expressions at compile-time (which may be affected by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4078 |
rounding mode) and arithmetic transformations that are unsafe in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4079 |
presence of sign-dependent rounding modes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4080 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4081 |
The default is \fB\-fno-rounding-math\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4082 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4083 |
This option is experimental and does not currently guarantee to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4084 |
disable all \s-1GCC\s0 optimizations that are affected by rounding mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4085 |
Future versions of \s-1GCC\s0 may provide finer control of this setting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4086 |
using C99's \f(CW\*(C`FENV_ACCESS\*(C'\fR pragma. This command line option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4087 |
will be used to specify the default state for \f(CW\*(C`FENV_ACCESS\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4088 |
.Ip "\fB\-fsignaling-nans\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4089 |
.IX Item "-fsignaling-nans" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4090 |
Compile code assuming that \s-1IEEE\s0 signaling NaNs may generate user-visible |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4091 |
traps during floating-point operations. Setting this option disables |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4092 |
optimizations that may change the number of exceptions visible with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4093 |
signaling NaNs. This option implies \fB\-ftrapping-math\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4094 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4095 |
This option causes the preprocessor macro \f(CW\*(C`_\|_SUPPORT_SNAN_\|_\*(C'\fR to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4096 |
be defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4097 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4098 |
The default is \fB\-fno-signaling-nans\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4099 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4100 |
This option is experimental and does not currently guarantee to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4101 |
disable all \s-1GCC\s0 optimizations that affect signaling NaN behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4102 |
.Ip "\fB\-fsingle-precision-constant\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4103 |
.IX Item "-fsingle-precision-constant" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4104 |
Treat floating point constant as single precision constant instead of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4105 |
implicitly converting it to double precision constant. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4106 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4107 |
The following options control optimizations that may improve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4108 |
performance, but are not enabled by any \fB\-O\fR options. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4109 |
section includes experimental options that may produce broken code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4110 |
.Ip "\fB\-fbranch-probabilities\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4111 |
.IX Item "-fbranch-probabilities" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4112 |
After running a program compiled with \fB\-fprofile-arcs\fR, you can compile it a second time using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4113 |
\&\fB\-fbranch-probabilities\fR, to improve optimizations based on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4114 |
the number of times each branch was taken. When the program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4115 |
compiled with \fB\-fprofile-arcs\fR exits it saves arc execution |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4116 |
counts to a file called \fI\fIsourcename\fI.gcda\fR for each source |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4117 |
file The information in this data file is very dependent on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4118 |
structure of the generated code, so you must use the same source code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4119 |
and the same optimization options for both compilations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4120 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4121 |
With \fB\-fbranch-probabilities\fR, \s-1GCC\s0 puts a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4122 |
\&\fB\s-1REG_BR_PROB\s0\fR note on each \fB\s-1JUMP_INSN\s0\fR and \fB\s-1CALL_INSN\s0\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4123 |
These can be used to improve optimization. Currently, they are only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4124 |
used in one place: in \fIreorg.c\fR, instead of guessing which path a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4125 |
branch is mostly to take, the \fB\s-1REG_BR_PROB\s0\fR values are used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4126 |
exactly determine which path is taken more often. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4127 |
.Ip "\fB\-fprofile-values\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4128 |
.IX Item "-fprofile-values" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4129 |
If combined with \fB\-fprofile-arcs\fR, it adds code so that some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4130 |
data about values of expressions in the program is gathered. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4131 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4132 |
With \fB\-fbranch-probabilities\fR, it reads back the data gathered |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4133 |
from profiling values of expressions and adds \fB\s-1REG_VALUE_PROFILE\s0\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4134 |
notes to instructions for their later usage in optimizations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4135 |
.Ip "\fB\-fvpt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4136 |
.IX Item "-fvpt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4137 |
If combined with \fB\-fprofile-arcs\fR, it instructs the compiler to add |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4138 |
a code to gather information about values of expressions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4139 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4140 |
With \fB\-fbranch-probabilities\fR, it reads back the data gathered |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4141 |
and actually performs the optimizations based on them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4142 |
Currently the optimizations include specialization of division operation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4143 |
using the knowledge about the value of the denominator. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4144 |
.Ip "\fB\-fnew-ra\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4145 |
.IX Item "-fnew-ra" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4146 |
Use a graph coloring register allocator. Currently this option is meant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4147 |
for testing, so we are interested to hear about miscompilations with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4148 |
\&\fB\-fnew-ra\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4149 |
.Ip "\fB\-ftracer\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4150 |
.IX Item "-ftracer" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4151 |
Perform tail duplication to enlarge superblock size. This transformation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4152 |
simplifies the control flow of the function allowing other optimizations to do |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4153 |
better job. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4154 |
.Ip "\fB\-funit-at-a-time\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4155 |
.IX Item "-funit-at-a-time" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4156 |
Parse the whole compilation unit before starting to produce code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4157 |
This allows some extra optimizations to take place but consumes more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4158 |
memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4159 |
.Ip "\fB\-funroll-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4160 |
.IX Item "-funroll-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4161 |
Unroll loops whose number of iterations can be determined at compile time or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4162 |
upon entry to the loop. \fB\-funroll-loops\fR implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4163 |
\&\fB\-frerun-cse-after-loop\fR. It also turns on complete loop peeling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4164 |
(i.e. complete removal of loops with small constant number of iterations). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4165 |
This option makes code larger, and may or may not make it run faster. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4166 |
.Ip "\fB\-funroll-all-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4167 |
.IX Item "-funroll-all-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4168 |
Unroll all loops, even if their number of iterations is uncertain when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4169 |
the loop is entered. This usually makes programs run more slowly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4170 |
\&\fB\-funroll-all-loops\fR implies the same options as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4171 |
\&\fB\-funroll-loops\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4172 |
.Ip "\fB\-fpeel-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4173 |
.IX Item "-fpeel-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4174 |
Peels the loops for that there is enough information that they do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4175 |
roll much (from profile feedback). It also turns on complete loop peeling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4176 |
(i.e. complete removal of loops with small constant number of iterations). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4177 |
.Ip "\fB\-funswitch-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4178 |
.IX Item "-funswitch-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4179 |
Move branches with loop invariant conditions out of the loop, with duplicates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4180 |
of the loop on both branches (modified according to result of the condition). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4181 |
.Ip "\fB\-fold-unroll-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4182 |
.IX Item "-fold-unroll-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4183 |
Unroll loops whose number of iterations can be determined at compile |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4184 |
time or upon entry to the loop, using the old loop unroller whose loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4185 |
recognition is based on notes from frontend. \fB\-fold-unroll-loops\fR implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4186 |
both \fB\-fstrength-reduce\fR and \fB\-frerun-cse-after-loop\fR. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4187 |
option makes code larger, and may or may not make it run faster. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4188 |
.Ip "\fB\-fold-unroll-all-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4189 |
.IX Item "-fold-unroll-all-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4190 |
Unroll all loops, even if their number of iterations is uncertain when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4191 |
the loop is entered. This is done using the old loop unroller whose loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4192 |
recognition is based on notes from frontend. This usually makes programs run more slowly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4193 |
\&\fB\-fold-unroll-all-loops\fR implies the same options as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4194 |
\&\fB\-fold-unroll-loops\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4195 |
.Ip "\fB\-funswitch-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4196 |
.IX Item "-funswitch-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4197 |
Move branches with loop invariant conditions out of the loop, with duplicates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4198 |
of the loop on both branches (modified according to result of the condition). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4199 |
.Ip "\fB\-funswitch-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4200 |
.IX Item "-funswitch-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4201 |
Move branches with loop invariant conditions out of the loop, with duplicates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4202 |
of the loop on both branches (modified according to result of the condition). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4203 |
.Ip "\fB\-fprefetch-loop-arrays\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4204 |
.IX Item "-fprefetch-loop-arrays" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4205 |
If supported by the target machine, generate instructions to prefetch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4206 |
memory to improve the performance of loops that access large arrays. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4207 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4208 |
Disabled at level \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4209 |
.Ip "\fB\-ffunction-sections\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4210 |
.IX Item "-ffunction-sections" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4211 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4212 |
.Ip "\fB\-fdata-sections\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4213 |
.IX Item "-fdata-sections" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4214 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4215 |
Place each function or data item into its own section in the output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4216 |
file if the target supports arbitrary sections. The name of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4217 |
function or the name of the data item determines the section's name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4218 |
in the output file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4219 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4220 |
Use these options on systems where the linker can perform optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4221 |
to improve locality of reference in the instruction space. Most systems |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4222 |
using the \s-1ELF\s0 object format and \s-1SPARC\s0 processors running Solaris 2 have |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4223 |
linkers with such optimizations. \s-1AIX\s0 may have these optimizations in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4224 |
the future. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4225 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4226 |
Only use these options when there are significant benefits from doing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4227 |
so. When you specify these options, the assembler and linker will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4228 |
create larger object and executable files and will also be slower. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4229 |
You will not be able to use \f(CW\*(C`gprof\*(C'\fR on all systems if you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4230 |
specify this option and you may have problems with debugging if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4231 |
you specify both this option and \fB\-g\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4232 |
.Ip "\fB\-fbranch-target-load-optimize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4233 |
.IX Item "-fbranch-target-load-optimize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4234 |
Perform branch target register load optimization before prologue / epilogue |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4235 |
threading. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4236 |
The use of target registers can typically be exposed only during reload, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4237 |
thus hoisting loads out of loops and doing inter-block scheduling needs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4238 |
a separate optimization pass. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4239 |
.Ip "\fB\-fbranch-target-load-optimize2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4240 |
.IX Item "-fbranch-target-load-optimize2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4241 |
Perform branch target register load optimization after prologue / epilogue |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4242 |
threading. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4243 |
.Ip "\fB\*(--param\fR \fIname\fR\fB=\fR\fIvalue\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4244 |
.IX Item "param name=value" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4245 |
In some places, \s-1GCC\s0 uses various constants to control the amount of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4246 |
optimization that is done. For example, \s-1GCC\s0 will not inline functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4247 |
that contain more that a certain number of instructions. You can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4248 |
control some of these constants on the command-line using the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4249 |
\&\fB\*(--param\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4250 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4251 |
The names of specific parameters, and the meaning of the values, are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4252 |
tied to the internals of the compiler, and are subject to change |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4253 |
without notice in future releases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4254 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4255 |
In each case, the \fIvalue\fR is an integer. The allowable choices for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4256 |
\&\fIname\fR are given in the following table: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4257 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4258 |
.Ip "\fBmax-crossjump-edges\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4259 |
.IX Item "max-crossjump-edges" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4260 |
The maximum number of incoming edges to consider for crossjumping. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4261 |
The algorithm used by \fB\-fcrossjumping\fR is O(N^2) in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4262 |
the number of edges incoming to each block. Increasing values mean |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4263 |
more aggressive optimization, making the compile time increase with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4264 |
probably small improvement in executable size. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4265 |
.Ip "\fBmax-delay-slot-insn-search\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4266 |
.IX Item "max-delay-slot-insn-search" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4267 |
The maximum number of instructions to consider when looking for an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4268 |
instruction to fill a delay slot. If more than this arbitrary number of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4269 |
instructions is searched, the time savings from filling the delay slot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4270 |
will be minimal so stop searching. Increasing values mean more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4271 |
aggressive optimization, making the compile time increase with probably |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4272 |
small improvement in executable run time. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4273 |
.Ip "\fBmax-delay-slot-live-search\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4274 |
.IX Item "max-delay-slot-live-search" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4275 |
When trying to fill delay slots, the maximum number of instructions to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4276 |
consider when searching for a block with valid live register |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4277 |
information. Increasing this arbitrarily chosen value means more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4278 |
aggressive optimization, increasing the compile time. This parameter |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4279 |
should be removed when the delay slot code is rewritten to maintain the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4280 |
control-flow graph. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4281 |
.Ip "\fBmax-gcse-memory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4282 |
.IX Item "max-gcse-memory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4283 |
The approximate maximum amount of memory that will be allocated in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4284 |
order to perform the global common subexpression elimination |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4285 |
optimization. If more memory than specified is required, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4286 |
optimization will not be done. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4287 |
.Ip "\fBmax-gcse-passes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4288 |
.IX Item "max-gcse-passes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4289 |
The maximum number of passes of \s-1GCSE\s0 to run. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4290 |
.Ip "\fBmax-pending-list-length\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4291 |
.IX Item "max-pending-list-length" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4292 |
The maximum number of pending dependencies scheduling will allow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4293 |
before flushing the current state and starting over. Large functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4294 |
with few branches or calls can create excessively large lists which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4295 |
needlessly consume memory and resources. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4296 |
.Ip "\fBmax-inline-insns-single\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4297 |
.IX Item "max-inline-insns-single" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4298 |
Several parameters control the tree inliner used in gcc. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4299 |
This number sets the maximum number of instructions (counted in \s-1GCC\s0's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4300 |
internal representation) in a single function that the tree inliner |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4301 |
will consider for inlining. This only affects functions declared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4302 |
inline and methods implemented in a class declaration (\*(C+). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4303 |
The default value is 500. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4304 |
.Ip "\fBmax-inline-insns-auto\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4305 |
.IX Item "max-inline-insns-auto" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4306 |
When you use \fB\-finline-functions\fR (included in \fB\-O3\fR), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4307 |
a lot of functions that would otherwise not be considered for inlining |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4308 |
by the compiler will be investigated. To those functions, a different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4309 |
(more restrictive) limit compared to functions declared inline can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4310 |
be applied. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4311 |
The default value is 100. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4312 |
.Ip "\fBlarge-function-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4313 |
.IX Item "large-function-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4314 |
The limit specifying really large functions. For functions greater than this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4315 |
limit inlining is constrained by \fB\*(--param large-function-growth\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4316 |
This parameter is useful primarily to avoid extreme compilation time caused by non-linear |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4317 |
algorithms used by the backend. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4318 |
This parameter is ignored when \fB\-funit-at-a-time\fR is not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4319 |
The default value is 3000. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4320 |
.Ip "\fBlarge-function-growth\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4321 |
.IX Item "large-function-growth" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4322 |
Specifies maximal growth of large function caused by inlining in percents. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4323 |
This parameter is ignored when \fB\-funit-at-a-time\fR is not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4324 |
The default value is 200. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4325 |
.Ip "\fBinline-unit-growth\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4326 |
.IX Item "inline-unit-growth" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4327 |
Specifies maximal overall growth of the compilation unit caused by inlining. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4328 |
This parameter is ignored when \fB\-funit-at-a-time\fR is not used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4329 |
The default value is 150. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4330 |
.Ip "\fBmax-inline-insns-rtl\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4331 |
.IX Item "max-inline-insns-rtl" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4332 |
For languages that use the \s-1RTL\s0 inliner (this happens at a later stage |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4333 |
than tree inlining), you can set the maximum allowable size (counted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4334 |
in \s-1RTL\s0 instructions) for the \s-1RTL\s0 inliner with this parameter. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4335 |
The default value is 600. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4336 |
.Ip "\fBmax-unrolled-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4337 |
.IX Item "max-unrolled-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4338 |
The maximum number of instructions that a loop should have if that loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4339 |
is unrolled, and if the loop is unrolled, it determines how many times |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4340 |
the loop code is unrolled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4341 |
.Ip "\fBmax-average-unrolled-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4342 |
.IX Item "max-average-unrolled-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4343 |
The maximum number of instructions biased by probabilities of their execution |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4344 |
that a loop should have if that loop is unrolled, and if the loop is unrolled, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4345 |
it determines how many times the loop code is unrolled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4346 |
.Ip "\fBmax-unroll-times\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4347 |
.IX Item "max-unroll-times" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4348 |
The maximum number of unrollings of a single loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4349 |
.Ip "\fBmax-peeled-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4350 |
.IX Item "max-peeled-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4351 |
The maximum number of instructions that a loop should have if that loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4352 |
is peeled, and if the loop is peeled, it determines how many times |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4353 |
the loop code is peeled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4354 |
.Ip "\fBmax-peel-times\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4355 |
.IX Item "max-peel-times" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4356 |
The maximum number of peelings of a single loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4357 |
.Ip "\fBmax-completely-peeled-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4358 |
.IX Item "max-completely-peeled-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4359 |
The maximum number of insns of a completely peeled loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4360 |
.Ip "\fBmax-completely-peel-times\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4361 |
.IX Item "max-completely-peel-times" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4362 |
The maximum number of iterations of a loop to be suitable for complete peeling. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4363 |
.Ip "\fBmax-unswitch-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4364 |
.IX Item "max-unswitch-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4365 |
The maximum number of insns of an unswitched loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4366 |
.Ip "\fBmax-unswitch-level\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4367 |
.IX Item "max-unswitch-level" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4368 |
The maximum number of branches unswitched in a single loop. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4369 |
.Ip "\fBhot-bb-count-fraction\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4370 |
.IX Item "hot-bb-count-fraction" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4371 |
Select fraction of the maximal count of repetitions of basic block in program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4372 |
given basic block needs to have to be considered hot. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4373 |
.Ip "\fBhot-bb-frequency-fraction\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4374 |
.IX Item "hot-bb-frequency-fraction" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4375 |
Select fraction of the maximal frequency of executions of basic block in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4376 |
function given basic block needs to have to be considered hot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4377 |
.Ip "\fBtracer-dynamic-coverage\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4378 |
.IX Item "tracer-dynamic-coverage" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4379 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4380 |
.Ip "\fBtracer-dynamic-coverage-feedback\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4381 |
.IX Item "tracer-dynamic-coverage-feedback" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4382 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4383 |
This value is used to limit superblock formation once the given percentage of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4384 |
executed instructions is covered. This limits unnecessary code size |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4385 |
expansion. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4386 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4387 |
The \fBtracer-dynamic-coverage-feedback\fR is used only when profile |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4388 |
feedback is available. The real profiles (as opposed to statically estimated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4389 |
ones) are much less balanced allowing the threshold to be larger value. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4390 |
.Ip "\fBtracer-max-code-growth\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4391 |
.IX Item "tracer-max-code-growth" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4392 |
Stop tail duplication once code growth has reached given percentage. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4393 |
rather hokey argument, as most of the duplicates will be eliminated later in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4394 |
cross jumping, so it may be set to much higher values than is the desired code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4395 |
growth. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4396 |
.Ip "\fBtracer-min-branch-ratio\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4397 |
.IX Item "tracer-min-branch-ratio" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4398 |
Stop reverse growth when the reverse probability of best edge is less than this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4399 |
threshold (in percent). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4400 |
.Ip "\fBtracer-min-branch-ratio\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4401 |
.IX Item "tracer-min-branch-ratio" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4402 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4403 |
.Ip "\fBtracer-min-branch-ratio-feedback\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4404 |
.IX Item "tracer-min-branch-ratio-feedback" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4405 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4406 |
Stop forward growth if the best edge do have probability lower than this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4407 |
threshold. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4408 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4409 |
Similarly to \fBtracer-dynamic-coverage\fR two values are present, one for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4410 |
compilation for profile feedback and one for compilation without. The value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4411 |
for compilation with profile feedback needs to be more conservative (higher) in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4412 |
order to make tracer effective. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4413 |
.Ip "\fBmax-cse-path-length\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4414 |
.IX Item "max-cse-path-length" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4415 |
Maximum number of basic blocks on path that cse considers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4416 |
.Ip "\fBmax-last-value-rtl\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4417 |
.IX Item "max-last-value-rtl" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4418 |
The maximum size measured as number of RTLs that can be recorded in an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4419 |
expression in combiner for a pseudo register as last known value of that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4420 |
register. The default is 10000. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4421 |
.Ip "\fBggc-min-expand\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4422 |
.IX Item "ggc-min-expand" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4423 |
\&\s-1GCC\s0 uses a garbage collector to manage its own memory allocation. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4424 |
parameter specifies the minimum percentage by which the garbage |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4425 |
collector's heap should be allowed to expand between collections. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4426 |
Tuning this may improve compilation speed; it has no effect on code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4427 |
generation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4428 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4429 |
The default is 30% + 70% * (\s-1RAM/1GB\s0) with an upper bound of 100% when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4430 |
\&\s-1RAM\s0 >= 1GB. If \f(CW\*(C`getrlimit\*(C'\fR is available, the notion of \*(L"\s-1RAM\s0\*(R" is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4431 |
the smallest of actual \s-1RAM\s0, \s-1RLIMIT_RSS\s0, \s-1RLIMIT_DATA\s0 and \s-1RLIMIT_AS\s0. If |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4432 |
\&\s-1GCC\s0 is not able to calculate \s-1RAM\s0 on a particular platform, the lower |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4433 |
bound of 30% is used. Setting this parameter and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4434 |
\&\fBggc-min-heapsize\fR to zero causes a full collection to occur at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4435 |
every opportunity. This is extremely slow, but can be useful for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4436 |
debugging. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4437 |
.Ip "\fBggc-min-heapsize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4438 |
.IX Item "ggc-min-heapsize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4439 |
Minimum size of the garbage collector's heap before it begins bothering |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4440 |
to collect garbage. The first collection occurs after the heap expands |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4441 |
by \fBggc-min-expand\fR% beyond \fBggc-min-heapsize\fR. Again, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4442 |
tuning this may improve compilation speed, and has no effect on code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4443 |
generation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4444 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4445 |
The default is \s-1RAM/8\s0, with a lower bound of 4096 (four megabytes) and an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4446 |
upper bound of 131072 (128 megabytes). If \f(CW\*(C`getrlimit\*(C'\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4447 |
available, the notion of \*(L"\s-1RAM\s0\*(R" is the smallest of actual \s-1RAM\s0, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4448 |
\&\s-1RLIMIT_RSS\s0, \s-1RLIMIT_DATA\s0 and \s-1RLIMIT_AS\s0. If \s-1GCC\s0 is not able to calculate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4449 |
\&\s-1RAM\s0 on a particular platform, the lower bound is used. Setting this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4450 |
parameter very large effectively disables garbage collection. Setting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4451 |
this parameter and \fBggc-min-expand\fR to zero causes a full |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4452 |
collection to occur at every opportunity. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4453 |
.Ip "\fBmax-reload-search-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4454 |
.IX Item "max-reload-search-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4455 |
The maximum number of instruction reload should look backward for equivalent |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4456 |
register. Increasing values mean more aggressive optimization, making the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4457 |
compile time increase with probably slightly better performance. The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4458 |
value is 100. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4459 |
.Ip "\fBmax-cselib-memory-location\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4460 |
.IX Item "max-cselib-memory-location" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4461 |
The maximum number of memory locations cselib should take into acount. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4462 |
Increasing values mean more aggressive optimization, making the compile time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4463 |
increase with probably slightly better performance. The default value is 500. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4464 |
.Ip "\fBreorder-blocks-duplicate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4465 |
.IX Item "reorder-blocks-duplicate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4466 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4467 |
.Ip "\fBreorder-blocks-duplicate-feedback\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4468 |
.IX Item "reorder-blocks-duplicate-feedback" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4469 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4470 |
Used by basic block reordering pass to decide whether to use unconditional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4471 |
branch or duplicate the code on its destination. Code is duplicated when its |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4472 |
estimated size is smaller than this value multiplied by the estimated size of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4473 |
unconditional jump in the hot spots of the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4474 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4475 |
The \fBreorder-block-duplicate-feedback\fR is used only when profile |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4476 |
feedback is available and may be set to higher values than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4477 |
\&\fBreorder-block-duplicate\fR since information about the hot spots is more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4478 |
accurate. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4479 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4480 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4481 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4482 |
.Sh "Options Controlling the Preprocessor" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4483 |
.IX Subsection "Options Controlling the Preprocessor" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4484 |
These options control the C preprocessor, which is run on each C source |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4485 |
file before actual compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4486 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4487 |
If you use the \fB\-E\fR option, nothing is done except preprocessing. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4488 |
Some of these options make sense only together with \fB\-E\fR because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4489 |
they cause the preprocessor output to be unsuitable for actual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4490 |
compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4491 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4492 |
You can use \fB\-Wp,\fR\fIoption\fR to bypass the compiler driver |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4493 |
and pass \fIoption\fR directly through to the preprocessor. If |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4494 |
\&\fIoption\fR contains commas, it is split into multiple options at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4495 |
commas. However, many options are modified, translated or interpreted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4496 |
by the compiler driver before being passed to the preprocessor, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4497 |
\&\fB\-Wp\fR forcibly bypasses this phase. The preprocessor's direct |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4498 |
interface is undocumented and subject to change, so whenever possible |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4499 |
you should avoid using \fB\-Wp\fR and let the driver handle the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4500 |
options instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4501 |
.Ip "\fB\-Xpreprocessor\fR \fIoption\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4502 |
.IX Item "-Xpreprocessor option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4503 |
Pass \fIoption\fR as an option to the preprocessor. You can use this to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4504 |
supply system-specific preprocessor options which \s-1GCC\s0 does not know how to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4505 |
recognize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4506 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4507 |
If you want to pass an option that takes an argument, you must use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4508 |
\&\fB\-Xpreprocessor\fR twice, once for the option and once for the argument. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4509 |
.Ip "\fB\-D\fR \fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4510 |
.IX Item "-D name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4511 |
Predefine \fIname\fR as a macro, with definition \f(CW\*(C`1\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4512 |
.Ip "\fB\-D\fR \fIname\fR\fB=\fR\fIdefinition\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4513 |
.IX Item "-D name=definition" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4514 |
Predefine \fIname\fR as a macro, with definition \fIdefinition\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4515 |
The contents of \fIdefinition\fR are tokenized and processed as if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4516 |
they appeared during translation phase three in a \fB#define\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4517 |
directive. In particular, the definition will be truncated by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4518 |
embedded newline characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4519 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4520 |
If you are invoking the preprocessor from a shell or shell-like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4521 |
program you may need to use the shell's quoting syntax to protect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4522 |
characters such as spaces that have a meaning in the shell syntax. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4523 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4524 |
If you wish to define a function-like macro on the command line, write |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4525 |
its argument list with surrounding parentheses before the equals sign |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4526 |
(if any). Parentheses are meaningful to most shells, so you will need |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4527 |
to quote the option. With \fBsh\fR and \fBcsh\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4528 |
\&\fB\-D'\fR\fIname\fR\fB(\fR\fIargs...\fR\fB)=\fR\fIdefinition\fR\fB'\fR works. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4529 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4530 |
\&\fB\-D\fR and \fB\-U\fR options are processed in the order they |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4531 |
are given on the command line. All \fB\-imacros\fR \fIfile\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4532 |
\&\fB\-include\fR \fIfile\fR options are processed after all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4533 |
\&\fB\-D\fR and \fB\-U\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4534 |
.Ip "\fB\-U\fR \fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4535 |
.IX Item "-U name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4536 |
Cancel any previous definition of \fIname\fR, either built in or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4537 |
provided with a \fB\-D\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4538 |
.Ip "\fB\-undef\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4539 |
.IX Item "-undef" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4540 |
Do not predefine any system-specific or GCC-specific macros. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4541 |
standard predefined macros remain defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4542 |
.Ip "\fB\-I\fR \fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4543 |
.IX Item "-I dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4544 |
Add the directory \fIdir\fR to the list of directories to be searched |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4545 |
for header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4546 |
Directories named by \fB\-I\fR are searched before the standard |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4547 |
system include directories. If the directory \fIdir\fR is a standard |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4548 |
system include directory, the option is ignored to ensure that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4549 |
default search order for system directories and the special treatment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4550 |
of system headers are not defeated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4551 |
\&. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4552 |
.Ip "\fB\-o\fR \fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4553 |
.IX Item "-o file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4554 |
Write output to \fIfile\fR. This is the same as specifying \fIfile\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4555 |
as the second non-option argument to \fBcpp\fR. \fBgcc\fR has a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4556 |
different interpretation of a second non-option argument, so you must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4557 |
use \fB\-o\fR to specify the output file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4558 |
.Ip "\fB\-Wall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4559 |
.IX Item "-Wall" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4560 |
Turns on all optional warnings which are desirable for normal code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4561 |
At present this is \fB\-Wcomment\fR, \fB\-Wtrigraphs\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4562 |
\&\fB\-Wmultichar\fR and a warning about integer promotion causing a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4563 |
change of sign in \f(CW\*(C`#if\*(C'\fR expressions. Note that many of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4564 |
preprocessor's warnings are on by default and have no options to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4565 |
control them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4566 |
.Ip "\fB\-Wcomment\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4567 |
.IX Item "-Wcomment" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4568 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4569 |
.Ip "\fB\-Wcomments\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4570 |
.IX Item "-Wcomments" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4571 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4572 |
Warn whenever a comment-start sequence \fB/*\fR appears in a \fB/*\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4573 |
comment, or whenever a backslash-newline appears in a \fB//\fR comment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4574 |
(Both forms have the same effect.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4575 |
.Ip "\fB\-Wtrigraphs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4576 |
.IX Item "-Wtrigraphs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4577 |
@anchor{Wtrigraphs} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4578 |
Most trigraphs in comments cannot affect the meaning of the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4579 |
However, a trigraph that would form an escaped newline (\fB??/\fR at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4580 |
the end of a line) can, by changing where the comment begins or ends. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4581 |
Therefore, only trigraphs that would form escaped newlines produce |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4582 |
warnings inside a comment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4583 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4584 |
This option is implied by \fB\-Wall\fR. If \fB\-Wall\fR is not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4585 |
given, this option is still enabled unless trigraphs are enabled. To |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4586 |
get trigraph conversion without warnings, but get the other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4587 |
\&\fB\-Wall\fR warnings, use \fB\-trigraphs \-Wall \-Wno-trigraphs\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4588 |
.Ip "\fB\-Wtraditional\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4589 |
.IX Item "-Wtraditional" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4590 |
Warn about certain constructs that behave differently in traditional and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4591 |
\&\s-1ISO\s0 C. Also warn about \s-1ISO\s0 C constructs that have no traditional C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4592 |
equivalent, and problematic constructs which should be avoided. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4593 |
.Ip "\fB\-Wimport\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4594 |
.IX Item "-Wimport" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4595 |
Warn the first time \fB#import\fR is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4596 |
.Ip "\fB\-Wundef\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4597 |
.IX Item "-Wundef" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4598 |
Warn whenever an identifier which is not a macro is encountered in an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4599 |
\&\fB#if\fR directive, outside of \fBdefined\fR. Such identifiers are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4600 |
replaced with zero. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4601 |
.Ip "\fB\-Wunused-macros\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4602 |
.IX Item "-Wunused-macros" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4603 |
Warn about macros defined in the main file that are unused. A macro |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4604 |
is \fIused\fR if it is expanded or tested for existence at least once. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4605 |
The preprocessor will also warn if the macro has not been used at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4606 |
time it is redefined or undefined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4607 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4608 |
Built-in macros, macros defined on the command line, and macros |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4609 |
defined in include files are not warned about. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4610 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4611 |
\&\fBNote:\fR If a macro is actually used, but only used in skipped |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4612 |
conditional blocks, then \s-1CPP\s0 will report it as unused. To avoid the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4613 |
warning in such a case, you might improve the scope of the macro's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4614 |
definition by, for example, moving it into the first skipped block. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4615 |
Alternatively, you could provide a dummy use with something like: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4616 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4617 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4618 |
\& #if defined the_macro_causing_the_warning |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4619 |
\& #endif |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4620 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4621 |
.Ip "\fB\-Wendif-labels\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4622 |
.IX Item "-Wendif-labels" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4623 |
Warn whenever an \fB#else\fR or an \fB#endif\fR are followed by text. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4624 |
This usually happens in code of the form |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4625 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4626 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4627 |
\& #if FOO |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4628 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4629 |
\& #else FOO |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4630 |
\& ... |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4631 |
\& #endif FOO |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4632 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4633 |
The second and third \f(CW\*(C`FOO\*(C'\fR should be in comments, but often are not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4634 |
in older programs. This warning is on by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4635 |
.Ip "\fB\-Werror\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4636 |
.IX Item "-Werror" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4637 |
Make all warnings into hard errors. Source code which triggers warnings |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4638 |
will be rejected. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4639 |
.Ip "\fB\-Wsystem-headers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4640 |
.IX Item "-Wsystem-headers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4641 |
Issue warnings for code in system headers. These are normally unhelpful |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4642 |
in finding bugs in your own code, therefore suppressed. If you are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4643 |
responsible for the system library, you may want to see them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4644 |
.Ip "\fB\-w\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4645 |
.IX Item "-w" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4646 |
Suppress all warnings, including those which \s-1GNU\s0 \s-1CPP\s0 issues by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4647 |
.Ip "\fB\-pedantic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4648 |
.IX Item "-pedantic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4649 |
Issue all the mandatory diagnostics listed in the C standard. Some of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4650 |
them are left out by default, since they trigger frequently on harmless |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4651 |
code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4652 |
.Ip "\fB\-pedantic-errors\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4653 |
.IX Item "-pedantic-errors" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4654 |
Issue all the mandatory diagnostics, and make all mandatory diagnostics |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4655 |
into errors. This includes mandatory diagnostics that \s-1GCC\s0 issues |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4656 |
without \fB\-pedantic\fR but treats as warnings. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4657 |
.Ip "\fB\-M\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4658 |
.IX Item "-M" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4659 |
Instead of outputting the result of preprocessing, output a rule |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4660 |
suitable for \fBmake\fR describing the dependencies of the main |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4661 |
source file. The preprocessor outputs one \fBmake\fR rule containing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4662 |
the object file name for that source file, a colon, and the names of all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4663 |
the included files, including those coming from \fB\-include\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4664 |
\&\fB\-imacros\fR command line options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4665 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4666 |
Unless specified explicitly (with \fB\-MT\fR or \fB\-MQ\fR), the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4667 |
object file name consists of the basename of the source file with any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4668 |
suffix replaced with object file suffix. If there are many included |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4669 |
files then the rule is split into several lines using \fB\e\fR\-newline. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4670 |
The rule has no commands. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4671 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4672 |
This option does not suppress the preprocessor's debug output, such as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4673 |
\&\fB\-dM\fR. To avoid mixing such debug output with the dependency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4674 |
rules you should explicitly specify the dependency output file with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4675 |
\&\fB\-MF\fR, or use an environment variable like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4676 |
\&\fB\s-1DEPENDENCIES_OUTPUT\s0\fR. Debug output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4677 |
will still be sent to the regular output stream as normal. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4678 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4679 |
Passing \fB\-M\fR to the driver implies \fB\-E\fR, and suppresses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4680 |
warnings with an implicit \fB\-w\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4681 |
.Ip "\fB\-MM\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4682 |
.IX Item "-MM" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4683 |
Like \fB\-M\fR but do not mention header files that are found in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4684 |
system header directories, nor header files that are included, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4685 |
directly or indirectly, from such a header. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4686 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4687 |
This implies that the choice of angle brackets or double quotes in an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4688 |
\&\fB#include\fR directive does not in itself determine whether that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4689 |
header will appear in \fB\-MM\fR dependency output. This is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4690 |
slight change in semantics from \s-1GCC\s0 versions 3.0 and earlier. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4691 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4692 |
@anchor{dashMF} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4693 |
.Ip "\fB\-MF\fR \fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4694 |
.IX Item "-MF file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4695 |
When used with \fB\-M\fR or \fB\-MM\fR, specifies a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4696 |
file to write the dependencies to. If no \fB\-MF\fR switch is given |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4697 |
the preprocessor sends the rules to the same place it would have sent |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4698 |
preprocessed output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4699 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4700 |
When used with the driver options \fB\-MD\fR or \fB\-MMD\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4701 |
\&\fB\-MF\fR overrides the default dependency output file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4702 |
.Ip "\fB\-MG\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4703 |
.IX Item "-MG" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4704 |
In conjunction with an option such as \fB\-M\fR requesting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4705 |
dependency generation, \fB\-MG\fR assumes missing header files are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4706 |
generated files and adds them to the dependency list without raising |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4707 |
an error. The dependency filename is taken directly from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4708 |
\&\f(CW\*(C`#include\*(C'\fR directive without prepending any path. \fB\-MG\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4709 |
also suppresses preprocessed output, as a missing header file renders |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4710 |
this useless. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4711 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4712 |
This feature is used in automatic updating of makefiles. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4713 |
.Ip "\fB\-MP\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4714 |
.IX Item "-MP" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4715 |
This option instructs \s-1CPP\s0 to add a phony target for each dependency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4716 |
other than the main file, causing each to depend on nothing. These |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4717 |
dummy rules work around errors \fBmake\fR gives if you remove header |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4718 |
files without updating the \fIMakefile\fR to match. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4719 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4720 |
This is typical output: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4721 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4722 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4723 |
\& test.o: test.c test.h |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4724 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4725 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4726 |
\& test.h: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4727 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4728 |
.Ip "\fB\-MT\fR \fItarget\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4729 |
.IX Item "-MT target" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4730 |
Change the target of the rule emitted by dependency generation. By |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4731 |
default \s-1CPP\s0 takes the name of the main input file, including any path, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4732 |
deletes any file suffix such as \fB.c\fR, and appends the platform's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4733 |
usual object suffix. The result is the target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4734 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4735 |
An \fB\-MT\fR option will set the target to be exactly the string you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4736 |
specify. If you want multiple targets, you can specify them as a single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4737 |
argument to \fB\-MT\fR, or use multiple \fB\-MT\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4738 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4739 |
For example, \fB\-MT\ '$(objpfx)foo.o'\fR might give |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4740 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4741 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4742 |
\& $(objpfx)foo.o: foo.c |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4743 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4744 |
.Ip "\fB\-MQ\fR \fItarget\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4745 |
.IX Item "-MQ target" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4746 |
Same as \fB\-MT\fR, but it quotes any characters which are special to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4747 |
Make. \fB\-MQ\ '$(objpfx)foo.o'\fR gives |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4748 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4749 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4750 |
\& $$(objpfx)foo.o: foo.c |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4751 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4752 |
The default target is automatically quoted, as if it were given with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4753 |
\&\fB\-MQ\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4754 |
.Ip "\fB\-MD\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4755 |
.IX Item "-MD" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4756 |
\&\fB\-MD\fR is equivalent to \fB\-M \-MF\fR \fIfile\fR, except that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4757 |
\&\fB\-E\fR is not implied. The driver determines \fIfile\fR based on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4758 |
whether an \fB\-o\fR option is given. If it is, the driver uses its |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4759 |
argument but with a suffix of \fI.d\fR, otherwise it take the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4760 |
basename of the input file and applies a \fI.d\fR suffix. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4761 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4762 |
If \fB\-MD\fR is used in conjunction with \fB\-E\fR, any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4763 |
\&\fB\-o\fR switch is understood to specify the dependency output file |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4764 |
(but \f(CW@pxref\fR{dashMF,,\-MF}), but if used without \fB\-E\fR, each \fB\-o\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4765 |
is understood to specify a target object file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4766 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4767 |
Since \fB\-E\fR is not implied, \fB\-MD\fR can be used to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4768 |
a dependency output file as a side-effect of the compilation process. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4769 |
.Ip "\fB\-MMD\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4770 |
.IX Item "-MMD" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4771 |
Like \fB\-MD\fR except mention only user header files, not system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4772 |
\&\-header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4773 |
.Ip "\fB\-fpch-deps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4774 |
.IX Item "-fpch-deps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4775 |
When using precompiled headers, this flag |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4776 |
will cause the dependency-output flags to also list the files from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4777 |
precompiled header's dependencies. If not specified only the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4778 |
precompiled header would be listed and not the files that were used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4779 |
create it because those files are not consulted when a precompiled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4780 |
header is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4781 |
.Ip "\fB\-x c\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4782 |
.IX Item "-x c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4783 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4784 |
.Ip "\fB\-x c++\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4785 |
.IX Item "-x c++" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4786 |
.Ip "\fB\-x objective-c\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4787 |
.IX Item "-x objective-c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4788 |
.Ip "\fB\-x assembler-with-cpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4789 |
.IX Item "-x assembler-with-cpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4790 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4791 |
Specify the source language: C, \*(C+, Objective-C, or assembly. This has |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4792 |
nothing to do with standards conformance or extensions; it merely |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4793 |
selects which base syntax to expect. If you give none of these options, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4794 |
cpp will deduce the language from the extension of the source file: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4795 |
\&\fB.c\fR, \fB.cc\fR, \fB.m\fR, or \fB.S\fR. Some other common |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4796 |
extensions for \*(C+ and assembly are also recognized. If cpp does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4797 |
recognize the extension, it will treat the file as C; this is the most |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4798 |
generic mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4799 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4800 |
\&\fBNote:\fR Previous versions of cpp accepted a \fB\-lang\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4801 |
which selected both the language and the standards conformance level. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4802 |
This option has been removed, because it conflicts with the \fB\-l\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4803 |
option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4804 |
.Ip "\fB\-std=\fR\fIstandard\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4805 |
.IX Item "-std=standard" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4806 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4807 |
.Ip "\fB\-ansi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4808 |
.IX Item "-ansi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4809 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4810 |
Specify the standard to which the code should conform. Currently \s-1CPP\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4811 |
knows about C and \*(C+ standards; others may be added in the future. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4812 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4813 |
\&\fIstandard\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4814 |
may be one of: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4815 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4816 |
.if n .Ip "\f(CW""""iso9899:1990""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4817 |
.el .Ip "\f(CWiso9899:1990\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4818 |
.IX Item "iso9899:1990" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4819 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4820 |
.if n .Ip "\f(CW""""c89""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4821 |
.el .Ip "\f(CWc89\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4822 |
.IX Item "c89" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4823 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4824 |
The \s-1ISO\s0 C standard from 1990. \fBc89\fR is the customary shorthand for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4825 |
this version of the standard. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4826 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4827 |
The \fB\-ansi\fR option is equivalent to \fB\-std=c89\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4828 |
.if n .Ip "\f(CW""""iso9899:199409""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4829 |
.el .Ip "\f(CWiso9899:199409\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4830 |
.IX Item "iso9899:199409" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4831 |
The 1990 C standard, as amended in 1994. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4832 |
.if n .Ip "\f(CW""""iso9899:1999""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4833 |
.el .Ip "\f(CWiso9899:1999\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4834 |
.IX Item "iso9899:1999" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4835 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4836 |
.if n .Ip "\f(CW""""c99""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4837 |
.el .Ip "\f(CWc99\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4838 |
.IX Item "c99" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4839 |
.if n .Ip "\f(CW""""iso9899:199x""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4840 |
.el .Ip "\f(CWiso9899:199x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4841 |
.IX Item "iso9899:199x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4842 |
.if n .Ip "\f(CW""""c9x""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4843 |
.el .Ip "\f(CWc9x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4844 |
.IX Item "c9x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4845 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4846 |
The revised \s-1ISO\s0 C standard, published in December 1999. Before |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4847 |
publication, this was known as C9X. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4848 |
.if n .Ip "\f(CW""""gnu89""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4849 |
.el .Ip "\f(CWgnu89\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4850 |
.IX Item "gnu89" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4851 |
The 1990 C standard plus \s-1GNU\s0 extensions. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4852 |
.if n .Ip "\f(CW""""gnu99""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4853 |
.el .Ip "\f(CWgnu99\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4854 |
.IX Item "gnu99" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4855 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4856 |
.if n .Ip "\f(CW""""gnu9x""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4857 |
.el .Ip "\f(CWgnu9x\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4858 |
.IX Item "gnu9x" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4859 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4860 |
The 1999 C standard plus \s-1GNU\s0 extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4861 |
.if n .Ip "\f(CW""""c++98""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4862 |
.el .Ip "\f(CWc++98\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4863 |
.IX Item "c++98" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4864 |
The 1998 \s-1ISO\s0 \*(C+ standard plus amendments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4865 |
.if n .Ip "\f(CW""""gnu++98""""\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4866 |
.el .Ip "\f(CWgnu++98\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4867 |
.IX Item "gnu++98" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4868 |
The same as \fB\-std=c++98\fR plus \s-1GNU\s0 extensions. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4869 |
default for \*(C+ code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4870 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4871 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4872 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4873 |
.Ip "\fB\-I-\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4874 |
.IX Item "-I-" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4875 |
Split the include path. Any directories specified with \fB\-I\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4876 |
options before \fB\-I-\fR are searched only for headers requested with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4877 |
\&\f(CW\*(C`#include\ "\f(CIfile\f(CW"\*(C'\fR; they are not searched for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4878 |
\&\f(CW\*(C`#include\ <\f(CIfile\f(CW>\*(C'\fR. If additional directories are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4879 |
specified with \fB\-I\fR options after the \fB\-I-\fR, those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4880 |
directories are searched for all \fB#include\fR directives. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4881 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4882 |
In addition, \fB\-I-\fR inhibits the use of the directory of the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4883 |
file directory as the first search directory for \f(CW\*(C`#include\ "\f(CIfile\f(CW"\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4884 |
.Ip "\fB\-nostdinc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4885 |
.IX Item "-nostdinc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4886 |
Do not search the standard system directories for header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4887 |
Only the directories you have specified with \fB\-I\fR options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4888 |
(and the directory of the current file, if appropriate) are searched. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4889 |
.Ip "\fB\-nostdinc++\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4890 |
.IX Item "-nostdinc++" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4891 |
Do not search for header files in the \*(C+\-specific standard directories, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4892 |
but do still search the other standard directories. (This option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4893 |
used when building the \*(C+ library.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4894 |
.Ip "\fB\-include\fR \fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4895 |
.IX Item "-include file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4896 |
Process \fIfile\fR as if \f(CW\*(C`#include "file"\*(C'\fR appeared as the first |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4897 |
line of the primary source file. However, the first directory searched |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4898 |
for \fIfile\fR is the preprocessor's working directory \fIinstead of\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4899 |
the directory containing the main source file. If not found there, it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4900 |
is searched for in the remainder of the \f(CW\*(C`#include "..."\*(C'\fR search |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4901 |
chain as normal. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4902 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4903 |
If multiple \fB\-include\fR options are given, the files are included |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4904 |
in the order they appear on the command line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4905 |
.Ip "\fB\-imacros\fR \fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4906 |
.IX Item "-imacros file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4907 |
Exactly like \fB\-include\fR, except that any output produced by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4908 |
scanning \fIfile\fR is thrown away. Macros it defines remain defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4909 |
This allows you to acquire all the macros from a header without also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4910 |
processing its declarations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4911 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4912 |
All files specified by \fB\-imacros\fR are processed before all files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4913 |
specified by \fB\-include\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4914 |
.Ip "\fB\-idirafter\fR \fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4915 |
.IX Item "-idirafter dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4916 |
Search \fIdir\fR for header files, but do it \fIafter\fR all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4917 |
directories specified with \fB\-I\fR and the standard system directories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4918 |
have been exhausted. \fIdir\fR is treated as a system include directory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4919 |
.Ip "\fB\-iprefix\fR \fIprefix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4920 |
.IX Item "-iprefix prefix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4921 |
Specify \fIprefix\fR as the prefix for subsequent \fB\-iwithprefix\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4922 |
options. If the prefix represents a directory, you should include the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4923 |
final \fB/\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4924 |
.Ip "\fB\-iwithprefix\fR \fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4925 |
.IX Item "-iwithprefix dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4926 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4927 |
.Ip "\fB\-iwithprefixbefore\fR \fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4928 |
.IX Item "-iwithprefixbefore dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4929 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4930 |
Append \fIdir\fR to the prefix specified previously with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4931 |
\&\fB\-iprefix\fR, and add the resulting directory to the include search |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4932 |
path. \fB\-iwithprefixbefore\fR puts it in the same place \fB\-I\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4933 |
would; \fB\-iwithprefix\fR puts it where \fB\-idirafter\fR would. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4934 |
.Ip "\fB\-isystem\fR \fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4935 |
.IX Item "-isystem dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4936 |
Search \fIdir\fR for header files, after all directories specified by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4937 |
\&\fB\-I\fR but before the standard system directories. Mark it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4938 |
as a system directory, so that it gets the same special treatment as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4939 |
is applied to the standard system directories. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4940 |
.Ip "\fB\-fdollars-in-identifiers\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4941 |
.IX Item "-fdollars-in-identifiers" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4942 |
@anchor{fdollars-in-identifiers} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4943 |
Accept \fB$\fR in identifiers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4944 |
.Ip "\fB\-fpreprocessed\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4945 |
.IX Item "-fpreprocessed" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4946 |
Indicate to the preprocessor that the input file has already been |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4947 |
preprocessed. This suppresses things like macro expansion, trigraph |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4948 |
conversion, escaped newline splicing, and processing of most directives. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4949 |
The preprocessor still recognizes and removes comments, so that you can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4950 |
pass a file preprocessed with \fB\-C\fR to the compiler without |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4951 |
problems. In this mode the integrated preprocessor is little more than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4952 |
a tokenizer for the front ends. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4953 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4954 |
\&\fB\-fpreprocessed\fR is implicit if the input file has one of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4955 |
extensions \fB.i\fR, \fB.ii\fR or \fB.mi\fR. These are the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4956 |
extensions that \s-1GCC\s0 uses for preprocessed files created by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4957 |
\&\fB\-save-temps\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4958 |
.Ip "\fB\-ftabstop=\fR\fIwidth\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4959 |
.IX Item "-ftabstop=width" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4960 |
Set the distance between tab stops. This helps the preprocessor report |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4961 |
correct column numbers in warnings or errors, even if tabs appear on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4962 |
line. If the value is less than 1 or greater than 100, the option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4963 |
ignored. The default is 8. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4964 |
.Ip "\fB\-fexec-charset=\fR\fIcharset\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4965 |
.IX Item "-fexec-charset=charset" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4966 |
Set the execution character set, used for string and character |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4967 |
constants. The default is \s-1UTF-8\s0. \fIcharset\fR can be any encoding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4968 |
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4969 |
.Ip "\fB\-fwide-exec-charset=\fR\fIcharset\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4970 |
.IX Item "-fwide-exec-charset=charset" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4971 |
Set the wide execution character set, used for wide string and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4972 |
character constants. The default is \s-1UTF-32\s0 or \s-1UTF-16\s0, whichever |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4973 |
corresponds to the width of \f(CW\*(C`wchar_t\*(C'\fR. As with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4974 |
\&\fB\-ftarget-charset\fR, \fIcharset\fR can be any encoding supported |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4975 |
by the system's \f(CW\*(C`iconv\*(C'\fR library routine; however, you will have |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4976 |
problems with encodings that do not fit exactly in \f(CW\*(C`wchar_t\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4977 |
.Ip "\fB\-finput-charset=\fR\fIcharset\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4978 |
.IX Item "-finput-charset=charset" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4979 |
Set the input character set, used for translation from the character |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4980 |
set of the input file to the source character set used by \s-1GCC\s0. If the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4981 |
locale does not specify, or \s-1GCC\s0 cannot get this information from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4982 |
locale, the default is \s-1UTF-8\s0. This can be overridden by either the locale |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4983 |
or this command line option. Currently the command line option takes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4984 |
precedence if there's a conflict. \fIcharset\fR can be any encoding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4985 |
supported by the system's \f(CW\*(C`iconv\*(C'\fR library routine. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4986 |
.Ip "\fB\-fworking-directory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4987 |
.IX Item "-fworking-directory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4988 |
Enable generation of linemarkers in the preprocessor output that will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4989 |
let the compiler know the current working directory at the time of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4990 |
preprocessing. When this option is enabled, the preprocessor will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4991 |
emit, after the initial linemarker, a second linemarker with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4992 |
current working directory followed by two slashes. \s-1GCC\s0 will use this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4993 |
directory, when it's present in the preprocessed input, as the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4994 |
directory emitted as the current working directory in some debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4995 |
information formats. This option is implicitly enabled if debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4996 |
information is enabled, but this can be inhibited with the negated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4997 |
form \fB\-fno-working-directory\fR. If the \fB\-P\fR flag is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4998 |
present in the command line, this option has no effect, since no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
4999 |
\&\f(CW\*(C`#line\*(C'\fR directives are emitted whatsoever. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5000 |
.Ip "\fB\-fno-show-column\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5001 |
.IX Item "-fno-show-column" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5002 |
Do not print column numbers in diagnostics. This may be necessary if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5003 |
diagnostics are being scanned by a program that does not understand the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5004 |
column numbers, such as \fBdejagnu\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5005 |
.Ip "\fB\-A\fR \fIpredicate\fR\fB=\fR\fIanswer\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5006 |
.IX Item "-A predicate=answer" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5007 |
Make an assertion with the predicate \fIpredicate\fR and answer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5008 |
\&\fIanswer\fR. This form is preferred to the older form \fB\-A\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5009 |
\&\fIpredicate\fR\fB(\fR\fIanswer\fR\fB)\fR, which is still supported, because |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5010 |
it does not use shell special characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5011 |
.Ip "\fB\-A -\fR\fIpredicate\fR\fB=\fR\fIanswer\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5012 |
.IX Item "-A -predicate=answer" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5013 |
Cancel an assertion with the predicate \fIpredicate\fR and answer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5014 |
\&\fIanswer\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5015 |
.Ip "\fB\-dCHARS\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5016 |
.IX Item "-dCHARS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5017 |
\&\fI\s-1CHARS\s0\fR is a sequence of one or more of the following characters, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5018 |
and must not be preceded by a space. Other characters are interpreted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5019 |
by the compiler proper, or reserved for future versions of \s-1GCC\s0, and so |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5020 |
are silently ignored. If you specify characters whose behavior |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5021 |
conflicts, the result is undefined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5022 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5023 |
.Ip "\fBM\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5024 |
.IX Item "M" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5025 |
Instead of the normal output, generate a list of \fB#define\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5026 |
directives for all the macros defined during the execution of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5027 |
preprocessor, including predefined macros. This gives you a way of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5028 |
finding out what is predefined in your version of the preprocessor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5029 |
Assuming you have no file \fIfoo.h\fR, the command |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5030 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5031 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5032 |
\& touch foo.h; cpp -dM foo.h |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5033 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5034 |
will show all the predefined macros. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5035 |
.Ip "\fBD\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5036 |
.IX Item "D" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5037 |
Like \fBM\fR except in two respects: it does \fInot\fR include the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5038 |
predefined macros, and it outputs \fIboth\fR the \fB#define\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5039 |
directives and the result of preprocessing. Both kinds of output go to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5040 |
the standard output file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5041 |
.Ip "\fBN\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5042 |
.IX Item "N" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5043 |
Like \fBD\fR, but emit only the macro names, not their expansions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5044 |
.Ip "\fBI\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5045 |
.IX Item "I" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5046 |
Output \fB#include\fR directives in addition to the result of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5047 |
preprocessing. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5048 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5049 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5050 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5051 |
.Ip "\fB\-P\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5052 |
.IX Item "-P" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5053 |
Inhibit generation of linemarkers in the output from the preprocessor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5054 |
This might be useful when running the preprocessor on something that is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5055 |
not C code, and will be sent to a program which might be confused by the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5056 |
linemarkers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5057 |
.Ip "\fB\-C\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5058 |
.IX Item "-C" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5059 |
Do not discard comments. All comments are passed through to the output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5060 |
file, except for comments in processed directives, which are deleted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5061 |
along with the directive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5062 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5063 |
You should be prepared for side effects when using \fB\-C\fR; it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5064 |
causes the preprocessor to treat comments as tokens in their own right. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5065 |
For example, comments appearing at the start of what would be a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5066 |
directive line have the effect of turning that line into an ordinary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5067 |
source line, since the first token on the line is no longer a \fB#\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5068 |
.Ip "\fB\-CC\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5069 |
.IX Item "-CC" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5070 |
Do not discard comments, including during macro expansion. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5071 |
like \fB\-C\fR, except that comments contained within macros are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5072 |
also passed through to the output file where the macro is expanded. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5073 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5074 |
In addition to the side-effects of the \fB\-C\fR option, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5075 |
\&\fB\-CC\fR option causes all \*(C+\-style comments inside a macro |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5076 |
to be converted to C-style comments. This is to prevent later use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5077 |
of that macro from inadvertently commenting out the remainder of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5078 |
the source line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5079 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5080 |
The \fB\-CC\fR option is generally used to support lint comments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5081 |
.Ip "\fB\-traditional-cpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5082 |
.IX Item "-traditional-cpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5083 |
Try to imitate the behavior of old-fashioned C preprocessors, as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5084 |
opposed to \s-1ISO\s0 C preprocessors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5085 |
.Ip "\fB\-trigraphs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5086 |
.IX Item "-trigraphs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5087 |
Process trigraph sequences. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5088 |
These are three-character sequences, all starting with \fB??\fR, that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5089 |
are defined by \s-1ISO\s0 C to stand for single characters. For example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5090 |
\&\fB??/\fR stands for \fB\e\fR, so \fB'??/n'\fR is a character |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5091 |
constant for a newline. By default, \s-1GCC\s0 ignores trigraphs, but in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5092 |
standard-conforming modes it converts them. See the \fB\-std\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5093 |
\&\fB\-ansi\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5094 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5095 |
The nine trigraphs and their replacements are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5096 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5097 |
.Vb 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5098 |
\& Trigraph: ??( ??) ??< ??> ??= ??/ ??' ??! ??- |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5099 |
\& Replacement: [ ] { } # \e ^ | ~ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5100 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5101 |
.Ip "\fB\-remap\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5102 |
.IX Item "-remap" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5103 |
Enable special code to work around file systems which only permit very |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5104 |
short file names, such as \s-1MS-DOS\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5105 |
.Ip "\fB\*(--help\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5106 |
.IX Item "help" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5107 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5108 |
.Ip "\fB\*(--target-help\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5109 |
.IX Item "target-help" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5110 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5111 |
Print text describing all the command line options instead of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5112 |
preprocessing anything. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5113 |
.Ip "\fB\-v\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5114 |
.IX Item "-v" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5115 |
Verbose mode. Print out \s-1GNU\s0 \s-1CPP\s0's version number at the beginning of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5116 |
execution, and report the final form of the include path. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5117 |
.Ip "\fB\-H\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5118 |
.IX Item "-H" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5119 |
Print the name of each header file used, in addition to other normal |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5120 |
activities. Each name is indented to show how deep in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5121 |
\&\fB#include\fR stack it is. Precompiled header files are also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5122 |
printed, even if they are found to be invalid; an invalid precompiled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5123 |
header file is printed with \fB...x\fR and a valid one with \fB...!\fR . |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5124 |
.Ip "\fB\-version\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5125 |
.IX Item "-version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5126 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5127 |
.Ip "\fB\*(--version\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5128 |
.IX Item "version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5129 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5130 |
Print out \s-1GNU\s0 \s-1CPP\s0's version number. With one dash, proceed to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5131 |
preprocess as normal. With two dashes, exit immediately. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5132 |
.Sh "Passing Options to the Assembler" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5133 |
.IX Subsection "Passing Options to the Assembler" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5134 |
You can pass options to the assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5135 |
.Ip "\fB\-Wa,\fR\fIoption\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5136 |
.IX Item "-Wa,option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5137 |
Pass \fIoption\fR as an option to the assembler. If \fIoption\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5138 |
contains commas, it is split into multiple options at the commas. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5139 |
.Ip "\fB\-Xassembler\fR \fIoption\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5140 |
.IX Item "-Xassembler option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5141 |
Pass \fIoption\fR as an option to the assembler. You can use this to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5142 |
supply system-specific assembler options which \s-1GCC\s0 does not know how to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5143 |
recognize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5144 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5145 |
If you want to pass an option that takes an argument, you must use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5146 |
\&\fB\-Xassembler\fR twice, once for the option and once for the argument. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5147 |
.Sh "Options for Linking" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5148 |
.IX Subsection "Options for Linking" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5149 |
These options come into play when the compiler links object files into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5150 |
an executable output file. They are meaningless if the compiler is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5151 |
not doing a link step. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5152 |
.Ip "\fIobject-file-name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5153 |
.IX Item "object-file-name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5154 |
A file name that does not end in a special recognized suffix is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5155 |
considered to name an object file or library. (Object files are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5156 |
distinguished from libraries by the linker according to the file |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5157 |
contents.) If linking is done, these object files are used as input |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5158 |
to the linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5159 |
.Ip "\fB\-c\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5160 |
.IX Item "-c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5161 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5162 |
.Ip "\fB\-S\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5163 |
.IX Item "-S" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5164 |
.Ip "\fB\-E\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5165 |
.IX Item "-E" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5166 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5167 |
If any of these options is used, then the linker is not run, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5168 |
object file names should not be used as arguments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5169 |
.Ip "\fB\-l\fR\fIlibrary\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5170 |
.IX Item "-llibrary" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5171 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5172 |
.Ip "\fB\-l\fR \fIlibrary\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5173 |
.IX Item "-l library" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5174 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5175 |
Search the library named \fIlibrary\fR when linking. (The second |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5176 |
alternative with the library as a separate argument is only for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5177 |
\&\s-1POSIX\s0 compliance and is not recommended.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5178 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5179 |
It makes a difference where in the command you write this option; the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5180 |
linker searches and processes libraries and object files in the order they |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5181 |
are specified. Thus, \fBfoo.o \-lz bar.o\fR searches library \fBz\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5182 |
after file \fIfoo.o\fR but before \fIbar.o\fR. If \fIbar.o\fR refers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5183 |
to functions in \fBz\fR, those functions may not be loaded. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5184 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5185 |
The linker searches a standard list of directories for the library, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5186 |
which is actually a file named \fIlib\fIlibrary\fI.a\fR. The linker |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5187 |
then uses this file as if it had been specified precisely by name. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5188 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5189 |
The directories searched include several standard system directories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5190 |
plus any that you specify with \fB\-L\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5191 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5192 |
Normally the files found this way are library files\-\-\-archive files |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5193 |
whose members are object files. The linker handles an archive file by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5194 |
scanning through it for members which define symbols that have so far |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5195 |
been referenced but not defined. But if the file that is found is an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5196 |
ordinary object file, it is linked in the usual fashion. The only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5197 |
difference between using an \fB\-l\fR option and specifying a file name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5198 |
is that \fB\-l\fR surrounds \fIlibrary\fR with \fBlib\fR and \fB.a\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5199 |
and searches several directories. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5200 |
.Ip "\fB\-lobjc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5201 |
.IX Item "-lobjc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5202 |
You need this special case of the \fB\-l\fR option in order to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5203 |
link an Objective-C program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5204 |
.Ip "\fB\-nostartfiles\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5205 |
.IX Item "-nostartfiles" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5206 |
Do not use the standard system startup files when linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5207 |
The standard system libraries are used normally, unless \fB\-nostdlib\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5208 |
or \fB\-nodefaultlibs\fR is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5209 |
.Ip "\fB\-nodefaultlibs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5210 |
.IX Item "-nodefaultlibs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5211 |
Do not use the standard system libraries when linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5212 |
Only the libraries you specify will be passed to the linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5213 |
The standard startup files are used normally, unless \fB\-nostartfiles\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5214 |
is used. The compiler may generate calls to memcmp, memset, and memcpy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5215 |
for System V (and \s-1ISO\s0 C) environments or to bcopy and bzero for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5216 |
\&\s-1BSD\s0 environments. These entries are usually resolved by entries in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5217 |
libc. These entry points should be supplied through some other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5218 |
mechanism when this option is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5219 |
.Ip "\fB\-nostdlib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5220 |
.IX Item "-nostdlib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5221 |
Do not use the standard system startup files or libraries when linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5222 |
No startup files and only the libraries you specify will be passed to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5223 |
the linker. The compiler may generate calls to memcmp, memset, and memcpy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5224 |
for System V (and \s-1ISO\s0 C) environments or to bcopy and bzero for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5225 |
\&\s-1BSD\s0 environments. These entries are usually resolved by entries in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5226 |
libc. These entry points should be supplied through some other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5227 |
mechanism when this option is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5228 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5229 |
One of the standard libraries bypassed by \fB\-nostdlib\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5230 |
\&\fB\-nodefaultlibs\fR is \fIlibgcc.a\fR, a library of internal subroutines |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5231 |
that \s-1GCC\s0 uses to overcome shortcomings of particular machines, or special |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5232 |
needs for some languages. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5233 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5234 |
In most cases, you need \fIlibgcc.a\fR even when you want to avoid |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5235 |
other standard libraries. In other words, when you specify \fB\-nostdlib\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5236 |
or \fB\-nodefaultlibs\fR you should usually specify \fB\-lgcc\fR as well. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5237 |
This ensures that you have no unresolved references to internal \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5238 |
library subroutines. (For example, \fB_\|_main\fR, used to ensure \*(C+ |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5239 |
constructors will be called.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5240 |
.Ip "\fB\-pie\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5241 |
.IX Item "-pie" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5242 |
Produce a position independent executable on targets which support it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5243 |
For predictable results, you must also specify the same set of options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5244 |
that were used to generate code (\fB\-fpie\fR, \fB\-fPIE\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5245 |
or model suboptions) when you specify this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5246 |
.Ip "\fB\-s\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5247 |
.IX Item "-s" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5248 |
Remove all symbol table and relocation information from the executable. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5249 |
.Ip "\fB\-static\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5250 |
.IX Item "-static" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5251 |
On systems that support dynamic linking, this prevents linking with the shared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5252 |
libraries. On other systems, this option has no effect. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5253 |
.Ip "\fB\-shared\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5254 |
.IX Item "-shared" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5255 |
Produce a shared object which can then be linked with other objects to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5256 |
form an executable. Not all systems support this option. For predictable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5257 |
results, you must also specify the same set of options that were used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5258 |
generate code (\fB\-fpic\fR, \fB\-fPIC\fR, or model suboptions) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5259 |
when you specify this option.[1] |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5260 |
.Ip "\fB\-shared-libgcc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5261 |
.IX Item "-shared-libgcc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5262 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5263 |
.Ip "\fB\-static-libgcc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5264 |
.IX Item "-static-libgcc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5265 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5266 |
On systems that provide \fIlibgcc\fR as a shared library, these options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5267 |
force the use of either the shared or static version respectively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5268 |
If no shared version of \fIlibgcc\fR was built when the compiler was |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5269 |
configured, these options have no effect. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5270 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5271 |
There are several situations in which an application should use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5272 |
shared \fIlibgcc\fR instead of the static version. The most common |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5273 |
of these is when the application wishes to throw and catch exceptions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5274 |
across different shared libraries. In that case, each of the libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5275 |
as well as the application itself should use the shared \fIlibgcc\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5276 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5277 |
Therefore, the G++ and \s-1GCJ\s0 drivers automatically add |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5278 |
\&\fB\-shared-libgcc\fR whenever you build a shared library or a main |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5279 |
executable, because \*(C+ and Java programs typically use exceptions, so |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5280 |
this is the right thing to do. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5281 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5282 |
If, instead, you use the \s-1GCC\s0 driver to create shared libraries, you may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5283 |
find that they will not always be linked with the shared \fIlibgcc\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5284 |
If \s-1GCC\s0 finds, at its configuration time, that you have a non-GNU linker |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5285 |
or a \s-1GNU\s0 linker that does not support option \fB\*(--eh-frame-hdr\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5286 |
it will link the shared version of \fIlibgcc\fR into shared libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5287 |
by default. Otherwise, it will take advantage of the linker and optimize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5288 |
away the linking with the shared version of \fIlibgcc\fR, linking with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5289 |
the static version of libgcc by default. This allows exceptions to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5290 |
propagate through such shared libraries, without incurring relocation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5291 |
costs at library load time. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5292 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5293 |
However, if a library or main executable is supposed to throw or catch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5294 |
exceptions, you must link it using the G++ or \s-1GCJ\s0 driver, as appropriate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5295 |
for the languages used in the program, or using the option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5296 |
\&\fB\-shared-libgcc\fR, such that it is linked with the shared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5297 |
\&\fIlibgcc\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5298 |
.Ip "\fB\-symbolic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5299 |
.IX Item "-symbolic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5300 |
Bind references to global symbols when building a shared object. Warn |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5301 |
about any unresolved references (unless overridden by the link editor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5302 |
option \fB\-Xlinker \-z \-Xlinker defs\fR). Only a few systems support |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5303 |
this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5304 |
.Ip "\fB\-Xlinker\fR \fIoption\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5305 |
.IX Item "-Xlinker option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5306 |
Pass \fIoption\fR as an option to the linker. You can use this to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5307 |
supply system-specific linker options which \s-1GCC\s0 does not know how to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5308 |
recognize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5309 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5310 |
If you want to pass an option that takes an argument, you must use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5311 |
\&\fB\-Xlinker\fR twice, once for the option and once for the argument. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5312 |
For example, to pass \fB\-assert definitions\fR, you must write |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5313 |
\&\fB\-Xlinker \-assert \-Xlinker definitions\fR. It does not work to write |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5314 |
\&\fB\-Xlinker \*(L"\-assert definitions\*(R"\fR, because this passes the entire |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5315 |
string as a single argument, which is not what the linker expects. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5316 |
.Ip "\fB\-Wl,\fR\fIoption\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5317 |
.IX Item "-Wl,option" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5318 |
Pass \fIoption\fR as an option to the linker. If \fIoption\fR contains |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5319 |
commas, it is split into multiple options at the commas. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5320 |
.Ip "\fB\-u\fR \fIsymbol\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5321 |
.IX Item "-u symbol" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5322 |
Pretend the symbol \fIsymbol\fR is undefined, to force linking of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5323 |
library modules to define it. You can use \fB\-u\fR multiple times with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5324 |
different symbols to force loading of additional library modules. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5325 |
.Sh "Options for Directory Search" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5326 |
.IX Subsection "Options for Directory Search" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5327 |
These options specify directories to search for header files, for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5328 |
libraries and for parts of the compiler: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5329 |
.Ip "\fB\-I\fR\fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5330 |
.IX Item "-Idir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5331 |
Add the directory \fIdir\fR to the head of the list of directories to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5332 |
searched for header files. This can be used to override a system header |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5333 |
file, substituting your own version, since these directories are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5334 |
searched before the system header file directories. However, you should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5335 |
not use this option to add directories that contain vendor-supplied |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5336 |
system header files (use \fB\-isystem\fR for that). If you use more than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5337 |
one \fB\-I\fR option, the directories are scanned in left-to-right |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5338 |
order; the standard system directories come after. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5339 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5340 |
If a standard system include directory, or a directory specified with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5341 |
\&\fB\-isystem\fR, is also specified with \fB\-I\fR, the \fB\-I\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5342 |
option will be ignored. The directory will still be searched but as a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5343 |
system directory at its normal position in the system include chain. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5344 |
This is to ensure that \s-1GCC\s0's procedure to fix buggy system headers and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5345 |
the ordering for the include_next directive are not inadvertently changed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5346 |
If you really need to change the search order for system directories, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5347 |
use the \fB\-nostdinc\fR and/or \fB\-isystem\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5348 |
.Ip "\fB\-I-\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5349 |
.IX Item "-I-" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5350 |
Any directories you specify with \fB\-I\fR options before the \fB\-I-\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5351 |
option are searched only for the case of \fB#include "\fR\fIfile\fR\fB"\fR; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5352 |
they are not searched for \fB#include <\fR\fIfile\fR\fB>\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5353 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5354 |
If additional directories are specified with \fB\-I\fR options after |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5355 |
the \fB\-I-\fR, these directories are searched for all \fB#include\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5356 |
directives. (Ordinarily \fIall\fR \fB\-I\fR directories are used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5357 |
this way.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5358 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5359 |
In addition, the \fB\-I-\fR option inhibits the use of the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5360 |
directory (where the current input file came from) as the first search |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5361 |
directory for \fB#include "\fR\fIfile\fR\fB"\fR. There is no way to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5362 |
override this effect of \fB\-I-\fR. With \fB\-I.\fR you can specify |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5363 |
searching the directory which was current when the compiler was |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5364 |
invoked. That is not exactly the same as what the preprocessor does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5365 |
by default, but it is often satisfactory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5366 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5367 |
\&\fB\-I-\fR does not inhibit the use of the standard system directories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5368 |
for header files. Thus, \fB\-I-\fR and \fB\-nostdinc\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5369 |
independent. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5370 |
.Ip "\fB\-L\fR\fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5371 |
.IX Item "-Ldir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5372 |
Add directory \fIdir\fR to the list of directories to be searched |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5373 |
for \fB\-l\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5374 |
.Ip "\fB\-B\fR\fIprefix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5375 |
.IX Item "-Bprefix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5376 |
This option specifies where to find the executables, libraries, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5377 |
include files, and data files of the compiler itself. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5378 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5379 |
The compiler driver program runs one or more of the subprograms |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5380 |
\&\fIcpp\fR, \fIcc1\fR, \fIas\fR and \fIld\fR. It tries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5381 |
\&\fIprefix\fR as a prefix for each program it tries to run, both with and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5382 |
without \fImachine\fR\fB/\fR\fIversion\fR\fB/\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5383 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5384 |
For each subprogram to be run, the compiler driver first tries the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5385 |
\&\fB\-B\fR prefix, if any. If that name is not found, or if \fB\-B\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5386 |
was not specified, the driver tries two standard prefixes, which are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5387 |
\&\fI/usr/lib/gcc/\fR and \fI/usr/local/lib/gcc/\fR. If neither of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5388 |
those results in a file name that is found, the unmodified program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5389 |
name is searched for using the directories specified in your |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5390 |
\&\fB\s-1PATH\s0\fR environment variable. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5391 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5392 |
The compiler will check to see if the path provided by the \fB\-B\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5393 |
refers to a directory, and if necessary it will add a directory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5394 |
separator character at the end of the path. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5395 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5396 |
\&\fB\-B\fR prefixes that effectively specify directory names also apply |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5397 |
to libraries in the linker, because the compiler translates these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5398 |
options into \fB\-L\fR options for the linker. They also apply to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5399 |
includes files in the preprocessor, because the compiler translates these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5400 |
options into \fB\-isystem\fR options for the preprocessor. In this case, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5401 |
the compiler appends \fBinclude\fR to the prefix. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5402 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5403 |
The run-time support file \fIlibgcc.a\fR can also be searched for using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5404 |
the \fB\-B\fR prefix, if needed. If it is not found there, the two |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5405 |
standard prefixes above are tried, and that is all. The file is left |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5406 |
out of the link if it is not found by those means. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5407 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5408 |
Another way to specify a prefix much like the \fB\-B\fR prefix is to use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5409 |
the environment variable \fB\s-1GCC_EXEC_PREFIX\s0\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5410 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5411 |
As a special kludge, if the path provided by \fB\-B\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5412 |
\&\fI[dir/]stage\fIN\fI/\fR, where \fIN\fR is a number in the range 0 to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5413 |
9, then it will be replaced by \fI[dir/]include\fR. This is to help |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5414 |
with boot-strapping the compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5415 |
.Ip "\fB\-specs=\fR\fIfile\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5416 |
.IX Item "-specs=file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5417 |
Process \fIfile\fR after the compiler reads in the standard \fIspecs\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5418 |
file, in order to override the defaults that the \fIgcc\fR driver |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5419 |
program uses when determining what switches to pass to \fIcc1\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5420 |
\&\fIcc1plus\fR, \fIas\fR, \fIld\fR, etc. More than one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5421 |
\&\fB\-specs=\fR\fIfile\fR can be specified on the command line, and they |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5422 |
are processed in order, from left to right. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5423 |
.Sh "Specifying Target Machine and Compiler Version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5424 |
.IX Subsection "Specifying Target Machine and Compiler Version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5425 |
The usual way to run \s-1GCC\s0 is to run the executable called \fIgcc\fR, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5426 |
\&\fI<machine>\-gcc\fR when cross-compiling, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5427 |
\&\fI<machine>\-gcc-<version>\fR to run a version other than the one that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5428 |
was installed last. Sometimes this is inconvenient, so \s-1GCC\s0 provides |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5429 |
options that will switch to another cross-compiler or version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5430 |
.Ip "\fB\-b\fR \fImachine\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5431 |
.IX Item "-b machine" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5432 |
The argument \fImachine\fR specifies the target machine for compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5433 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5434 |
The value to use for \fImachine\fR is the same as was specified as the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5435 |
machine type when configuring \s-1GCC\s0 as a cross-compiler. For |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5436 |
example, if a cross-compiler was configured with \fBconfigure |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5437 |
i386v\fR, meaning to compile for an 80386 running System V, then you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5438 |
would specify \fB\-b i386v\fR to run that cross compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5439 |
.Ip "\fB\-V\fR \fIversion\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5440 |
.IX Item "-V version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5441 |
The argument \fIversion\fR specifies which version of \s-1GCC\s0 to run. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5442 |
This is useful when multiple versions are installed. For example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5443 |
\&\fIversion\fR might be \fB2.0\fR, meaning to run \s-1GCC\s0 version 2.0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5444 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5445 |
The \fB\-V\fR and \fB\-b\fR options work by running the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5446 |
\&\fI<machine>\-gcc-<version>\fR executable, so there's no real reason to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5447 |
use them if you can just run that directly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5448 |
.Sh "Hardware Models and Configurations" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5449 |
.IX Subsection "Hardware Models and Configurations" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5450 |
Earlier we discussed the standard option \fB\-b\fR which chooses among |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5451 |
different installed compilers for completely different target |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5452 |
machines, such as \s-1VAX\s0 vs. 68000 vs. 80386. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5453 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5454 |
In addition, each of these target machine types can have its own |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5455 |
special options, starting with \fB\-m\fR, to choose among various |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5456 |
hardware models or configurations\-\-\-for example, 68010 vs 68020, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5457 |
floating coprocessor or none. A single installed version of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5458 |
compiler can compile for any model or configuration, according to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5459 |
options specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5460 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5461 |
Some configurations of the compiler also support additional special |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5462 |
options, usually for compatibility with other compilers on the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5463 |
platform. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5464 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5465 |
These options are defined by the macro \f(CW\*(C`TARGET_SWITCHES\*(C'\fR in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5466 |
machine description. The default for the options is also defined by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5467 |
that macro, which enables you to change the defaults. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5468 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5469 |
.I "M680x0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5470 |
.IX Subsection "M680x0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5471 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5472 |
These are the \fB\-m\fR options defined for the 68000 series. The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5473 |
values for these options depends on which style of 68000 was selected when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5474 |
the compiler was configured; the defaults for the most common choices are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5475 |
given below. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5476 |
.Ip "\fB\-m68000\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5477 |
.IX Item "-m68000" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5478 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5479 |
.Ip "\fB\-mc68000\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5480 |
.IX Item "-mc68000" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5481 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5482 |
Generate output for a 68000. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5483 |
when the compiler is configured for 68000\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5484 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5485 |
Use this option for microcontrollers with a 68000 or \s-1EC000\s0 core, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5486 |
including the 68008, 68302, 68306, 68307, 68322, 68328 and 68356. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5487 |
.Ip "\fB\-m68020\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5488 |
.IX Item "-m68020" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5489 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5490 |
.Ip "\fB\-mc68020\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5491 |
.IX Item "-mc68020" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5492 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5493 |
Generate output for a 68020. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5494 |
when the compiler is configured for 68020\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5495 |
.Ip "\fB\-m68881\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5496 |
.IX Item "-m68881" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5497 |
Generate output containing 68881 instructions for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5498 |
This is the default for most 68020 systems unless \fB\*(--nfp\fR was |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5499 |
specified when the compiler was configured. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5500 |
.Ip "\fB\-m68030\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5501 |
.IX Item "-m68030" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5502 |
Generate output for a 68030. This is the default when the compiler is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5503 |
configured for 68030\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5504 |
.Ip "\fB\-m68040\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5505 |
.IX Item "-m68040" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5506 |
Generate output for a 68040. This is the default when the compiler is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5507 |
configured for 68040\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5508 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5509 |
This option inhibits the use of 68881/68882 instructions that have to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5510 |
emulated by software on the 68040. Use this option if your 68040 does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5511 |
have code to emulate those instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5512 |
.Ip "\fB\-m68060\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5513 |
.IX Item "-m68060" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5514 |
Generate output for a 68060. This is the default when the compiler is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5515 |
configured for 68060\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5516 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5517 |
This option inhibits the use of 68020 and 68881/68882 instructions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5518 |
have to be emulated by software on the 68060. Use this option if your 68060 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5519 |
does not have code to emulate those instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5520 |
.Ip "\fB\-mcpu32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5521 |
.IX Item "-mcpu32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5522 |
Generate output for a \s-1CPU32\s0. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5523 |
when the compiler is configured for CPU32\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5524 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5525 |
Use this option for microcontrollers with a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5526 |
\&\s-1CPU32\s0 or \s-1CPU32+\s0 core, including the 68330, 68331, 68332, 68333, 68334, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5527 |
68336, 68340, 68341, 68349 and 68360. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5528 |
.Ip "\fB\-m5200\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5529 |
.IX Item "-m5200" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5530 |
Generate output for a 520X ``coldfire'' family cpu. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5531 |
when the compiler is configured for 520X-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5532 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5533 |
Use this option for microcontroller with a 5200 core, including |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5534 |
the \s-1MCF5202\s0, \s-1MCF5203\s0, \s-1MCF5204\s0 and \s-1MCF5202\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5535 |
.Ip "\fB\-m68020\-40\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5536 |
.IX Item "-m68020-40" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5537 |
Generate output for a 68040, without using any of the new instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5538 |
This results in code which can run relatively efficiently on either a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5539 |
68020/68881 or a 68030 or a 68040. The generated code does use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5540 |
68881 instructions that are emulated on the 68040. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5541 |
.Ip "\fB\-m68020\-60\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5542 |
.IX Item "-m68020-60" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5543 |
Generate output for a 68060, without using any of the new instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5544 |
This results in code which can run relatively efficiently on either a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5545 |
68020/68881 or a 68030 or a 68040. The generated code does use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5546 |
68881 instructions that are emulated on the 68060. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5547 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5548 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5549 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5550 |
\&\fBWarning:\fR the requisite libraries are not available for all m68k |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5551 |
targets. Normally the facilities of the machine's usual C compiler are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5552 |
used, but this can't be done directly in cross-compilation. You must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5553 |
make your own arrangements to provide suitable library functions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5554 |
cross-compilation. The embedded targets \fBm68k-*\-aout\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5555 |
\&\fBm68k-*\-coff\fR do provide software floating point support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5556 |
.Ip "\fB\-mshort\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5557 |
.IX Item "-mshort" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5558 |
Consider type \f(CW\*(C`int\*(C'\fR to be 16 bits wide, like \f(CW\*(C`short int\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5559 |
.Ip "\fB\-mnobitfield\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5560 |
.IX Item "-mnobitfield" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5561 |
Do not use the bit-field instructions. The \fB\-m68000\fR, \fB\-mcpu32\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5562 |
and \fB\-m5200\fR options imply \fB\-mnobitfield\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5563 |
.Ip "\fB\-mbitfield\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5564 |
.IX Item "-mbitfield" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5565 |
Do use the bit-field instructions. The \fB\-m68020\fR option implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5566 |
\&\fB\-mbitfield\fR. This is the default if you use a configuration |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5567 |
designed for a 68020. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5568 |
.Ip "\fB\-mrtd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5569 |
.IX Item "-mrtd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5570 |
Use a different function-calling convention, in which functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5571 |
that take a fixed number of arguments return with the \f(CW\*(C`rtd\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5572 |
instruction, which pops their arguments while returning. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5573 |
saves one instruction in the caller since there is no need to pop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5574 |
the arguments there. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5575 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5576 |
\&\fBWarning:\fR this calling convention is incompatible with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5577 |
one normally used on Unix or with \s-1GCC\s0, so you cannot use it if you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5578 |
need to call libraries compiled with the Unix compiler or with \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5579 |
without the switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5580 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5581 |
Also, you must provide function prototypes for all functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5582 |
take variable numbers of arguments (including \f(CW\*(C`printf\*(C'\fR); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5583 |
otherwise incorrect code will be generated for calls to those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5584 |
functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5585 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5586 |
In addition, seriously incorrect code will result if you call a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5587 |
function with too many arguments. (Normally, extra arguments are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5588 |
harmlessly ignored.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5589 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5590 |
The \f(CW\*(C`rtd\*(C'\fR instruction is supported by the 68010, 68020, 68030, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5591 |
68040, 68060 and \s-1CPU32\s0 processors, but not by the 68000 or 5200. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5592 |
.Ip "\fB\-malign-int\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5593 |
.IX Item "-malign-int" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5594 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5595 |
.Ip "\fB\-mno-align-int\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5596 |
.IX Item "-mno-align-int" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5597 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5598 |
Control whether \s-1GCC\s0 aligns \f(CW\*(C`int\*(C'\fR, \f(CW\*(C`long\*(C'\fR, \f(CW\*(C`long long\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5599 |
\&\f(CW\*(C`float\*(C'\fR, \f(CW\*(C`double\*(C'\fR, and \f(CW\*(C`long double\*(C'\fR variables on a 32\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5600 |
boundary (\fB\-malign-int\fR) or a 16\-bit boundary (\fB\-mno-align-int\fR). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5601 |
Aligning variables on 32\-bit boundaries produces code that runs somewhat |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5602 |
faster on processors with 32\-bit busses at the expense of more memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5603 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5604 |
\&\fBWarning:\fR if you use the \fB\-malign-int\fR switch, \s-1GCC\s0 will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5605 |
align structures containing the above types differently than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5606 |
most published application binary interface specifications for the m68k. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5607 |
.Ip "\fB\-mpcrel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5608 |
.IX Item "-mpcrel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5609 |
Use the pc-relative addressing mode of the 68000 directly, instead of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5610 |
using a global offset table. At present, this option implies \fB\-fpic\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5611 |
allowing at most a 16\-bit offset for pc-relative addressing. \fB\-fPIC\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5612 |
not presently supported with \fB\-mpcrel\fR, though this could be supported for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5613 |
68020 and higher processors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5614 |
.Ip "\fB\-mno-strict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5615 |
.IX Item "-mno-strict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5616 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5617 |
.Ip "\fB\-mstrict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5618 |
.IX Item "-mstrict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5619 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5620 |
Do not (do) assume that unaligned memory references will be handled by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5621 |
the system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5622 |
.Ip "\fB\-msep-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5623 |
.IX Item "-msep-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5624 |
Generate code that allows the data segment to be located in a different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5625 |
area of memory from the text segment. This allows for execute in place in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5626 |
an environment without virtual memory management. This option implies \-fPIC. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5627 |
.Ip "\fB\-mno-sep-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5628 |
.IX Item "-mno-sep-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5629 |
Generate code that assumes that the data segment follows the text segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5630 |
This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5631 |
.Ip "\fB\-mid-shared-library\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5632 |
.IX Item "-mid-shared-library" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5633 |
Generate code that supports shared libraries via the library \s-1ID\s0 method. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5634 |
This allows for execute in place and shared libraries in an environment |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5635 |
without virtual memory management. This option implies \-fPIC. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5636 |
.Ip "\fB\-mno-id-shared-library\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5637 |
.IX Item "-mno-id-shared-library" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5638 |
Generate code that doesn't assume \s-1ID\s0 based shared libraries are being used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5639 |
This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5640 |
.Ip "\fB\-mshared-library-id=n\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5641 |
.IX Item "-mshared-library-id=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5642 |
Specified the identification number of the \s-1ID\s0 based shared library being |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5643 |
compiled. Specifying a value of 0 will generate more compact code, specifying |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5644 |
other values will force the allocation of that number to the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5645 |
library but is no more space or time efficient than omitting this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5646 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5647 |
.I "M68hc1x Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5648 |
.IX Subsection "M68hc1x Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5649 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5650 |
These are the \fB\-m\fR options defined for the 68hc11 and 68hc12 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5651 |
microcontrollers. The default values for these options depends on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5652 |
which style of microcontroller was selected when the compiler was configured; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5653 |
the defaults for the most common choices are given below. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5654 |
.Ip "\fB\-m6811\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5655 |
.IX Item "-m6811" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5656 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5657 |
.Ip "\fB\-m68hc11\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5658 |
.IX Item "-m68hc11" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5659 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5660 |
Generate output for a 68HC11. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5661 |
when the compiler is configured for 68HC11\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5662 |
.Ip "\fB\-m6812\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5663 |
.IX Item "-m6812" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5664 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5665 |
.Ip "\fB\-m68hc12\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5666 |
.IX Item "-m68hc12" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5667 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5668 |
Generate output for a 68HC12. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5669 |
when the compiler is configured for 68HC12\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5670 |
.Ip "\fB\-m68S12\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5671 |
.IX Item "-m68S12" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5672 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5673 |
.Ip "\fB\-m68hcs12\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5674 |
.IX Item "-m68hcs12" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5675 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5676 |
Generate output for a 68HCS12. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5677 |
.Ip "\fB\-mauto-incdec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5678 |
.IX Item "-mauto-incdec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5679 |
Enable the use of 68HC12 pre and post auto-increment and auto-decrement |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5680 |
addressing modes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5681 |
.Ip "\fB\-minmax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5682 |
.IX Item "-minmax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5683 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5684 |
.Ip "\fB\-nominmax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5685 |
.IX Item "-nominmax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5686 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5687 |
Enable the use of 68HC12 min and max instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5688 |
.Ip "\fB\-mlong-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5689 |
.IX Item "-mlong-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5690 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5691 |
.Ip "\fB\-mno-long-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5692 |
.IX Item "-mno-long-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5693 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5694 |
Treat all calls as being far away (near). If calls are assumed to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5695 |
far away, the compiler will use the \f(CW\*(C`call\*(C'\fR instruction to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5696 |
call a function and the \f(CW\*(C`rtc\*(C'\fR instruction for returning. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5697 |
.Ip "\fB\-mshort\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5698 |
.IX Item "-mshort" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5699 |
Consider type \f(CW\*(C`int\*(C'\fR to be 16 bits wide, like \f(CW\*(C`short int\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5700 |
.Ip "\fB\-msoft-reg-count=\fR\fIcount\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5701 |
.IX Item "-msoft-reg-count=count" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5702 |
Specify the number of pseudo-soft registers which are used for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5703 |
code generation. The maximum number is 32. Using more pseudo-soft |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5704 |
register may or may not result in better code depending on the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5705 |
The default is 4 for 68HC11 and 2 for 68HC12. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5706 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5707 |
.I "\s-1VAX\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5708 |
.IX Subsection "VAX Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5709 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5710 |
These \fB\-m\fR options are defined for the \s-1VAX:\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5711 |
.Ip "\fB\-munix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5712 |
.IX Item "-munix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5713 |
Do not output certain jump instructions (\f(CW\*(C`aobleq\*(C'\fR and so on) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5714 |
that the Unix assembler for the \s-1VAX\s0 cannot handle across long |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5715 |
ranges. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5716 |
.Ip "\fB\-mgnu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5717 |
.IX Item "-mgnu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5718 |
Do output those jump instructions, on the assumption that you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5719 |
will assemble with the \s-1GNU\s0 assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5720 |
.Ip "\fB\-mg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5721 |
.IX Item "-mg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5722 |
Output code for g-format floating point numbers instead of d-format. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5723 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5724 |
.I "\s-1SPARC\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5725 |
.IX Subsection "SPARC Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5726 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5727 |
These \fB\-m\fR options are supported on the \s-1SPARC:\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5728 |
.Ip "\fB\-mno-app-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5729 |
.IX Item "-mno-app-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5730 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5731 |
.Ip "\fB\-mapp-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5732 |
.IX Item "-mapp-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5733 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5734 |
Specify \fB\-mapp-regs\fR to generate output using the global registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5735 |
2 through 4, which the \s-1SPARC\s0 \s-1SVR4\s0 \s-1ABI\s0 reserves for applications. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5736 |
is the default, except on Solaris. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5737 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5738 |
To be fully \s-1SVR4\s0 \s-1ABI\s0 compliant at the cost of some performance loss, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5739 |
specify \fB\-mno-app-regs\fR. You should compile libraries and system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5740 |
software with this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5741 |
.Ip "\fB\-mfpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5742 |
.IX Item "-mfpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5743 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5744 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5745 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5746 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5747 |
Generate output containing floating point instructions. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5748 |
default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5749 |
.Ip "\fB\-mno-fpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5750 |
.IX Item "-mno-fpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5751 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5752 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5753 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5754 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5755 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5756 |
\&\fBWarning:\fR the requisite libraries are not available for all \s-1SPARC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5757 |
targets. Normally the facilities of the machine's usual C compiler are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5758 |
used, but this cannot be done directly in cross-compilation. You must make |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5759 |
your own arrangements to provide suitable library functions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5760 |
cross-compilation. The embedded targets \fBsparc-*\-aout\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5761 |
\&\fBsparclite-*\-*\fR do provide software floating point support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5762 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5763 |
\&\fB\-msoft-float\fR changes the calling convention in the output file; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5764 |
therefore, it is only useful if you compile \fIall\fR of a program with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5765 |
this option. In particular, you need to compile \fIlibgcc.a\fR, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5766 |
library that comes with \s-1GCC\s0, with \fB\-msoft-float\fR in order for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5767 |
this to work. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5768 |
.Ip "\fB\-mhard-quad-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5769 |
.IX Item "-mhard-quad-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5770 |
Generate output containing quad-word (long double) floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5771 |
instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5772 |
.Ip "\fB\-msoft-quad-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5773 |
.IX Item "-msoft-quad-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5774 |
Generate output containing library calls for quad-word (long double) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5775 |
floating point instructions. The functions called are those specified |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5776 |
in the \s-1SPARC\s0 \s-1ABI\s0. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5777 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5778 |
As of this writing, there are no \s-1SPARC\s0 implementations that have hardware |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5779 |
support for the quad-word floating point instructions. They all invoke |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5780 |
a trap handler for one of these instructions, and then the trap handler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5781 |
emulates the effect of the instruction. Because of the trap handler overhead, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5782 |
this is much slower than calling the \s-1ABI\s0 library routines. Thus the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5783 |
\&\fB\-msoft-quad-float\fR option is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5784 |
.Ip "\fB\-mno-flat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5785 |
.IX Item "-mno-flat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5786 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5787 |
.Ip "\fB\-mflat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5788 |
.IX Item "-mflat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5789 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5790 |
With \fB\-mflat\fR, the compiler does not generate save/restore instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5791 |
and will use a ``flat'' or single register window calling convention. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5792 |
This model uses \f(CW%i7\fR as the frame pointer and is compatible with the normal |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5793 |
register window model. Code from either may be intermixed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5794 |
The local registers and the input registers (0\*(--5) are still treated as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5795 |
``call saved'' registers and will be saved on the stack as necessary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5796 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5797 |
With \fB\-mno-flat\fR (the default), the compiler emits save/restore |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5798 |
instructions (except for leaf functions) and is the normal mode of operation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5799 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5800 |
These options are deprecated and will be deleted in a future \s-1GCC\s0 release. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5801 |
.Ip "\fB\-mno-unaligned-doubles\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5802 |
.IX Item "-mno-unaligned-doubles" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5803 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5804 |
.Ip "\fB\-munaligned-doubles\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5805 |
.IX Item "-munaligned-doubles" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5806 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5807 |
Assume that doubles have 8 byte alignment. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5808 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5809 |
With \fB\-munaligned-doubles\fR, \s-1GCC\s0 assumes that doubles have 8 byte |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5810 |
alignment only if they are contained in another type, or if they have an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5811 |
absolute address. Otherwise, it assumes they have 4 byte alignment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5812 |
Specifying this option avoids some rare compatibility problems with code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5813 |
generated by other compilers. It is not the default because it results |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5814 |
in a performance loss, especially for floating point code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5815 |
.Ip "\fB\-mno-faster-structs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5816 |
.IX Item "-mno-faster-structs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5817 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5818 |
.Ip "\fB\-mfaster-structs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5819 |
.IX Item "-mfaster-structs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5820 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5821 |
With \fB\-mfaster-structs\fR, the compiler assumes that structures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5822 |
should have 8 byte alignment. This enables the use of pairs of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5823 |
\&\f(CW\*(C`ldd\*(C'\fR and \f(CW\*(C`std\*(C'\fR instructions for copies in structure |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5824 |
assignment, in place of twice as many \f(CW\*(C`ld\*(C'\fR and \f(CW\*(C`st\*(C'\fR pairs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5825 |
However, the use of this changed alignment directly violates the \s-1SPARC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5826 |
\&\s-1ABI\s0. Thus, it's intended only for use on targets where the developer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5827 |
acknowledges that their resulting code will not be directly in line with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5828 |
the rules of the \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5829 |
.Ip "\fB\-mimpure-text\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5830 |
.IX Item "-mimpure-text" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5831 |
\&\fB\-mimpure-text\fR, used in addition to \fB\-shared\fR, tells |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5832 |
the compiler to not pass \fB\-z text\fR to the linker when linking a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5833 |
shared object. Using this option, you can link position-dependent |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5834 |
code into a shared object. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5835 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5836 |
\&\fB\-mimpure-text\fR suppresses the ``relocations remain against |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5837 |
allocatable but non-writable sections'' linker error message. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5838 |
However, the necessary relocations will trigger copy-on-write, and the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5839 |
shared object is not actually shared across processes. Instead of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5840 |
using \fB\-mimpure-text\fR, you should compile all source code with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5841 |
\&\fB\-fpic\fR or \fB\-fPIC\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5842 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5843 |
This option is only available on SunOS and Solaris. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5844 |
.Ip "\fB\-mv8\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5845 |
.IX Item "-mv8" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5846 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5847 |
.Ip "\fB\-msparclite\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5848 |
.IX Item "-msparclite" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5849 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5850 |
These two options select variations on the \s-1SPARC\s0 architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5851 |
These options are deprecated and will be deleted in a future \s-1GCC\s0 release. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5852 |
They have been replaced with \fB\-mcpu=xxx\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5853 |
.Ip "\fB\-mcypress\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5854 |
.IX Item "-mcypress" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5855 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5856 |
.Ip "\fB\-msupersparc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5857 |
.IX Item "-msupersparc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5858 |
.Ip "\fB\-mf930\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5859 |
.IX Item "-mf930" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5860 |
.Ip "\fB\-mf934\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5861 |
.IX Item "-mf934" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5862 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5863 |
These four options select the processor for which the code is optimized. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5864 |
These options are deprecated and will be deleted in a future \s-1GCC\s0 release. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5865 |
They have been replaced with \fB\-mcpu=xxx\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5866 |
.Ip "\fB\-mcpu=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5867 |
.IX Item "-mcpu=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5868 |
Set the instruction set, register set, and instruction scheduling parameters |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5869 |
for machine type \fIcpu_type\fR. Supported values for \fIcpu_type\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5870 |
\&\fBv7\fR, \fBcypress\fR, \fBv8\fR, \fBsupersparc\fR, \fBsparclite\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5871 |
\&\fBf930\fR, \fBf934\fR, \fBhypersparc\fR, \fBsparclite86x\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5872 |
\&\fBsparclet\fR, \fBtsc701\fR, \fBv9\fR, \fBultrasparc\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5873 |
\&\fBultrasparc3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5874 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5875 |
Default instruction scheduling parameters are used for values that select |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5876 |
an architecture and not an implementation. These are \fBv7\fR, \fBv8\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5877 |
\&\fBsparclite\fR, \fBsparclet\fR, \fBv9\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5878 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5879 |
Here is a list of each supported architecture and their supported |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5880 |
implementations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5881 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5882 |
.Vb 5 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5883 |
\& v7: cypress |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5884 |
\& v8: supersparc, hypersparc |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5885 |
\& sparclite: f930, f934, sparclite86x |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5886 |
\& sparclet: tsc701 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5887 |
\& v9: ultrasparc, ultrasparc3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5888 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5889 |
By default (unless configured otherwise), \s-1GCC\s0 generates code for the V7 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5890 |
variant of the \s-1SPARC\s0 architecture. With \fB\-mcpu=cypress\fR, the compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5891 |
additionally optimizes it for the Cypress \s-1CY7C602\s0 chip, as used in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5892 |
SPARCStation/SPARCServer 3xx series. This is also appropriate for the older |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5893 |
SPARCStation 1, 2, \s-1IPX\s0 etc. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5894 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5895 |
With \fB\-mcpu=v8\fR, \s-1GCC\s0 generates code for the V8 variant of the \s-1SPARC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5896 |
architecture. The only difference from V7 code is that the compiler emits |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5897 |
the integer multiply and integer divide instructions which exist in \s-1SPARC-V8\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5898 |
but not in \s-1SPARC-V7\s0. With \fB\-mcpu=supersparc\fR, the compiler additionally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5899 |
optimizes it for the SuperSPARC chip, as used in the SPARCStation 10, 1000 and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5900 |
2000 series. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5901 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5902 |
With \fB\-mcpu=sparclite\fR, \s-1GCC\s0 generates code for the SPARClite variant of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5903 |
the \s-1SPARC\s0 architecture. This adds the integer multiply, integer divide step |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5904 |
and scan (\f(CW\*(C`ffs\*(C'\fR) instructions which exist in SPARClite but not in \s-1SPARC-V7\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5905 |
With \fB\-mcpu=f930\fR, the compiler additionally optimizes it for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5906 |
Fujitsu \s-1MB86930\s0 chip, which is the original SPARClite, with no \s-1FPU\s0. With |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5907 |
\&\fB\-mcpu=f934\fR, the compiler additionally optimizes it for the Fujitsu |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5908 |
\&\s-1MB86934\s0 chip, which is the more recent SPARClite with \s-1FPU\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5909 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5910 |
With \fB\-mcpu=sparclet\fR, \s-1GCC\s0 generates code for the SPARClet variant of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5911 |
the \s-1SPARC\s0 architecture. This adds the integer multiply, multiply/accumulate, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5912 |
integer divide step and scan (\f(CW\*(C`ffs\*(C'\fR) instructions which exist in SPARClet |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5913 |
but not in \s-1SPARC-V7\s0. With \fB\-mcpu=tsc701\fR, the compiler additionally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5914 |
optimizes it for the \s-1TEMIC\s0 SPARClet chip. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5915 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5916 |
With \fB\-mcpu=v9\fR, \s-1GCC\s0 generates code for the V9 variant of the \s-1SPARC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5917 |
architecture. This adds 64\-bit integer and floating-point move instructions, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5918 |
3 additional floating-point condition code registers and conditional move |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5919 |
instructions. With \fB\-mcpu=ultrasparc\fR, the compiler additionally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5920 |
optimizes it for the Sun UltraSPARC I/II chips. With |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5921 |
\&\fB\-mcpu=ultrasparc3\fR, the compiler additionally optimizes it for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5922 |
Sun UltraSPARC \s-1III\s0 chip. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5923 |
.Ip "\fB\-mtune=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5924 |
.IX Item "-mtune=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5925 |
Set the instruction scheduling parameters for machine type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5926 |
\&\fIcpu_type\fR, but do not set the instruction set or register set that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5927 |
option \fB\-mcpu=\fR\fIcpu_type\fR would. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5928 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5929 |
The same values for \fB\-mcpu=\fR\fIcpu_type\fR can be used for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5930 |
\&\fB\-mtune=\fR\fIcpu_type\fR, but the only useful values are those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5931 |
that select a particular cpu implementation. Those are \fBcypress\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5932 |
\&\fBsupersparc\fR, \fBhypersparc\fR, \fBf930\fR, \fBf934\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5933 |
\&\fBsparclite86x\fR, \fBtsc701\fR, \fBultrasparc\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5934 |
\&\fBultrasparc3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5935 |
.Ip "\fB\-mv8plus\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5936 |
.IX Item "-mv8plus" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5937 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5938 |
.Ip "\fB\-mno-v8plus\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5939 |
.IX Item "-mno-v8plus" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5940 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5941 |
With \fB\-mv8plus\fR, \s-1GCC\s0 generates code for the \s-1SPARC-V8+\s0 \s-1ABI\s0. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5942 |
difference from the V8 \s-1ABI\s0 is that the global and out registers are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5943 |
considered 64\-bit wide. This is enabled by default on Solaris in 32\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5944 |
mode for all \s-1SPARC-V9\s0 processors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5945 |
.Ip "\fB\-mvis\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5946 |
.IX Item "-mvis" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5947 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5948 |
.Ip "\fB\-mno-vis\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5949 |
.IX Item "-mno-vis" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5950 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5951 |
With \fB\-mvis\fR, \s-1GCC\s0 generates code that takes advantage of the UltraSPARC |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5952 |
Visual Instruction Set extensions. The default is \fB\-mno-vis\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5953 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5954 |
These \fB\-m\fR options are supported in addition to the above |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5955 |
on \s-1SPARC-V9\s0 processors in 64\-bit environments: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5956 |
.Ip "\fB\-mlittle-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5957 |
.IX Item "-mlittle-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5958 |
Generate code for a processor running in little-endian mode. It is only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5959 |
available for a few configurations and most notably not on Solaris and Linux. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5960 |
.Ip "\fB\-m32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5961 |
.IX Item "-m32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5962 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5963 |
.Ip "\fB\-m64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5964 |
.IX Item "-m64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5965 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5966 |
Generate code for a 32\-bit or 64\-bit environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5967 |
The 32\-bit environment sets int, long and pointer to 32 bits. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5968 |
The 64\-bit environment sets int to 32 bits and long and pointer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5969 |
to 64 bits. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5970 |
.Ip "\fB\-mcmodel=medlow\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5971 |
.IX Item "-mcmodel=medlow" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5972 |
Generate code for the Medium/Low code model: 64\-bit addresses, programs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5973 |
must be linked in the low 32 bits of memory. Programs can be statically |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5974 |
or dynamically linked. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5975 |
.Ip "\fB\-mcmodel=medmid\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5976 |
.IX Item "-mcmodel=medmid" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5977 |
Generate code for the Medium/Middle code model: 64\-bit addresses, programs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5978 |
must be linked in the low 44 bits of memory, the text and data segments must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5979 |
be less than 2GB in size and the data segment must be located within 2GB of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5980 |
the text segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5981 |
.Ip "\fB\-mcmodel=medany\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5982 |
.IX Item "-mcmodel=medany" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5983 |
Generate code for the Medium/Anywhere code model: 64\-bit addresses, programs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5984 |
may be linked anywhere in memory, the text and data segments must be less |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5985 |
than 2GB in size and the data segment must be located within 2GB of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5986 |
text segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5987 |
.Ip "\fB\-mcmodel=embmedany\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5988 |
.IX Item "-mcmodel=embmedany" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5989 |
Generate code for the Medium/Anywhere code model for embedded systems: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5990 |
64\-bit addresses, the text and data segments must be less than 2GB in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5991 |
size, both starting anywhere in memory (determined at link time). The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5992 |
global register \f(CW%g4\fR points to the base of the data segment. Programs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5993 |
are statically linked and \s-1PIC\s0 is not supported. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5994 |
.Ip "\fB\-mstack-bias\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5995 |
.IX Item "-mstack-bias" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5996 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5997 |
.Ip "\fB\-mno-stack-bias\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5998 |
.IX Item "-mno-stack-bias" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
5999 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6000 |
With \fB\-mstack-bias\fR, \s-1GCC\s0 assumes that the stack pointer, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6001 |
frame pointer if present, are offset by \-2047 which must be added back |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6002 |
when making stack frame references. This is the default in 64\-bit mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6003 |
Otherwise, assume no such offset is present. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6004 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6005 |
These switches are supported in addition to the above on Solaris: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6006 |
.Ip "\fB\-threads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6007 |
.IX Item "-threads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6008 |
Add support for multithreading using the Solaris threads library. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6009 |
option sets flags for both the preprocessor and linker. This option does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6010 |
not affect the thread safety of object code produced by the compiler or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6011 |
that of libraries supplied with it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6012 |
.Ip "\fB\-pthreads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6013 |
.IX Item "-pthreads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6014 |
Add support for multithreading using the \s-1POSIX\s0 threads library. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6015 |
option sets flags for both the preprocessor and linker. This option does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6016 |
not affect the thread safety of object code produced by the compiler or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6017 |
that of libraries supplied with it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6018 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6019 |
.I "\s-1ARM\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6020 |
.IX Subsection "ARM Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6021 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6022 |
These \fB\-m\fR options are defined for Advanced \s-1RISC\s0 Machines (\s-1ARM\s0) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6023 |
architectures: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6024 |
.Ip "\fB\-mapcs-frame\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6025 |
.IX Item "-mapcs-frame" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6026 |
Generate a stack frame that is compliant with the \s-1ARM\s0 Procedure Call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6027 |
Standard for all functions, even if this is not strictly necessary for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6028 |
correct execution of the code. Specifying \fB\-fomit-frame-pointer\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6029 |
with this option will cause the stack frames not to be generated for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6030 |
leaf functions. The default is \fB\-mno-apcs-frame\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6031 |
.Ip "\fB\-mapcs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6032 |
.IX Item "-mapcs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6033 |
This is a synonym for \fB\-mapcs-frame\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6034 |
.Ip "\fB\-mapcs-26\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6035 |
.IX Item "-mapcs-26" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6036 |
Generate code for a processor running with a 26\-bit program counter, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6037 |
and conforming to the function calling standards for the \s-1APCS\s0 26\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6038 |
option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6039 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6040 |
This option is deprecated. Future releases of the \s-1GCC\s0 will only support |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6041 |
generating code that runs in apcs-32 mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6042 |
.Ip "\fB\-mapcs-32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6043 |
.IX Item "-mapcs-32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6044 |
Generate code for a processor running with a 32\-bit program counter, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6045 |
and conforming to the function calling standards for the \s-1APCS\s0 32\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6046 |
option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6047 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6048 |
This flag is deprecated. Future releases of \s-1GCC\s0 will make this flag |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6049 |
unconditional. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6050 |
.Ip "\fB\-mthumb-interwork\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6051 |
.IX Item "-mthumb-interwork" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6052 |
Generate code which supports calling between the \s-1ARM\s0 and Thumb |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6053 |
instruction sets. Without this option the two instruction sets cannot |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6054 |
be reliably used inside one program. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6055 |
\&\fB\-mno-thumb-interwork\fR, since slightly larger code is generated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6056 |
when \fB\-mthumb-interwork\fR is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6057 |
.Ip "\fB\-mno-sched-prolog\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6058 |
.IX Item "-mno-sched-prolog" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6059 |
Prevent the reordering of instructions in the function prolog, or the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6060 |
merging of those instruction with the instructions in the function's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6061 |
body. This means that all functions will start with a recognizable set |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6062 |
of instructions (or in fact one of a choice from a small set of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6063 |
different function prologues), and this information can be used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6064 |
locate the start if functions inside an executable piece of code. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6065 |
default is \fB\-msched-prolog\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6066 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6067 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6068 |
Generate output containing floating point instructions. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6069 |
default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6070 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6071 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6072 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6073 |
\&\fBWarning:\fR the requisite libraries are not available for all \s-1ARM\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6074 |
targets. Normally the facilities of the machine's usual C compiler are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6075 |
used, but this cannot be done directly in cross-compilation. You must make |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6076 |
your own arrangements to provide suitable library functions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6077 |
cross-compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6078 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6079 |
\&\fB\-msoft-float\fR changes the calling convention in the output file; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6080 |
therefore, it is only useful if you compile \fIall\fR of a program with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6081 |
this option. In particular, you need to compile \fIlibgcc.a\fR, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6082 |
library that comes with \s-1GCC\s0, with \fB\-msoft-float\fR in order for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6083 |
this to work. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6084 |
.Ip "\fB\-mlittle-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6085 |
.IX Item "-mlittle-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6086 |
Generate code for a processor running in little-endian mode. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6087 |
the default for all standard configurations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6088 |
.Ip "\fB\-mbig-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6089 |
.IX Item "-mbig-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6090 |
Generate code for a processor running in big-endian mode; the default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6091 |
to compile code for a little-endian processor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6092 |
.Ip "\fB\-mwords-little-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6093 |
.IX Item "-mwords-little-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6094 |
This option only applies when generating code for big-endian processors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6095 |
Generate code for a little-endian word order but a big-endian byte |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6096 |
order. That is, a byte order of the form \fB32107654\fR. Note: this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6097 |
option should only be used if you require compatibility with code for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6098 |
big-endian \s-1ARM\s0 processors generated by versions of the compiler prior to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6099 |
2.8. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6100 |
.Ip "\fB\-malignment-traps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6101 |
.IX Item "-malignment-traps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6102 |
Generate code that will not trap if the \s-1MMU\s0 has alignment traps enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6103 |
On \s-1ARM\s0 architectures prior to ARMv4, there were no instructions to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6104 |
access half-word objects stored in memory. However, when reading from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6105 |
memory a feature of the \s-1ARM\s0 architecture allows a word load to be used, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6106 |
even if the address is unaligned, and the processor core will rotate the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6107 |
data as it is being loaded. This option tells the compiler that such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6108 |
misaligned accesses will cause a \s-1MMU\s0 trap and that it should instead |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6109 |
synthesize the access as a series of byte accesses. The compiler can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6110 |
still use word accesses to load half-word data if it knows that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6111 |
address is aligned to a word boundary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6112 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6113 |
This option has no effect when compiling for \s-1ARM\s0 architecture 4 or later, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6114 |
since these processors have instructions to directly access half-word |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6115 |
objects in memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6116 |
.Ip "\fB\-mno-alignment-traps\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6117 |
.IX Item "-mno-alignment-traps" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6118 |
Generate code that assumes that the \s-1MMU\s0 will not trap unaligned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6119 |
accesses. This produces better code when the target instruction set |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6120 |
does not have half-word memory operations (i.e. implementations prior to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6121 |
ARMv4). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6122 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6123 |
Note that you cannot use this option to access unaligned word objects, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6124 |
since the processor will only fetch one 32\-bit aligned object from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6125 |
memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6126 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6127 |
The default setting is \fB\-malignment-traps\fR, since this produces |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6128 |
code that will also run on processors implementing \s-1ARM\s0 architecture |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6129 |
version 6 or later. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6130 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6131 |
This option is deprecated and will be removed in the next release of \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6132 |
.Ip "\fB\-mcpu=\fR\fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6133 |
.IX Item "-mcpu=name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6134 |
This specifies the name of the target \s-1ARM\s0 processor. \s-1GCC\s0 uses this name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6135 |
to determine what kind of instructions it can emit when generating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6136 |
assembly code. Permissible names are: \fBarm2\fR, \fBarm250\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6137 |
\&\fBarm3\fR, \fBarm6\fR, \fBarm60\fR, \fBarm600\fR, \fBarm610\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6138 |
\&\fBarm620\fR, \fBarm7\fR, \fBarm7m\fR, \fBarm7d\fR, \fBarm7dm\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6139 |
\&\fBarm7di\fR, \fBarm7dmi\fR, \fBarm70\fR, \fBarm700\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6140 |
\&\fBarm700i\fR, \fBarm710\fR, \fBarm710c\fR, \fBarm7100\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6141 |
\&\fBarm7500\fR, \fBarm7500fe\fR, \fBarm7tdmi\fR, \fBarm8\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6142 |
\&\fBstrongarm\fR, \fBstrongarm110\fR, \fBstrongarm1100\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6143 |
\&\fBarm8\fR, \fBarm810\fR, \fBarm9\fR, \fBarm9e\fR, \fBarm920\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6144 |
\&\fBarm920t\fR, \fBarm926ejs\fR, \fBarm940t\fR, \fBarm9tdmi\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6145 |
\&\fBarm10tdmi\fR, \fBarm1020t\fR, \fBarm1026ejs\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6146 |
\&\fBarm1136js\fR, \fBarm1136jfs\fR ,\fBxscale\fR, \fBiwmmxt\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6147 |
\&\fBep9312\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6148 |
.Ip "\fB\-mtune=\fR\fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6149 |
.IX Item "-mtune=name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6150 |
This option is very similar to the \fB\-mcpu=\fR option, except that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6151 |
instead of specifying the actual target processor type, and hence |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6152 |
restricting which instructions can be used, it specifies that \s-1GCC\s0 should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6153 |
tune the performance of the code as if the target were of the type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6154 |
specified in this option, but still choosing the instructions that it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6155 |
will generate based on the cpu specified by a \fB\-mcpu=\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6156 |
For some \s-1ARM\s0 implementations better performance can be obtained by using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6157 |
this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6158 |
.Ip "\fB\-march=\fR\fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6159 |
.IX Item "-march=name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6160 |
This specifies the name of the target \s-1ARM\s0 architecture. \s-1GCC\s0 uses this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6161 |
name to determine what kind of instructions it can emit when generating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6162 |
assembly code. This option can be used in conjunction with or instead |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6163 |
of the \fB\-mcpu=\fR option. Permissible names are: \fBarmv2\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6164 |
\&\fBarmv2a\fR, \fBarmv3\fR, \fBarmv3m\fR, \fBarmv4\fR, \fBarmv4t\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6165 |
\&\fBarmv5\fR, \fBarmv5t\fR, \fBarmv5te\fR, \fBarmv6j\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6166 |
\&\fBiwmmxt\fR, \fBep9312\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6167 |
.Ip "\fB\-mfpe=\fR\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6168 |
.IX Item "-mfpe=number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6169 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6170 |
.Ip "\fB\-mfp=\fR\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6171 |
.IX Item "-mfp=number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6172 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6173 |
This specifies the version of the floating point emulation available on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6174 |
the target. Permissible values are 2 and 3. \fB\-mfp=\fR is a synonym |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6175 |
for \fB\-mfpe=\fR, for compatibility with older versions of \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6176 |
.Ip "\fB\-mstructure-size-boundary=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6177 |
.IX Item "-mstructure-size-boundary=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6178 |
The size of all structures and unions will be rounded up to a multiple |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6179 |
of the number of bits set by this option. Permissible values are 8 and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6180 |
32. The default value varies for different toolchains. For the \s-1COFF\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6181 |
targeted toolchain the default value is 8. Specifying the larger number |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6182 |
can produce faster, more efficient code, but can also increase the size |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6183 |
of the program. The two values are potentially incompatible. Code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6184 |
compiled with one value cannot necessarily expect to work with code or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6185 |
libraries compiled with the other value, if they exchange information |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6186 |
using structures or unions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6187 |
.Ip "\fB\-mabort-on-noreturn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6188 |
.IX Item "-mabort-on-noreturn" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6189 |
Generate a call to the function \f(CW\*(C`abort\*(C'\fR at the end of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6190 |
\&\f(CW\*(C`noreturn\*(C'\fR function. It will be executed if the function tries to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6191 |
return. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6192 |
.Ip "\fB\-mlong-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6193 |
.IX Item "-mlong-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6194 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6195 |
.Ip "\fB\-mno-long-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6196 |
.IX Item "-mno-long-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6197 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6198 |
Tells the compiler to perform function calls by first loading the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6199 |
address of the function into a register and then performing a subroutine |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6200 |
call on this register. This switch is needed if the target function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6201 |
will lie outside of the 64 megabyte addressing range of the offset based |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6202 |
version of subroutine call instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6203 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6204 |
Even if this switch is enabled, not all function calls will be turned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6205 |
into long calls. The heuristic is that static functions, functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6206 |
which have the \fBshort-call\fR attribute, functions that are inside |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6207 |
the scope of a \fB#pragma no_long_calls\fR directive and functions whose |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6208 |
definitions have already been compiled within the current compilation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6209 |
unit, will not be turned into long calls. The exception to this rule is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6210 |
that weak function definitions, functions with the \fBlong-call\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6211 |
attribute or the \fBsection\fR attribute, and functions that are within |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6212 |
the scope of a \fB#pragma long_calls\fR directive, will always be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6213 |
turned into long calls. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6214 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6215 |
This feature is not enabled by default. Specifying |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6216 |
\&\fB\-mno-long-calls\fR will restore the default behavior, as will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6217 |
placing the function calls within the scope of a \fB#pragma |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6218 |
long_calls_off\fR directive. Note these switches have no effect on how |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6219 |
the compiler generates code to handle function calls via function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6220 |
pointers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6221 |
.Ip "\fB\-mnop-fun-dllimport\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6222 |
.IX Item "-mnop-fun-dllimport" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6223 |
Disable support for the \f(CW\*(C`dllimport\*(C'\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6224 |
.Ip "\fB\-msingle-pic-base\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6225 |
.IX Item "-msingle-pic-base" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6226 |
Treat the register used for \s-1PIC\s0 addressing as read-only, rather than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6227 |
loading it in the prologue for each function. The run-time system is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6228 |
responsible for initializing this register with an appropriate value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6229 |
before execution begins. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6230 |
.Ip "\fB\-mpic-register=\fR\fIreg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6231 |
.IX Item "-mpic-register=reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6232 |
Specify the register to be used for \s-1PIC\s0 addressing. The default is R10 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6233 |
unless stack-checking is enabled, when R9 is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6234 |
.Ip "\fB\-mcirrus-fix-invalid-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6235 |
.IX Item "-mcirrus-fix-invalid-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6236 |
Insert NOPs into the instruction stream to in order to work around |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6237 |
problems with invalid Maverick instruction combinations. This option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6238 |
is only valid if the \fB\-mcpu=ep9312\fR option has been used to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6239 |
enable generation of instructions for the Cirrus Maverick floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6240 |
point co-processor. This option is not enabled by default, since the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6241 |
problem is only present in older Maverick implementations. The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6242 |
can be re-enabled by use of the \fB\-mno-cirrus-fix-invalid-insns\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6243 |
switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6244 |
.Ip "\fB\-mpoke-function-name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6245 |
.IX Item "-mpoke-function-name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6246 |
Write the name of each function into the text section, directly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6247 |
preceding the function prologue. The generated code is similar to this: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6248 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6249 |
.Vb 9 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6250 |
\& t0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6251 |
\& .ascii "arm_poke_function_name", 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6252 |
\& .align |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6253 |
\& t1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6254 |
\& .word 0xff000000 + (t1 - t0) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6255 |
\& arm_poke_function_name |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6256 |
\& mov ip, sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6257 |
\& stmfd sp!, {fp, ip, lr, pc} |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6258 |
\& sub fp, ip, #4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6259 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6260 |
When performing a stack backtrace, code can inspect the value of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6261 |
\&\f(CW\*(C`pc\*(C'\fR stored at \f(CW\*(C`fp + 0\*(C'\fR. If the trace function then looks at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6262 |
location \f(CW\*(C`pc \- 12\*(C'\fR and the top 8 bits are set, then we know that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6263 |
there is a function name embedded immediately preceding this location |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6264 |
and has length \f(CW\*(C`((pc[\-3]) & 0xff000000)\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6265 |
.Ip "\fB\-mthumb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6266 |
.IX Item "-mthumb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6267 |
Generate code for the 16\-bit Thumb instruction set. The default is to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6268 |
use the 32\-bit \s-1ARM\s0 instruction set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6269 |
.Ip "\fB\-mtpcs-frame\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6270 |
.IX Item "-mtpcs-frame" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6271 |
Generate a stack frame that is compliant with the Thumb Procedure Call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6272 |
Standard for all non-leaf functions. (A leaf function is one that does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6273 |
not call any other functions.) The default is \fB\-mno-tpcs-frame\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6274 |
.Ip "\fB\-mtpcs-leaf-frame\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6275 |
.IX Item "-mtpcs-leaf-frame" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6276 |
Generate a stack frame that is compliant with the Thumb Procedure Call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6277 |
Standard for all leaf functions. (A leaf function is one that does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6278 |
not call any other functions.) The default is \fB\-mno-apcs-leaf-frame\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6279 |
.Ip "\fB\-mcallee-super-interworking\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6280 |
.IX Item "-mcallee-super-interworking" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6281 |
Gives all externally visible functions in the file being compiled an \s-1ARM\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6282 |
instruction set header which switches to Thumb mode before executing the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6283 |
rest of the function. This allows these functions to be called from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6284 |
non-interworking code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6285 |
.Ip "\fB\-mcaller-super-interworking\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6286 |
.IX Item "-mcaller-super-interworking" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6287 |
Allows calls via function pointers (including virtual functions) to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6288 |
execute correctly regardless of whether the target code has been |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6289 |
compiled for interworking or not. There is a small overhead in the cost |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6290 |
of executing a function pointer if this option is enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6291 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6292 |
.I "\s-1MN10300\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6293 |
.IX Subsection "MN10300 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6294 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6295 |
These \fB\-m\fR options are defined for Matsushita \s-1MN10300\s0 architectures: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6296 |
.Ip "\fB\-mmult-bug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6297 |
.IX Item "-mmult-bug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6298 |
Generate code to avoid bugs in the multiply instructions for the \s-1MN10300\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6299 |
processors. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6300 |
.Ip "\fB\-mno-mult-bug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6301 |
.IX Item "-mno-mult-bug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6302 |
Do not generate code to avoid bugs in the multiply instructions for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6303 |
\&\s-1MN10300\s0 processors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6304 |
.Ip "\fB\-mam33\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6305 |
.IX Item "-mam33" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6306 |
Generate code which uses features specific to the \s-1AM33\s0 processor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6307 |
.Ip "\fB\-mno-am33\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6308 |
.IX Item "-mno-am33" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6309 |
Do not generate code which uses features specific to the \s-1AM33\s0 processor. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6310 |
is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6311 |
.Ip "\fB\-mno-crt0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6312 |
.IX Item "-mno-crt0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6313 |
Do not link in the C run-time initialization object file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6314 |
.Ip "\fB\-mrelax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6315 |
.IX Item "-mrelax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6316 |
Indicate to the linker that it should perform a relaxation optimization pass |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6317 |
to shorten branches, calls and absolute memory addresses. This option only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6318 |
has an effect when used on the command line for the final link step. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6319 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6320 |
This option makes symbolic debugging impossible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6321 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6322 |
.I "M32R/D Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6323 |
.IX Subsection "M32R/D Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6324 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6325 |
These \fB\-m\fR options are defined for Renesas M32R/D architectures: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6326 |
.Ip "\fB\-m32r2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6327 |
.IX Item "-m32r2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6328 |
Generate code for the M32R/2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6329 |
.Ip "\fB\-m32rx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6330 |
.IX Item "-m32rx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6331 |
Generate code for the M32R/X. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6332 |
.Ip "\fB\-m32r\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6333 |
.IX Item "-m32r" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6334 |
Generate code for the M32R. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6335 |
.Ip "\fB\-mmodel=small\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6336 |
.IX Item "-mmodel=small" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6337 |
Assume all objects live in the lower 16MB of memory (so that their addresses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6338 |
can be loaded with the \f(CW\*(C`ld24\*(C'\fR instruction), and assume all subroutines |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6339 |
are reachable with the \f(CW\*(C`bl\*(C'\fR instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6340 |
This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6341 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6342 |
The addressability of a particular object can be set with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6343 |
\&\f(CW\*(C`model\*(C'\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6344 |
.Ip "\fB\-mmodel=medium\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6345 |
.IX Item "-mmodel=medium" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6346 |
Assume objects may be anywhere in the 32\-bit address space (the compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6347 |
will generate \f(CW\*(C`seth/add3\*(C'\fR instructions to load their addresses), and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6348 |
assume all subroutines are reachable with the \f(CW\*(C`bl\*(C'\fR instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6349 |
.Ip "\fB\-mmodel=large\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6350 |
.IX Item "-mmodel=large" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6351 |
Assume objects may be anywhere in the 32\-bit address space (the compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6352 |
will generate \f(CW\*(C`seth/add3\*(C'\fR instructions to load their addresses), and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6353 |
assume subroutines may not be reachable with the \f(CW\*(C`bl\*(C'\fR instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6354 |
(the compiler will generate the much slower \f(CW\*(C`seth/add3/jl\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6355 |
instruction sequence). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6356 |
.Ip "\fB\-msdata=none\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6357 |
.IX Item "-msdata=none" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6358 |
Disable use of the small data area. Variables will be put into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6359 |
one of \fB.data\fR, \fBbss\fR, or \fB.rodata\fR (unless the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6360 |
\&\f(CW\*(C`section\*(C'\fR attribute has been specified). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6361 |
This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6362 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6363 |
The small data area consists of sections \fB.sdata\fR and \fB.sbss\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6364 |
Objects may be explicitly put in the small data area with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6365 |
\&\f(CW\*(C`section\*(C'\fR attribute using one of these sections. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6366 |
.Ip "\fB\-msdata=sdata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6367 |
.IX Item "-msdata=sdata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6368 |
Put small global and static data in the small data area, but do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6369 |
generate special code to reference them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6370 |
.Ip "\fB\-msdata=use\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6371 |
.IX Item "-msdata=use" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6372 |
Put small global and static data in the small data area, and generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6373 |
special instructions to reference them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6374 |
.Ip "\fB\-G\fR \fInum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6375 |
.IX Item "-G num" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6376 |
Put global and static objects less than or equal to \fInum\fR bytes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6377 |
into the small data or bss sections instead of the normal data or bss |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6378 |
sections. The default value of \fInum\fR is 8. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6379 |
The \fB\-msdata\fR option must be set to one of \fBsdata\fR or \fBuse\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6380 |
for this option to have any effect. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6381 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6382 |
All modules should be compiled with the same \fB\-G\fR \fInum\fR value. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6383 |
Compiling with different values of \fInum\fR may or may not work; if it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6384 |
doesn't the linker will give an error message\-\-\-incorrect code will not be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6385 |
generated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6386 |
.Ip "\fB\-mdebug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6387 |
.IX Item "-mdebug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6388 |
Makes the M32R specific code in the compiler display some statistics |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6389 |
that might help in debugging programs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6390 |
.Ip "\fB\-malign-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6391 |
.IX Item "-malign-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6392 |
Align all loops to a 32\-byte boundary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6393 |
.Ip "\fB\-mno-align-loops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6394 |
.IX Item "-mno-align-loops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6395 |
Do not enforce a 32\-byte alignment for loops. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6396 |
.Ip "\fB\-missue-rate=\fR\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6397 |
.IX Item "-missue-rate=number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6398 |
Issue \fInumber\fR instructions per cycle. \fInumber\fR can only be 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6399 |
or 2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6400 |
.Ip "\fB\-mbranch-cost=\fR\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6401 |
.IX Item "-mbranch-cost=number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6402 |
\&\fInumber\fR can only be 1 or 2. If it is 1 then branches will be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6403 |
preferred over conditional code, if it is 2, then the opposite will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6404 |
apply. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6405 |
.Ip "\fB\-mflush-trap=\fR\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6406 |
.IX Item "-mflush-trap=number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6407 |
Specifies the trap number to use to flush the cache. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6408 |
12. Valid numbers are between 0 and 15 inclusive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6409 |
.Ip "\fB\-mno-flush-trap\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6410 |
.IX Item "-mno-flush-trap" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6411 |
Specifies that the cache cannot be flushed by using a trap. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6412 |
.Ip "\fB\-mflush-func=\fR\fIname\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6413 |
.IX Item "-mflush-func=name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6414 |
Specifies the name of the operating system function to call to flush |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6415 |
the cache. The default is \fI_flush_cache\fR, but a function call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6416 |
will only be used if a trap is not available. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6417 |
.Ip "\fB\-mno-flush-func\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6418 |
.IX Item "-mno-flush-func" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6419 |
Indicates that there is no \s-1OS\s0 function for flushing the cache. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6420 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6421 |
.I "\s-1IBM\s0 \s-1RS/6000\s0 and PowerPC Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6422 |
.IX Subsection "IBM RS/6000 and PowerPC Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6423 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6424 |
These \fB\-m\fR options are defined for the \s-1IBM\s0 \s-1RS/6000\s0 and PowerPC: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6425 |
.Ip "\fB\-mpower\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6426 |
.IX Item "-mpower" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6427 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6428 |
.Ip "\fB\-mno-power\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6429 |
.IX Item "-mno-power" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6430 |
.Ip "\fB\-mpower2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6431 |
.IX Item "-mpower2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6432 |
.Ip "\fB\-mno-power2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6433 |
.IX Item "-mno-power2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6434 |
.Ip "\fB\-mpowerpc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6435 |
.IX Item "-mpowerpc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6436 |
.Ip "\fB\-mno-powerpc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6437 |
.IX Item "-mno-powerpc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6438 |
.Ip "\fB\-mpowerpc-gpopt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6439 |
.IX Item "-mpowerpc-gpopt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6440 |
.Ip "\fB\-mno-powerpc-gpopt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6441 |
.IX Item "-mno-powerpc-gpopt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6442 |
.Ip "\fB\-mpowerpc-gfxopt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6443 |
.IX Item "-mpowerpc-gfxopt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6444 |
.Ip "\fB\-mno-powerpc-gfxopt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6445 |
.IX Item "-mno-powerpc-gfxopt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6446 |
.Ip "\fB\-mpowerpc64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6447 |
.IX Item "-mpowerpc64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6448 |
.Ip "\fB\-mno-powerpc64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6449 |
.IX Item "-mno-powerpc64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6450 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6451 |
\&\s-1GCC\s0 supports two related instruction set architectures for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6452 |
\&\s-1RS/6000\s0 and PowerPC. The \fI\s-1POWER\s0\fR instruction set are those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6453 |
instructions supported by the \fBrios\fR chip set used in the original |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6454 |
\&\s-1RS/6000\s0 systems and the \fIPowerPC\fR instruction set is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6455 |
architecture of the Motorola MPC5xx, MPC6xx, MPC8xx microprocessors, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6456 |
the \s-1IBM\s0 4xx microprocessors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6457 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6458 |
Neither architecture is a subset of the other. However there is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6459 |
large common subset of instructions supported by both. An \s-1MQ\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6460 |
register is included in processors supporting the \s-1POWER\s0 architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6461 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6462 |
You use these options to specify which instructions are available on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6463 |
processor you are using. The default value of these options is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6464 |
determined when configuring \s-1GCC\s0. Specifying the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6465 |
\&\fB\-mcpu=\fR\fIcpu_type\fR overrides the specification of these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6466 |
options. We recommend you use the \fB\-mcpu=\fR\fIcpu_type\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6467 |
rather than the options listed above. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6468 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6469 |
The \fB\-mpower\fR option allows \s-1GCC\s0 to generate instructions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6470 |
are found only in the \s-1POWER\s0 architecture and to use the \s-1MQ\s0 register. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6471 |
Specifying \fB\-mpower2\fR implies \fB\-power\fR and also allows \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6472 |
to generate instructions that are present in the \s-1POWER2\s0 architecture but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6473 |
not the original \s-1POWER\s0 architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6474 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6475 |
The \fB\-mpowerpc\fR option allows \s-1GCC\s0 to generate instructions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6476 |
are found only in the 32\-bit subset of the PowerPC architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6477 |
Specifying \fB\-mpowerpc-gpopt\fR implies \fB\-mpowerpc\fR and also allows |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6478 |
\&\s-1GCC\s0 to use the optional PowerPC architecture instructions in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6479 |
General Purpose group, including floating-point square root. Specifying |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6480 |
\&\fB\-mpowerpc-gfxopt\fR implies \fB\-mpowerpc\fR and also allows \s-1GCC\s0 to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6481 |
use the optional PowerPC architecture instructions in the Graphics |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6482 |
group, including floating-point select. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6483 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6484 |
The \fB\-mpowerpc64\fR option allows \s-1GCC\s0 to generate the additional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6485 |
64\-bit instructions that are found in the full PowerPC64 architecture |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6486 |
and to treat GPRs as 64\-bit, doubleword quantities. \s-1GCC\s0 defaults to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6487 |
\&\fB\-mno-powerpc64\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6488 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6489 |
If you specify both \fB\-mno-power\fR and \fB\-mno-powerpc\fR, \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6490 |
will use only the instructions in the common subset of both |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6491 |
architectures plus some special \s-1AIX\s0 common-mode calls, and will not use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6492 |
the \s-1MQ\s0 register. Specifying both \fB\-mpower\fR and \fB\-mpowerpc\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6493 |
permits \s-1GCC\s0 to use any instruction from either architecture and to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6494 |
allow use of the \s-1MQ\s0 register; specify this for the Motorola \s-1MPC601\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6495 |
.Ip "\fB\-mnew-mnemonics\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6496 |
.IX Item "-mnew-mnemonics" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6497 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6498 |
.Ip "\fB\-mold-mnemonics\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6499 |
.IX Item "-mold-mnemonics" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6500 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6501 |
Select which mnemonics to use in the generated assembler code. With |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6502 |
\&\fB\-mnew-mnemonics\fR, \s-1GCC\s0 uses the assembler mnemonics defined for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6503 |
the PowerPC architecture. With \fB\-mold-mnemonics\fR it uses the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6504 |
assembler mnemonics defined for the \s-1POWER\s0 architecture. Instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6505 |
defined in only one architecture have only one mnemonic; \s-1GCC\s0 uses that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6506 |
mnemonic irrespective of which of these options is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6507 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6508 |
\&\s-1GCC\s0 defaults to the mnemonics appropriate for the architecture in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6509 |
use. Specifying \fB\-mcpu=\fR\fIcpu_type\fR sometimes overrides the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6510 |
value of these option. Unless you are building a cross-compiler, you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6511 |
should normally not specify either \fB\-mnew-mnemonics\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6512 |
\&\fB\-mold-mnemonics\fR, but should instead accept the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6513 |
.Ip "\fB\-mcpu=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6514 |
.IX Item "-mcpu=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6515 |
Set architecture type, register usage, choice of mnemonics, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6516 |
instruction scheduling parameters for machine type \fIcpu_type\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6517 |
Supported values for \fIcpu_type\fR are \fB401\fR, \fB403\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6518 |
\&\fB405\fR, \fB405fp\fR, \fB440\fR, \fB440fp\fR, \fB505\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6519 |
\&\fB601\fR, \fB602\fR, \fB603\fR, \fB603e\fR, \fB604\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6520 |
\&\fB604e\fR, \fB620\fR, \fB630\fR, \fB740\fR, \fB7400\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6521 |
\&\fB7450\fR, \fB750\fR, \fB801\fR, \fB821\fR, \fB823\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6522 |
\&\fB860\fR, \fB970\fR, \fB8540\fR, \fBcommon\fR, \fBec603e\fR, \fBG3\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6523 |
\&\fBG4\fR, \fBG5\fR, \fBpower\fR, \fBpower2\fR, \fBpower3\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6524 |
\&\fBpower4\fR, \fBpower5\fR, \fBpowerpc\fR, \fBpowerpc64\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6525 |
\&\fBrios\fR, \fBrios1\fR, \fBrios2\fR, \fBrsc\fR, and \fBrs64a\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6526 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6527 |
\&\fB\-mcpu=common\fR selects a completely generic processor. Code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6528 |
generated under this option will run on any \s-1POWER\s0 or PowerPC processor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6529 |
\&\s-1GCC\s0 will use only the instructions in the common subset of both |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6530 |
architectures, and will not use the \s-1MQ\s0 register. \s-1GCC\s0 assumes a generic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6531 |
processor model for scheduling purposes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6532 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6533 |
\&\fB\-mcpu=power\fR, \fB\-mcpu=power2\fR, \fB\-mcpu=powerpc\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6534 |
\&\fB\-mcpu=powerpc64\fR specify generic \s-1POWER\s0, \s-1POWER2\s0, pure 32\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6535 |
PowerPC (i.e., not \s-1MPC601\s0), and 64\-bit PowerPC architecture machine |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6536 |
types, with an appropriate, generic processor model assumed for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6537 |
scheduling purposes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6538 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6539 |
The other options specify a specific processor. Code generated under |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6540 |
those options will run best on that processor, and may not run at all on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6541 |
others. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6542 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6543 |
The \fB\-mcpu\fR options automatically enable or disable the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6544 |
following options: \fB\-maltivec\fR, \fB\-mhard-float\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6545 |
\&\fB\-mmfcrf\fR, \fB\-mmultiple\fR, \fB\-mnew-mnemonics\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6546 |
\&\fB\-mpower\fR, \fB\-mpower2\fR, \fB\-mpowerpc64\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6547 |
\&\fB\-mpowerpc-gpopt\fR, \fB\-mpowerpc-gfxopt\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6548 |
\&\fB\-mstring\fR. The particular options set for any particular \s-1CPU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6549 |
will vary between compiler versions, depending on what setting seems |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6550 |
to produce optimal code for that \s-1CPU\s0; it doesn't necessarily reflect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6551 |
the actual hardware's capabilities. If you wish to set an individual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6552 |
option to a particular value, you may specify it after the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6553 |
\&\fB\-mcpu\fR option, like \fB\-mcpu=970 \-mno-altivec\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6554 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6555 |
On \s-1AIX\s0, the \fB\-maltivec\fR and \fB\-mpowerpc64\fR options are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6556 |
not enabled or disabled by the \fB\-mcpu\fR option at present, since |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6557 |
\&\s-1AIX\s0 does not have full support for these options. You may still |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6558 |
enable or disable them individually if you're sure it'll work in your |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6559 |
environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6560 |
.Ip "\fB\-mtune=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6561 |
.IX Item "-mtune=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6562 |
Set the instruction scheduling parameters for machine type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6563 |
\&\fIcpu_type\fR, but do not set the architecture type, register usage, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6564 |
choice of mnemonics, as \fB\-mcpu=\fR\fIcpu_type\fR would. The same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6565 |
values for \fIcpu_type\fR are used for \fB\-mtune\fR as for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6566 |
\&\fB\-mcpu\fR. If both are specified, the code generated will use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6567 |
architecture, registers, and mnemonics set by \fB\-mcpu\fR, but the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6568 |
scheduling parameters set by \fB\-mtune\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6569 |
.Ip "\fB\-maltivec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6570 |
.IX Item "-maltivec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6571 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6572 |
.Ip "\fB\-mno-altivec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6573 |
.IX Item "-mno-altivec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6574 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6575 |
These switches enable or disable the use of built-in functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6576 |
allow access to the AltiVec instruction set. You may also need to set |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6577 |
\&\fB\-mabi=altivec\fR to adjust the current \s-1ABI\s0 with AltiVec \s-1ABI\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6578 |
enhancements. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6579 |
.Ip "\fB\-mabi=spe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6580 |
.IX Item "-mabi=spe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6581 |
Extend the current \s-1ABI\s0 with \s-1SPE\s0 \s-1ABI\s0 extensions. This does not change |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6582 |
the default \s-1ABI\s0, instead it adds the \s-1SPE\s0 \s-1ABI\s0 extensions to the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6583 |
\&\s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6584 |
.Ip "\fB\-mabi=no-spe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6585 |
.IX Item "-mabi=no-spe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6586 |
Disable Booke \s-1SPE\s0 \s-1ABI\s0 extensions for the current \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6587 |
.Ip "\fB\-misel=\fR\fIyes/no\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6588 |
.IX Item "-misel=yes/no" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6589 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6590 |
.Ip "\fB\-misel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6591 |
.IX Item "-misel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6592 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6593 |
This switch enables or disables the generation of \s-1ISEL\s0 instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6594 |
.Ip "\fB\-mspe=\fR\fIyes/no\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6595 |
.IX Item "-mspe=yes/no" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6596 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6597 |
.Ip "\fB\-mspe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6598 |
.IX Item "-mspe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6599 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6600 |
This switch enables or disables the generation of \s-1SPE\s0 simd |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6601 |
instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6602 |
.Ip "\fB\-mfloat-gprs=\fR\fIyes/no\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6603 |
.IX Item "-mfloat-gprs=yes/no" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6604 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6605 |
.Ip "\fB\-mfloat-gprs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6606 |
.IX Item "-mfloat-gprs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6607 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6608 |
This switch enables or disables the generation of floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6609 |
operations on the general purpose registers for architectures that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6610 |
support it. This option is currently only available on the \s-1MPC8540\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6611 |
.Ip "\fB\-mfull-toc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6612 |
.IX Item "-mfull-toc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6613 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6614 |
.Ip "\fB\-mno-fp-in-toc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6615 |
.IX Item "-mno-fp-in-toc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6616 |
.Ip "\fB\-mno-sum-in-toc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6617 |
.IX Item "-mno-sum-in-toc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6618 |
.Ip "\fB\-mminimal-toc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6619 |
.IX Item "-mminimal-toc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6620 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6621 |
Modify generation of the \s-1TOC\s0 (Table Of Contents), which is created for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6622 |
every executable file. The \fB\-mfull-toc\fR option is selected by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6623 |
default. In that case, \s-1GCC\s0 will allocate at least one \s-1TOC\s0 entry for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6624 |
each unique non-automatic variable reference in your program. \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6625 |
will also place floating-point constants in the \s-1TOC\s0. However, only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6626 |
16,384 entries are available in the \s-1TOC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6627 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6628 |
If you receive a linker error message that saying you have overflowed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6629 |
the available \s-1TOC\s0 space, you can reduce the amount of \s-1TOC\s0 space used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6630 |
with the \fB\-mno-fp-in-toc\fR and \fB\-mno-sum-in-toc\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6631 |
\&\fB\-mno-fp-in-toc\fR prevents \s-1GCC\s0 from putting floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6632 |
constants in the \s-1TOC\s0 and \fB\-mno-sum-in-toc\fR forces \s-1GCC\s0 to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6633 |
generate code to calculate the sum of an address and a constant at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6634 |
run-time instead of putting that sum into the \s-1TOC\s0. You may specify one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6635 |
or both of these options. Each causes \s-1GCC\s0 to produce very slightly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6636 |
slower and larger code at the expense of conserving \s-1TOC\s0 space. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6637 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6638 |
If you still run out of space in the \s-1TOC\s0 even when you specify both of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6639 |
these options, specify \fB\-mminimal-toc\fR instead. This option causes |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6640 |
\&\s-1GCC\s0 to make only one \s-1TOC\s0 entry for every file. When you specify this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6641 |
option, \s-1GCC\s0 will produce code that is slower and larger but which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6642 |
uses extremely little \s-1TOC\s0 space. You may wish to use this option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6643 |
only on files that contain less frequently executed code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6644 |
.Ip "\fB\-maix64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6645 |
.IX Item "-maix64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6646 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6647 |
.Ip "\fB\-maix32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6648 |
.IX Item "-maix32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6649 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6650 |
Enable 64\-bit \s-1AIX\s0 \s-1ABI\s0 and calling convention: 64\-bit pointers, 64\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6651 |
\&\f(CW\*(C`long\*(C'\fR type, and the infrastructure needed to support them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6652 |
Specifying \fB\-maix64\fR implies \fB\-mpowerpc64\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6653 |
\&\fB\-mpowerpc\fR, while \fB\-maix32\fR disables the 64\-bit \s-1ABI\s0 and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6654 |
implies \fB\-mno-powerpc64\fR. \s-1GCC\s0 defaults to \fB\-maix32\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6655 |
.Ip "\fB\-mxl-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6656 |
.IX Item "-mxl-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6657 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6658 |
.Ip "\fB\-mno-xl-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6659 |
.IX Item "-mno-xl-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6660 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6661 |
Produce code that conforms more closely to \s-1IBM\s0 \s-1XLC\s0 semantics when using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6662 |
AIX-compatible \s-1ABI\s0. Pass floating-point arguments to prototyped |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6663 |
functions beyond the register save area (\s-1RSA\s0) on the stack in addition |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6664 |
to argument FPRs. Do not assume that most significant double in 128 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6665 |
bit long double value is properly rounded when comparing values. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6666 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6667 |
The \s-1AIX\s0 calling convention was extended but not initially documented to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6668 |
handle an obscure K&R C case of calling a function that takes the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6669 |
address of its arguments with fewer arguments than declared. \s-1AIX\s0 \s-1XL\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6670 |
compilers access floating point arguments which do not fit in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6671 |
\&\s-1RSA\s0 from the stack when a subroutine is compiled without |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6672 |
optimization. Because always storing floating-point arguments on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6673 |
stack is inefficient and rarely needed, this option is not enabled by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6674 |
default and only is necessary when calling subroutines compiled by \s-1AIX\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6675 |
\&\s-1XL\s0 compilers without optimization. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6676 |
.Ip "\fB\-mpe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6677 |
.IX Item "-mpe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6678 |
Support \fI\s-1IBM\s0 \s-1RS/6000\s0 \s-1SP\s0\fR \fIParallel Environment\fR (\s-1PE\s0). Link an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6679 |
application written to use message passing with special startup code to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6680 |
enable the application to run. The system must have \s-1PE\s0 installed in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6681 |
standard location (\fI/usr/lpp/ppe.poe/\fR), or the \fIspecs\fR file |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6682 |
must be overridden with the \fB\-specs=\fR option to specify the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6683 |
appropriate directory location. The Parallel Environment does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6684 |
support threads, so the \fB\-mpe\fR option and the \fB\-pthread\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6685 |
option are incompatible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6686 |
.Ip "\fB\-malign-natural\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6687 |
.IX Item "-malign-natural" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6688 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6689 |
.Ip "\fB\-malign-power\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6690 |
.IX Item "-malign-power" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6691 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6692 |
On \s-1AIX\s0, Darwin, and 64\-bit PowerPC GNU/Linux, the option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6693 |
\&\fB\-malign-natural\fR overrides the ABI-defined alignment of larger |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6694 |
types, such as floating-point doubles, on their natural size-based boundary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6695 |
The option \fB\-malign-power\fR instructs \s-1GCC\s0 to follow the ABI-specified |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6696 |
alignment rules. \s-1GCC\s0 defaults to the standard alignment defined in the \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6697 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6698 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6699 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6700 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6701 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6702 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6703 |
Generate code that does not use (uses) the floating-point register set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6704 |
Software floating point emulation is provided if you use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6705 |
\&\fB\-msoft-float\fR option, and pass the option to \s-1GCC\s0 when linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6706 |
.Ip "\fB\-mmultiple\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6707 |
.IX Item "-mmultiple" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6708 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6709 |
.Ip "\fB\-mno-multiple\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6710 |
.IX Item "-mno-multiple" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6711 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6712 |
Generate code that uses (does not use) the load multiple word |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6713 |
instructions and the store multiple word instructions. These |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6714 |
instructions are generated by default on \s-1POWER\s0 systems, and not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6715 |
generated on PowerPC systems. Do not use \fB\-mmultiple\fR on little |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6716 |
endian PowerPC systems, since those instructions do not work when the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6717 |
processor is in little endian mode. The exceptions are \s-1PPC740\s0 and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6718 |
\&\s-1PPC750\s0 which permit the instructions usage in little endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6719 |
.Ip "\fB\-mstring\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6720 |
.IX Item "-mstring" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6721 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6722 |
.Ip "\fB\-mno-string\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6723 |
.IX Item "-mno-string" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6724 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6725 |
Generate code that uses (does not use) the load string instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6726 |
and the store string word instructions to save multiple registers and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6727 |
do small block moves. These instructions are generated by default on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6728 |
\&\s-1POWER\s0 systems, and not generated on PowerPC systems. Do not use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6729 |
\&\fB\-mstring\fR on little endian PowerPC systems, since those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6730 |
instructions do not work when the processor is in little endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6731 |
The exceptions are \s-1PPC740\s0 and \s-1PPC750\s0 which permit the instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6732 |
usage in little endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6733 |
.Ip "\fB\-mupdate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6734 |
.IX Item "-mupdate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6735 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6736 |
.Ip "\fB\-mno-update\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6737 |
.IX Item "-mno-update" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6738 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6739 |
Generate code that uses (does not use) the load or store instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6740 |
that update the base register to the address of the calculated memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6741 |
location. These instructions are generated by default. If you use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6742 |
\&\fB\-mno-update\fR, there is a small window between the time that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6743 |
stack pointer is updated and the address of the previous frame is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6744 |
stored, which means code that walks the stack frame across interrupts or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6745 |
signals may get corrupted data. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6746 |
.Ip "\fB\-mfused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6747 |
.IX Item "-mfused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6748 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6749 |
.Ip "\fB\-mno-fused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6750 |
.IX Item "-mno-fused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6751 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6752 |
Generate code that uses (does not use) the floating point multiply and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6753 |
accumulate instructions. These instructions are generated by default if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6754 |
hardware floating is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6755 |
.Ip "\fB\-mno-bit-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6756 |
.IX Item "-mno-bit-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6757 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6758 |
.Ip "\fB\-mbit-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6759 |
.IX Item "-mbit-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6760 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6761 |
On System V.4 and embedded PowerPC systems do not (do) force structures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6762 |
and unions that contain bit-fields to be aligned to the base type of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6763 |
bit-field. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6764 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6765 |
For example, by default a structure containing nothing but 8 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6766 |
\&\f(CW\*(C`unsigned\*(C'\fR bit-fields of length 1 would be aligned to a 4 byte |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6767 |
boundary and have a size of 4 bytes. By using \fB\-mno-bit-align\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6768 |
the structure would be aligned to a 1 byte boundary and be one byte in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6769 |
size. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6770 |
.Ip "\fB\-mno-strict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6771 |
.IX Item "-mno-strict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6772 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6773 |
.Ip "\fB\-mstrict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6774 |
.IX Item "-mstrict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6775 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6776 |
On System V.4 and embedded PowerPC systems do not (do) assume that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6777 |
unaligned memory references will be handled by the system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6778 |
.Ip "\fB\-mrelocatable\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6779 |
.IX Item "-mrelocatable" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6780 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6781 |
.Ip "\fB\-mno-relocatable\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6782 |
.IX Item "-mno-relocatable" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6783 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6784 |
On embedded PowerPC systems generate code that allows (does not allow) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6785 |
the program to be relocated to a different address at runtime. If you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6786 |
use \fB\-mrelocatable\fR on any module, all objects linked together must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6787 |
be compiled with \fB\-mrelocatable\fR or \fB\-mrelocatable-lib\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6788 |
.Ip "\fB\-mrelocatable-lib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6789 |
.IX Item "-mrelocatable-lib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6790 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6791 |
.Ip "\fB\-mno-relocatable-lib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6792 |
.IX Item "-mno-relocatable-lib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6793 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6794 |
On embedded PowerPC systems generate code that allows (does not allow) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6795 |
the program to be relocated to a different address at runtime. Modules |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6796 |
compiled with \fB\-mrelocatable-lib\fR can be linked with either modules |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6797 |
compiled without \fB\-mrelocatable\fR and \fB\-mrelocatable-lib\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6798 |
with modules compiled with the \fB\-mrelocatable\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6799 |
.Ip "\fB\-mno-toc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6800 |
.IX Item "-mno-toc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6801 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6802 |
.Ip "\fB\-mtoc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6803 |
.IX Item "-mtoc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6804 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6805 |
On System V.4 and embedded PowerPC systems do not (do) assume that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6806 |
register 2 contains a pointer to a global area pointing to the addresses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6807 |
used in the program. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6808 |
.Ip "\fB\-mlittle\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6809 |
.IX Item "-mlittle" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6810 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6811 |
.Ip "\fB\-mlittle-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6812 |
.IX Item "-mlittle-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6813 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6814 |
On System V.4 and embedded PowerPC systems compile code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6815 |
processor in little endian mode. The \fB\-mlittle-endian\fR option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6816 |
the same as \fB\-mlittle\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6817 |
.Ip "\fB\-mbig\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6818 |
.IX Item "-mbig" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6819 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6820 |
.Ip "\fB\-mbig-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6821 |
.IX Item "-mbig-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6822 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6823 |
On System V.4 and embedded PowerPC systems compile code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6824 |
processor in big endian mode. The \fB\-mbig-endian\fR option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6825 |
the same as \fB\-mbig\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6826 |
.Ip "\fB\-mdynamic-no-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6827 |
.IX Item "-mdynamic-no-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6828 |
On Darwin and Mac \s-1OS\s0 X systems, compile code so that it is not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6829 |
relocatable, but that its external references are relocatable. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6830 |
resulting code is suitable for applications, but not shared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6831 |
libraries. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6832 |
.Ip "\fB\-mprioritize-restricted-insns=\fR\fIpriority\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6833 |
.IX Item "-mprioritize-restricted-insns=priority" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6834 |
This option controls the priority that is assigned to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6835 |
dispatch-slot restricted instructions during the second scheduling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6836 |
pass. The argument \fIpriority\fR takes the value \fI0/1/2\fR to assign |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6837 |
\&\fIno/highest/second-highest\fR priority to dispatch slot restricted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6838 |
instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6839 |
.Ip "\fB\-msched-costly-dep=\fR\fIdependence_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6840 |
.IX Item "-msched-costly-dep=dependence_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6841 |
This option controls which dependences are considered costly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6842 |
by the target during instruction scheduling. The argument |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6843 |
\&\fIdependence_type\fR takes one of the following values: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6844 |
\&\fIno\fR: no dependence is costly, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6845 |
\&\fIall\fR: all dependences are costly, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6846 |
\&\fItrue_store_to_load\fR: a true dependence from store to load is costly, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6847 |
\&\fIstore_to_load\fR: any dependence from store to load is costly, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6848 |
\&\fInumber\fR: any dependence which latency >= \fInumber\fR is costly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6849 |
.Ip "\fB\-minsert-sched-nops=\fR\fIscheme\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6850 |
.IX Item "-minsert-sched-nops=scheme" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6851 |
This option controls which nop insertion scheme will be used during |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6852 |
the second scheduling pass. The argument \fIscheme\fR takes one of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6853 |
following values: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6854 |
\&\fIno\fR: Don't insert nops. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6855 |
\&\fIpad\fR: Pad with nops any dispatch group which has vacant issue slots, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6856 |
according to the scheduler's grouping. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6857 |
\&\fIregroup_exact\fR: Insert nops to force costly dependent insns into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6858 |
separate groups. Insert exactly as many nops as needed to force an insn |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6859 |
to a new group, according to the estimated processor grouping. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6860 |
\&\fInumber\fR: Insert nops to force costly dependent insns into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6861 |
separate groups. Insert \fInumber\fR nops to force an insn to a new group. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6862 |
.Ip "\fB\-mcall-sysv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6863 |
.IX Item "-mcall-sysv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6864 |
On System V.4 and embedded PowerPC systems compile code using calling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6865 |
conventions that adheres to the March 1995 draft of the System V |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6866 |
Application Binary Interface, PowerPC processor supplement. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6867 |
default unless you configured \s-1GCC\s0 using \fBpowerpc-*\-eabiaix\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6868 |
.Ip "\fB\-mcall-sysv-eabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6869 |
.IX Item "-mcall-sysv-eabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6870 |
Specify both \fB\-mcall-sysv\fR and \fB\-meabi\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6871 |
.Ip "\fB\-mcall-sysv-noeabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6872 |
.IX Item "-mcall-sysv-noeabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6873 |
Specify both \fB\-mcall-sysv\fR and \fB\-mno-eabi\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6874 |
.Ip "\fB\-mcall-solaris\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6875 |
.IX Item "-mcall-solaris" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6876 |
On System V.4 and embedded PowerPC systems compile code for the Solaris |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6877 |
operating system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6878 |
.Ip "\fB\-mcall-linux\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6879 |
.IX Item "-mcall-linux" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6880 |
On System V.4 and embedded PowerPC systems compile code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6881 |
Linux-based \s-1GNU\s0 system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6882 |
.Ip "\fB\-mcall-gnu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6883 |
.IX Item "-mcall-gnu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6884 |
On System V.4 and embedded PowerPC systems compile code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6885 |
Hurd-based \s-1GNU\s0 system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6886 |
.Ip "\fB\-mcall-netbsd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6887 |
.IX Item "-mcall-netbsd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6888 |
On System V.4 and embedded PowerPC systems compile code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6889 |
NetBSD operating system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6890 |
.Ip "\fB\-maix-struct-return\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6891 |
.IX Item "-maix-struct-return" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6892 |
Return all structures in memory (as specified by the \s-1AIX\s0 \s-1ABI\s0). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6893 |
.Ip "\fB\-msvr4\-struct-return\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6894 |
.IX Item "-msvr4-struct-return" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6895 |
Return structures smaller than 8 bytes in registers (as specified by the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6896 |
\&\s-1SVR4\s0 \s-1ABI\s0). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6897 |
.Ip "\fB\-mabi=altivec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6898 |
.IX Item "-mabi=altivec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6899 |
Extend the current \s-1ABI\s0 with AltiVec \s-1ABI\s0 extensions. This does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6900 |
change the default \s-1ABI\s0, instead it adds the AltiVec \s-1ABI\s0 extensions to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6901 |
the current \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6902 |
.Ip "\fB\-mabi=no-altivec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6903 |
.IX Item "-mabi=no-altivec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6904 |
Disable AltiVec \s-1ABI\s0 extensions for the current \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6905 |
.Ip "\fB\-mprototype\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6906 |
.IX Item "-mprototype" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6907 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6908 |
.Ip "\fB\-mno-prototype\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6909 |
.IX Item "-mno-prototype" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6910 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6911 |
On System V.4 and embedded PowerPC systems assume that all calls to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6912 |
variable argument functions are properly prototyped. Otherwise, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6913 |
compiler must insert an instruction before every non prototyped call to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6914 |
set or clear bit 6 of the condition code register (\fI\s-1CR\s0\fR) to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6915 |
indicate whether floating point values were passed in the floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6916 |
registers in case the function takes a variable arguments. With |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6917 |
\&\fB\-mprototype\fR, only calls to prototyped variable argument functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6918 |
will set or clear the bit. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6919 |
.Ip "\fB\-msim\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6920 |
.IX Item "-msim" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6921 |
On embedded PowerPC systems, assume that the startup module is called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6922 |
\&\fIsim-crt0.o\fR and that the standard C libraries are \fIlibsim.a\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6923 |
\&\fIlibc.a\fR. This is the default for \fBpowerpc-*\-eabisim\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6924 |
configurations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6925 |
.Ip "\fB\-mmvme\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6926 |
.IX Item "-mmvme" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6927 |
On embedded PowerPC systems, assume that the startup module is called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6928 |
\&\fIcrt0.o\fR and the standard C libraries are \fIlibmvme.a\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6929 |
\&\fIlibc.a\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6930 |
.Ip "\fB\-mads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6931 |
.IX Item "-mads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6932 |
On embedded PowerPC systems, assume that the startup module is called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6933 |
\&\fIcrt0.o\fR and the standard C libraries are \fIlibads.a\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6934 |
\&\fIlibc.a\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6935 |
.Ip "\fB\-myellowknife\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6936 |
.IX Item "-myellowknife" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6937 |
On embedded PowerPC systems, assume that the startup module is called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6938 |
\&\fIcrt0.o\fR and the standard C libraries are \fIlibyk.a\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6939 |
\&\fIlibc.a\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6940 |
.Ip "\fB\-mvxworks\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6941 |
.IX Item "-mvxworks" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6942 |
On System V.4 and embedded PowerPC systems, specify that you are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6943 |
compiling for a VxWorks system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6944 |
.Ip "\fB\-mwindiss\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6945 |
.IX Item "-mwindiss" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6946 |
Specify that you are compiling for the WindISS simulation environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6947 |
.Ip "\fB\-memb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6948 |
.IX Item "-memb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6949 |
On embedded PowerPC systems, set the \fI\s-1PPC_EMB\s0\fR bit in the \s-1ELF\s0 flags |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6950 |
header to indicate that \fBeabi\fR extended relocations are used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6951 |
.Ip "\fB\-meabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6952 |
.IX Item "-meabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6953 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6954 |
.Ip "\fB\-mno-eabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6955 |
.IX Item "-mno-eabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6956 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6957 |
On System V.4 and embedded PowerPC systems do (do not) adhere to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6958 |
Embedded Applications Binary Interface (eabi) which is a set of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6959 |
modifications to the System V.4 specifications. Selecting \fB\-meabi\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6960 |
means that the stack is aligned to an 8 byte boundary, a function |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6961 |
\&\f(CW\*(C`_\|_eabi\*(C'\fR is called to from \f(CW\*(C`main\*(C'\fR to set up the eabi |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6962 |
environment, and the \fB\-msdata\fR option can use both \f(CW\*(C`r2\*(C'\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6963 |
\&\f(CW\*(C`r13\*(C'\fR to point to two separate small data areas. Selecting |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6964 |
\&\fB\-mno-eabi\fR means that the stack is aligned to a 16 byte boundary, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6965 |
do not call an initialization function from \f(CW\*(C`main\*(C'\fR, and the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6966 |
\&\fB\-msdata\fR option will only use \f(CW\*(C`r13\*(C'\fR to point to a single |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6967 |
small data area. The \fB\-meabi\fR option is on by default if you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6968 |
configured \s-1GCC\s0 using one of the \fBpowerpc*\-*\-eabi*\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6969 |
.Ip "\fB\-msdata=eabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6970 |
.IX Item "-msdata=eabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6971 |
On System V.4 and embedded PowerPC systems, put small initialized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6972 |
\&\f(CW\*(C`const\*(C'\fR global and static data in the \fB.sdata2\fR section, which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6973 |
is pointed to by register \f(CW\*(C`r2\*(C'\fR. Put small initialized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6974 |
non-\f(CW\*(C`const\*(C'\fR global and static data in the \fB.sdata\fR section, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6975 |
which is pointed to by register \f(CW\*(C`r13\*(C'\fR. Put small uninitialized |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6976 |
global and static data in the \fB.sbss\fR section, which is adjacent to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6977 |
the \fB.sdata\fR section. The \fB\-msdata=eabi\fR option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6978 |
incompatible with the \fB\-mrelocatable\fR option. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6979 |
\&\fB\-msdata=eabi\fR option also sets the \fB\-memb\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6980 |
.Ip "\fB\-msdata=sysv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6981 |
.IX Item "-msdata=sysv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6982 |
On System V.4 and embedded PowerPC systems, put small global and static |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6983 |
data in the \fB.sdata\fR section, which is pointed to by register |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6984 |
\&\f(CW\*(C`r13\*(C'\fR. Put small uninitialized global and static data in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6985 |
\&\fB.sbss\fR section, which is adjacent to the \fB.sdata\fR section. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6986 |
The \fB\-msdata=sysv\fR option is incompatible with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6987 |
\&\fB\-mrelocatable\fR option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6988 |
.Ip "\fB\-msdata=default\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6989 |
.IX Item "-msdata=default" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6990 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6991 |
.Ip "\fB\-msdata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6992 |
.IX Item "-msdata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6993 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6994 |
On System V.4 and embedded PowerPC systems, if \fB\-meabi\fR is used, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6995 |
compile code the same as \fB\-msdata=eabi\fR, otherwise compile code the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6996 |
same as \fB\-msdata=sysv\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6997 |
.Ip "\fB\-msdata-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6998 |
.IX Item "-msdata-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
6999 |
On System V.4 and embedded PowerPC systems, put small global and static |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7000 |
data in the \fB.sdata\fR section. Put small uninitialized global and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7001 |
static data in the \fB.sbss\fR section. Do not use register \f(CW\*(C`r13\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7002 |
to address small data however. This is the default behavior unless |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7003 |
other \fB\-msdata\fR options are used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7004 |
.Ip "\fB\-msdata=none\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7005 |
.IX Item "-msdata=none" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7006 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7007 |
.Ip "\fB\-mno-sdata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7008 |
.IX Item "-mno-sdata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7009 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7010 |
On embedded PowerPC systems, put all initialized global and static data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7011 |
in the \fB.data\fR section, and all uninitialized data in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7012 |
\&\fB.bss\fR section. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7013 |
.Ip "\fB\-G\fR \fInum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7014 |
.IX Item "-G num" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7015 |
On embedded PowerPC systems, put global and static items less than or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7016 |
equal to \fInum\fR bytes into the small data or bss sections instead of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7017 |
the normal data or bss section. By default, \fInum\fR is 8. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7018 |
\&\fB\-G\fR \fInum\fR switch is also passed to the linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7019 |
All modules should be compiled with the same \fB\-G\fR \fInum\fR value. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7020 |
.Ip "\fB\-mregnames\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7021 |
.IX Item "-mregnames" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7022 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7023 |
.Ip "\fB\-mno-regnames\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7024 |
.IX Item "-mno-regnames" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7025 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7026 |
On System V.4 and embedded PowerPC systems do (do not) emit register |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7027 |
names in the assembly language output using symbolic forms. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7028 |
.Ip "\fB\-mlongcall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7029 |
.IX Item "-mlongcall" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7030 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7031 |
.Ip "\fB\-mno-longcall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7032 |
.IX Item "-mno-longcall" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7033 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7034 |
Default to making all function calls via pointers, so that functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7035 |
which reside further than 64 megabytes (67,108,864 bytes) from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7036 |
current location can be called. This setting can be overridden by the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7037 |
\&\f(CW\*(C`shortcall\*(C'\fR function attribute, or by \f(CW\*(C`#pragma longcall(0)\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7038 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7039 |
Some linkers are capable of detecting out-of-range calls and generating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7040 |
glue code on the fly. On these systems, long calls are unnecessary and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7041 |
generate slower code. As of this writing, the \s-1AIX\s0 linker can do this, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7042 |
as can the \s-1GNU\s0 linker for PowerPC/64. It is planned to add this feature |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7043 |
to the \s-1GNU\s0 linker for 32\-bit PowerPC systems as well. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7044 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7045 |
On Mach-O (Darwin) systems, this option directs the compiler emit to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7046 |
the glue for every direct call, and the Darwin linker decides whether |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7047 |
to use or discard it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7048 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7049 |
In the future, we may cause \s-1GCC\s0 to ignore all longcall specifications |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7050 |
when the linker is known to generate glue. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7051 |
.Ip "\fB\-pthread\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7052 |
.IX Item "-pthread" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7053 |
Adds support for multithreading with the \fIpthreads\fR library. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7054 |
This option sets flags for both the preprocessor and linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7055 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7056 |
.I "Darwin Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7057 |
.IX Subsection "Darwin Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7058 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7059 |
These options are defined for all architectures running the Darwin operating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7060 |
system. They are useful for compatibility with other Mac \s-1OS\s0 compilers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7061 |
.Ip "\fB\-all_load\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7062 |
.IX Item "-all_load" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7063 |
Loads all members of static archive libraries. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7064 |
See man \fIld\fR\|(1) for more information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7065 |
.Ip "\fB\-arch_errors_fatal\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7066 |
.IX Item "-arch_errors_fatal" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7067 |
Cause the errors having to do with files that have the wrong architecture |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7068 |
to be fatal. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7069 |
.Ip "\fB\-bind_at_load\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7070 |
.IX Item "-bind_at_load" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7071 |
Causes the output file to be marked such that the dynamic linker will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7072 |
bind all undefined references when the file is loaded or launched. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7073 |
.Ip "\fB\-bundle\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7074 |
.IX Item "-bundle" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7075 |
Produce a Mach-o bundle format file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7076 |
See man \fIld\fR\|(1) for more information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7077 |
.Ip "\fB\-bundle_loader\fR \fIexecutable\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7078 |
.IX Item "-bundle_loader executable" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7079 |
This specifies the \fIexecutable\fR that will be loading the build |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7080 |
output file being linked. See man \fIld\fR\|(1) for more information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7081 |
.Ip "\fB\-allowable_client\fR \fIclient_name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7082 |
.IX Item "-allowable_client client_name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7083 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7084 |
.Ip "\fB\-arch_only\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7085 |
.IX Item "-arch_only" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7086 |
.Ip "\fB\-client_name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7087 |
.IX Item "-client_name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7088 |
.Ip "\fB\-compatibility_version\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7089 |
.IX Item "-compatibility_version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7090 |
.Ip "\fB\-current_version\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7091 |
.IX Item "-current_version" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7092 |
.Ip "\fB\-dependency-file\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7093 |
.IX Item "-dependency-file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7094 |
.Ip "\fB\-dylib_file\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7095 |
.IX Item "-dylib_file" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7096 |
.Ip "\fB\-dylinker_install_name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7097 |
.IX Item "-dylinker_install_name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7098 |
.Ip "\fB\-dynamic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7099 |
.IX Item "-dynamic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7100 |
.Ip "\fB\-dynamiclib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7101 |
.IX Item "-dynamiclib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7102 |
.Ip "\fB\-exported_symbols_list\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7103 |
.IX Item "-exported_symbols_list" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7104 |
.Ip "\fB\-filelist\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7105 |
.IX Item "-filelist" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7106 |
.Ip "\fB\-flat_namespace\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7107 |
.IX Item "-flat_namespace" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7108 |
.Ip "\fB\-force_cpusubtype_ALL\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7109 |
.IX Item "-force_cpusubtype_ALL" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7110 |
.Ip "\fB\-force_flat_namespace\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7111 |
.IX Item "-force_flat_namespace" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7112 |
.Ip "\fB\-headerpad_max_install_names\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7113 |
.IX Item "-headerpad_max_install_names" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7114 |
.Ip "\fB\-image_base\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7115 |
.IX Item "-image_base" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7116 |
.Ip "\fB\-init\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7117 |
.IX Item "-init" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7118 |
.Ip "\fB\-install_name\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7119 |
.IX Item "-install_name" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7120 |
.Ip "\fB\-keep_private_externs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7121 |
.IX Item "-keep_private_externs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7122 |
.Ip "\fB\-multi_module\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7123 |
.IX Item "-multi_module" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7124 |
.Ip "\fB\-multiply_defined\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7125 |
.IX Item "-multiply_defined" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7126 |
.Ip "\fB\-multiply_defined_unused\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7127 |
.IX Item "-multiply_defined_unused" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7128 |
.Ip "\fB\-noall_load\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7129 |
.IX Item "-noall_load" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7130 |
.Ip "\fB\-nofixprebinding\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7131 |
.IX Item "-nofixprebinding" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7132 |
.Ip "\fB\-nomultidefs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7133 |
.IX Item "-nomultidefs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7134 |
.Ip "\fB\-noprebind\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7135 |
.IX Item "-noprebind" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7136 |
.Ip "\fB\-noseglinkedit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7137 |
.IX Item "-noseglinkedit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7138 |
.Ip "\fB\-pagezero_size\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7139 |
.IX Item "-pagezero_size" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7140 |
.Ip "\fB\-prebind\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7141 |
.IX Item "-prebind" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7142 |
.Ip "\fB\-prebind_all_twolevel_modules\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7143 |
.IX Item "-prebind_all_twolevel_modules" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7144 |
.Ip "\fB\-private_bundle\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7145 |
.IX Item "-private_bundle" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7146 |
.Ip "\fB\-read_only_relocs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7147 |
.IX Item "-read_only_relocs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7148 |
.Ip "\fB\-sectalign\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7149 |
.IX Item "-sectalign" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7150 |
.Ip "\fB\-sectobjectsymbols\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7151 |
.IX Item "-sectobjectsymbols" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7152 |
.Ip "\fB\-whyload\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7153 |
.IX Item "-whyload" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7154 |
.Ip "\fB\-seg1addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7155 |
.IX Item "-seg1addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7156 |
.Ip "\fB\-sectcreate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7157 |
.IX Item "-sectcreate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7158 |
.Ip "\fB\-sectobjectsymbols\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7159 |
.IX Item "-sectobjectsymbols" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7160 |
.Ip "\fB\-sectorder\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7161 |
.IX Item "-sectorder" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7162 |
.Ip "\fB\-seg_addr_table\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7163 |
.IX Item "-seg_addr_table" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7164 |
.Ip "\fB\-seg_addr_table_filename\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7165 |
.IX Item "-seg_addr_table_filename" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7166 |
.Ip "\fB\-seglinkedit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7167 |
.IX Item "-seglinkedit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7168 |
.Ip "\fB\-segprot\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7169 |
.IX Item "-segprot" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7170 |
.Ip "\fB\-segs_read_only_addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7171 |
.IX Item "-segs_read_only_addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7172 |
.Ip "\fB\-segs_read_write_addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7173 |
.IX Item "-segs_read_write_addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7174 |
.Ip "\fB\-single_module\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7175 |
.IX Item "-single_module" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7176 |
.Ip "\fB\-static\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7177 |
.IX Item "-static" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7178 |
.Ip "\fB\-sub_library\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7179 |
.IX Item "-sub_library" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7180 |
.Ip "\fB\-sub_umbrella\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7181 |
.IX Item "-sub_umbrella" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7182 |
.Ip "\fB\-twolevel_namespace\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7183 |
.IX Item "-twolevel_namespace" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7184 |
.Ip "\fB\-umbrella\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7185 |
.IX Item "-umbrella" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7186 |
.Ip "\fB\-undefined\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7187 |
.IX Item "-undefined" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7188 |
.Ip "\fB\-unexported_symbols_list\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7189 |
.IX Item "-unexported_symbols_list" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7190 |
.Ip "\fB\-weak_reference_mismatches\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7191 |
.IX Item "-weak_reference_mismatches" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7192 |
.Ip "\fB\-whatsloaded\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7193 |
.IX Item "-whatsloaded" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7194 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7195 |
These options are available for Darwin linker. Darwin linker man page |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7196 |
describes them in detail. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7197 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7198 |
.I "\s-1MIPS\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7199 |
.IX Subsection "MIPS Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7200 |
.Ip "\fB\-EB\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7201 |
.IX Item "-EB" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7202 |
Generate big-endian code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7203 |
.Ip "\fB\-EL\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7204 |
.IX Item "-EL" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7205 |
Generate little-endian code. This is the default for \fBmips*el-*\-*\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7206 |
configurations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7207 |
.Ip "\fB\-march=\fR\fIarch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7208 |
.IX Item "-march=arch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7209 |
Generate code that will run on \fIarch\fR, which can be the name of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7210 |
generic \s-1MIPS\s0 \s-1ISA\s0, or the name of a particular processor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7211 |
The \s-1ISA\s0 names are: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7212 |
\&\fBmips1\fR, \fBmips2\fR, \fBmips3\fR, \fBmips4\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7213 |
\&\fBmips32\fR, \fBmips32r2\fR, and \fBmips64\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7214 |
The processor names are: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7215 |
\&\fB4kc\fR, \fB4kp\fR, \fB5kc\fR, \fB20kc\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7216 |
\&\fBm4k\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7217 |
\&\fBr2000\fR, \fBr3000\fR, \fBr3900\fR, \fBr4000\fR, \fBr4400\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7218 |
\&\fBr4600\fR, \fBr4650\fR, \fBr6000\fR, \fBr8000\fR, \fBrm7000\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7219 |
\&\fBrm9000\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7220 |
\&\fBorion\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7221 |
\&\fBsb1\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7222 |
\&\fBvr4100\fR, \fBvr4111\fR, \fBvr4120\fR, \fBvr4300\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7223 |
\&\fBvr5000\fR, \fBvr5400\fR and \fBvr5500\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7224 |
The special value \fBfrom-abi\fR selects the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7225 |
most compatible architecture for the selected \s-1ABI\s0 (that is, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7226 |
\&\fBmips1\fR for 32\-bit ABIs and \fBmips3\fR for 64\-bit ABIs). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7227 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7228 |
In processor names, a final \fB000\fR can be abbreviated as \fBk\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7229 |
(for example, \fB\-march=r2k\fR). Prefixes are optional, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7230 |
\&\fBvr\fR may be written \fBr\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7231 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7232 |
\&\s-1GCC\s0 defines two macros based on the value of this option. The first |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7233 |
is \fB_MIPS_ARCH\fR, which gives the name of target architecture, as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7234 |
a string. The second has the form \fB_MIPS_ARCH_\fR\fIfoo\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7235 |
where \fIfoo\fR is the capitalized value of \fB_MIPS_ARCH\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7236 |
For example, \fB\-march=r2000\fR will set \fB_MIPS_ARCH\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7237 |
to \fB\*(L"r2000\*(R"\fR and define the macro \fB_MIPS_ARCH_R2000\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7238 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7239 |
Note that the \fB_MIPS_ARCH\fR macro uses the processor names given |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7240 |
above. In other words, it will have the full prefix and will not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7241 |
abbreviate \fB000\fR as \fBk\fR. In the case of \fBfrom-abi\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7242 |
the macro names the resolved architecture (either \fB\*(L"mips1\*(R"\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7243 |
\&\fB\*(L"mips3\*(R"\fR). It names the default architecture when no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7244 |
\&\fB\-march\fR option is given. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7245 |
.Ip "\fB\-mtune=\fR\fIarch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7246 |
.IX Item "-mtune=arch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7247 |
Optimize for \fIarch\fR. Among other things, this option controls |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7248 |
the way instructions are scheduled, and the perceived cost of arithmetic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7249 |
operations. The list of \fIarch\fR values is the same as for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7250 |
\&\fB\-march\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7251 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7252 |
When this option is not used, \s-1GCC\s0 will optimize for the processor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7253 |
specified by \fB\-march\fR. By using \fB\-march\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7254 |
\&\fB\-mtune\fR together, it is possible to generate code that will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7255 |
run on a family of processors, but optimize the code for one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7256 |
particular member of that family. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7257 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7258 |
\&\fB\-mtune\fR defines the macros \fB_MIPS_TUNE\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7259 |
\&\fB_MIPS_TUNE_\fR\fIfoo\fR, which work in the same way as the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7260 |
\&\fB\-march\fR ones described above. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7261 |
.Ip "\fB\-mips1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7262 |
.IX Item "-mips1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7263 |
Equivalent to \fB\-march=mips1\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7264 |
.Ip "\fB\-mips2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7265 |
.IX Item "-mips2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7266 |
Equivalent to \fB\-march=mips2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7267 |
.Ip "\fB\-mips3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7268 |
.IX Item "-mips3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7269 |
Equivalent to \fB\-march=mips3\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7270 |
.Ip "\fB\-mips4\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7271 |
.IX Item "-mips4" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7272 |
Equivalent to \fB\-march=mips4\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7273 |
.Ip "\fB\-mips32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7274 |
.IX Item "-mips32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7275 |
Equivalent to \fB\-march=mips32\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7276 |
.Ip "\fB\-mips32r2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7277 |
.IX Item "-mips32r2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7278 |
Equivalent to \fB\-march=mips32r2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7279 |
.Ip "\fB\-mips64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7280 |
.IX Item "-mips64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7281 |
Equivalent to \fB\-march=mips64\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7282 |
.Ip "\fB\-mips16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7283 |
.IX Item "-mips16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7284 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7285 |
.Ip "\fB\-mno-mips16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7286 |
.IX Item "-mno-mips16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7287 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7288 |
Use (do not use) the \s-1MIPS16\s0 \s-1ISA\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7289 |
.Ip "\fB\-mabi=32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7290 |
.IX Item "-mabi=32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7291 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7292 |
.Ip "\fB\-mabi=o64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7293 |
.IX Item "-mabi=o64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7294 |
.Ip "\fB\-mabi=n32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7295 |
.IX Item "-mabi=n32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7296 |
.Ip "\fB\-mabi=64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7297 |
.IX Item "-mabi=64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7298 |
.Ip "\fB\-mabi=eabi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7299 |
.IX Item "-mabi=eabi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7300 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7301 |
Generate code for the given \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7302 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7303 |
Note that the \s-1EABI\s0 has a 32\-bit and a 64\-bit variant. \s-1GCC\s0 normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7304 |
generates 64\-bit code when you select a 64\-bit architecture, but you |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7305 |
can use \fB\-mgp32\fR to get 32\-bit code instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7306 |
.Ip "\fB\-mabicalls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7307 |
.IX Item "-mabicalls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7308 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7309 |
.Ip "\fB\-mno-abicalls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7310 |
.IX Item "-mno-abicalls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7311 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7312 |
Generate (do not generate) SVR4\-style position-independent code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7313 |
\&\fB\-mabicalls\fR is the default for SVR4\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7314 |
.Ip "\fB\-mxgot\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7315 |
.IX Item "-mxgot" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7316 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7317 |
.Ip "\fB\-mno-xgot\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7318 |
.IX Item "-mno-xgot" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7319 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7320 |
Lift (do not lift) the usual restrictions on the size of the global |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7321 |
offset table. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7322 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7323 |
\&\s-1GCC\s0 normally uses a single instruction to load values from the \s-1GOT\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7324 |
While this is relatively efficient, it will only work if the \s-1GOT\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7325 |
is smaller than about 64k. Anything larger will cause the linker |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7326 |
to report an error such as: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7327 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7328 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7329 |
\& relocation truncated to fit: R_MIPS_GOT16 foobar |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7330 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7331 |
If this happens, you should recompile your code with \fB\-mxgot\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7332 |
It should then work with very large GOTs, although it will also be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7333 |
less efficient, since it will take three instructions to fetch the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7334 |
value of a global symbol. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7335 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7336 |
Note that some linkers can create multiple GOTs. If you have such a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7337 |
linker, you should only need to use \fB\-mxgot\fR when a single object |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7338 |
file accesses more than 64k's worth of \s-1GOT\s0 entries. Very few do. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7339 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7340 |
These options have no effect unless \s-1GCC\s0 is generating position |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7341 |
independent code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7342 |
.Ip "\fB\-membedded-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7343 |
.IX Item "-membedded-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7344 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7345 |
.Ip "\fB\-mno-embedded-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7346 |
.IX Item "-mno-embedded-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7347 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7348 |
Generate (do not generate) position-independent code suitable for some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7349 |
embedded systems. All calls are made using \s-1PC\s0 relative addresses, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7350 |
all data is addressed using the \f(CW$gp\fR register. No more than 65536 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7351 |
bytes of global data may be used. This requires \s-1GNU\s0 as and \s-1GNU\s0 ld, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7352 |
which do most of the work. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7353 |
.Ip "\fB\-mgp32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7354 |
.IX Item "-mgp32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7355 |
Assume that general-purpose registers are 32 bits wide. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7356 |
.Ip "\fB\-mgp64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7357 |
.IX Item "-mgp64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7358 |
Assume that general-purpose registers are 64 bits wide. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7359 |
.Ip "\fB\-mfp32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7360 |
.IX Item "-mfp32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7361 |
Assume that floating-point registers are 32 bits wide. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7362 |
.Ip "\fB\-mfp64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7363 |
.IX Item "-mfp64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7364 |
Assume that floating-point registers are 64 bits wide. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7365 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7366 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7367 |
Use floating-point coprocessor instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7368 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7369 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7370 |
Do not use floating-point coprocessor instructions. Implement |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7371 |
floating-point calculations using library calls instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7372 |
.Ip "\fB\-msingle-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7373 |
.IX Item "-msingle-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7374 |
Assume that the floating-point coprocessor only supports single-precision |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7375 |
operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7376 |
.Ip "\fB\-mdouble-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7377 |
.IX Item "-mdouble-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7378 |
Assume that the floating-point coprocessor supports double-precision |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7379 |
operations. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7380 |
.Ip "\fB\-mint64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7381 |
.IX Item "-mint64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7382 |
Force \f(CW\*(C`int\*(C'\fR and \f(CW\*(C`long\*(C'\fR types to be 64 bits wide. See |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7383 |
\&\fB\-mlong32\fR for an explanation of the default and the way |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7384 |
that the pointer size is determined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7385 |
.Ip "\fB\-mlong64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7386 |
.IX Item "-mlong64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7387 |
Force \f(CW\*(C`long\*(C'\fR types to be 64 bits wide. See \fB\-mlong32\fR for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7388 |
an explanation of the default and the way that the pointer size is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7389 |
determined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7390 |
.Ip "\fB\-mlong32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7391 |
.IX Item "-mlong32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7392 |
Force \f(CW\*(C`long\*(C'\fR, \f(CW\*(C`int\*(C'\fR, and pointer types to be 32 bits wide. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7393 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7394 |
The default size of \f(CW\*(C`int\*(C'\fRs, \f(CW\*(C`long\*(C'\fRs and pointers depends on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7395 |
the \s-1ABI\s0. All the supported ABIs use 32\-bit \f(CW\*(C`int\*(C'\fRs. The n64 \s-1ABI\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7396 |
uses 64\-bit \f(CW\*(C`long\*(C'\fRs, as does the 64\-bit \s-1EABI\s0; the others use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7397 |
32\-bit \f(CW\*(C`long\*(C'\fRs. Pointers are the same size as \f(CW\*(C`long\*(C'\fRs, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7398 |
or the same size as integer registers, whichever is smaller. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7399 |
.Ip "\fB\-G\fR \fInum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7400 |
.IX Item "-G num" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7401 |
Put global and static items less than or equal to \fInum\fR bytes into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7402 |
the small data or bss section instead of the normal data or bss section. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7403 |
This allows the data to be accessed using a single instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7404 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7405 |
All modules should be compiled with the same \fB\-G\fR \fInum\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7406 |
value. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7407 |
.Ip "\fB\-membedded-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7408 |
.IX Item "-membedded-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7409 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7410 |
.Ip "\fB\-mno-embedded-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7411 |
.IX Item "-mno-embedded-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7412 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7413 |
Allocate variables to the read-only data section first if possible, then |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7414 |
next in the small data section if possible, otherwise in data. This gives |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7415 |
slightly slower code than the default, but reduces the amount of \s-1RAM\s0 required |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7416 |
when executing, and thus may be preferred for some embedded systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7417 |
.Ip "\fB\-muninit-const-in-rodata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7418 |
.IX Item "-muninit-const-in-rodata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7419 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7420 |
.Ip "\fB\-mno-uninit-const-in-rodata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7421 |
.IX Item "-mno-uninit-const-in-rodata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7422 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7423 |
Put uninitialized \f(CW\*(C`const\*(C'\fR variables in the read-only data section. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7424 |
This option is only meaningful in conjunction with \fB\-membedded-data\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7425 |
.Ip "\fB\-msplit-addresses\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7426 |
.IX Item "-msplit-addresses" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7427 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7428 |
.Ip "\fB\-mno-split-addresses\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7429 |
.IX Item "-mno-split-addresses" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7430 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7431 |
Enable (disable) use of the \f(CW\*(C`%hi()\*(C'\fR and \f(CW\*(C`%lo()\*(C'\fR assembler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7432 |
relocation operators. This option has been superceded by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7433 |
\&\fB\-mexplicit-relocs\fR but is retained for backwards compatibility. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7434 |
.Ip "\fB\-mexplicit-relocs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7435 |
.IX Item "-mexplicit-relocs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7436 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7437 |
.Ip "\fB\-mno-explicit-relocs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7438 |
.IX Item "-mno-explicit-relocs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7439 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7440 |
Use (do not use) assembler relocation operators when dealing with symbolic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7441 |
addresses. The alternative, selected by \fB\-mno-explicit-relocs\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7442 |
is to use assembler macros instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7443 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7444 |
\&\fB\-mexplicit-relocs\fR is usually the default if \s-1GCC\s0 was |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7445 |
configured to use an assembler that supports relocation operators. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7446 |
However, there are two exceptions: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7447 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7448 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7449 |
\&\s-1GCC\s0 is not yet able to generate explicit relocations for the combination |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7450 |
of \fB\-mabi=64\fR and \fB\-mno-abicalls\fR. This will be addressed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7451 |
in a future release. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7452 |
.Ip "\(bu" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7453 |
The combination of \fB\-mabicalls\fR and \fB\-fno-unit-at-a-time\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7454 |
implies \fB\-mno-explicit-relocs\fR unless explicitly overridden. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7455 |
This is because, when generating abicalls, the choice of relocation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7456 |
depends on whether a symbol is local or global. In some rare cases, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7457 |
\&\s-1GCC\s0 will not be able to decide this until the whole compilation unit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7458 |
has been read. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7459 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7460 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7461 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7462 |
.Ip "\fB\-mrnames\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7463 |
.IX Item "-mrnames" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7464 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7465 |
.Ip "\fB\-mno-rnames\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7466 |
.IX Item "-mno-rnames" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7467 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7468 |
Generate (do not generate) code that refers to registers using their |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7469 |
software names. The default is \fB\-mno-rnames\fR, which tells \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7470 |
to use hardware names like \fB$4\fR instead of software names like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7471 |
\&\fBa0\fR. The only assembler known to support \fB\-rnames\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7472 |
the Algorithmics assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7473 |
.Ip "\fB\-mcheck-zero-division\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7474 |
.IX Item "-mcheck-zero-division" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7475 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7476 |
.Ip "\fB\-mno-check-zero-division\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7477 |
.IX Item "-mno-check-zero-division" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7478 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7479 |
Trap (do not trap) on integer division by zero. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7480 |
\&\fB\-mcheck-zero-division\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7481 |
.Ip "\fB\-mmemcpy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7482 |
.IX Item "-mmemcpy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7483 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7484 |
.Ip "\fB\-mno-memcpy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7485 |
.IX Item "-mno-memcpy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7486 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7487 |
Force (do not force) the use of \f(CW\*(C`memcpy()\*(C'\fR for non-trivial block |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7488 |
moves. The default is \fB\-mno-memcpy\fR, which allows \s-1GCC\s0 to inline |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7489 |
most constant-sized copies. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7490 |
.Ip "\fB\-mlong-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7491 |
.IX Item "-mlong-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7492 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7493 |
.Ip "\fB\-mno-long-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7494 |
.IX Item "-mno-long-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7495 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7496 |
Disable (do not disable) use of the \f(CW\*(C`jal\*(C'\fR instruction. Calling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7497 |
functions using \f(CW\*(C`jal\*(C'\fR is more efficient but requires the caller |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7498 |
and callee to be in the same 256 megabyte segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7499 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7500 |
This option has no effect on abicalls code. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7501 |
\&\fB\-mno-long-calls\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7502 |
.Ip "\fB\-mmad\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7503 |
.IX Item "-mmad" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7504 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7505 |
.Ip "\fB\-mno-mad\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7506 |
.IX Item "-mno-mad" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7507 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7508 |
Enable (disable) use of the \f(CW\*(C`mad\*(C'\fR, \f(CW\*(C`madu\*(C'\fR and \f(CW\*(C`mul\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7509 |
instructions, as provided by the R4650 \s-1ISA\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7510 |
.Ip "\fB\-mfused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7511 |
.IX Item "-mfused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7512 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7513 |
.Ip "\fB\-mno-fused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7514 |
.IX Item "-mno-fused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7515 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7516 |
Enable (disable) use of the floating point multiply-accumulate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7517 |
instructions, when they are available. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7518 |
\&\fB\-mfused-madd\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7519 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7520 |
When multiply-accumulate instructions are used, the intermediate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7521 |
product is calculated to infinite precision and is not subject to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7522 |
the \s-1FCSR\s0 Flush to Zero bit. This may be undesirable in some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7523 |
circumstances. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7524 |
.Ip "\fB\-nocpp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7525 |
.IX Item "-nocpp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7526 |
Tell the \s-1MIPS\s0 assembler to not run its preprocessor over user |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7527 |
assembler files (with a \fB.s\fR suffix) when assembling them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7528 |
.Ip "\fB\-mfix-sb1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7529 |
.IX Item "-mfix-sb1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7530 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7531 |
.Ip "\fB\-mno-fix-sb1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7532 |
.IX Item "-mno-fix-sb1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7533 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7534 |
Work around certain \s-1SB-1\s0 \s-1CPU\s0 core errata. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7535 |
(This flag currently works around the \s-1SB-1\s0 revision 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7536 |
``F1'' and ``F2'' floating point errata.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7537 |
.Ip "\fB\-mflush-func=\fR\fIfunc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7538 |
.IX Item "-mflush-func=func" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7539 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7540 |
.Ip "\fB\-mno-flush-func\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7541 |
.IX Item "-mno-flush-func" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7542 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7543 |
Specifies the function to call to flush the I and D caches, or to not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7544 |
call any such function. If called, the function must take the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7545 |
arguments as the common \f(CW\*(C`_flush_func()\*(C'\fR, that is, the address of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7546 |
memory range for which the cache is being flushed, the size of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7547 |
memory range, and the number 3 (to flush both caches). The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7548 |
depends on the target \s-1GCC\s0 was configured for, but commonly is either |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7549 |
\&\fB_flush_func\fR or \fB_\|_cpu_flush\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7550 |
.Ip "\fB\-mbranch-likely\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7551 |
.IX Item "-mbranch-likely" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7552 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7553 |
.Ip "\fB\-mno-branch-likely\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7554 |
.IX Item "-mno-branch-likely" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7555 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7556 |
Enable or disable use of Branch Likely instructions, regardless of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7557 |
default for the selected architecture. By default, Branch Likely |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7558 |
instructions may be generated if they are supported by the selected |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7559 |
architecture. An exception is for the \s-1MIPS32\s0 and \s-1MIPS64\s0 architectures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7560 |
and processors which implement those architectures; for those, Branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7561 |
Likely instructions will not be generated by default because the \s-1MIPS32\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7562 |
and \s-1MIPS64\s0 architectures specifically deprecate their use. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7563 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7564 |
.I "Intel 386 and \s-1AMD\s0 x86\-64 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7565 |
.IX Subsection "Intel 386 and AMD x86-64 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7566 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7567 |
These \fB\-m\fR options are defined for the i386 and x86\-64 family of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7568 |
computers: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7569 |
.Ip "\fB\-mtune=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7570 |
.IX Item "-mtune=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7571 |
Tune to \fIcpu-type\fR everything applicable about the generated code, except |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7572 |
for the \s-1ABI\s0 and the set of available instructions. The choices for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7573 |
\&\fIcpu-type\fR are: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7574 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7575 |
.Ip "\fIi386\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7576 |
.IX Item "i386" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7577 |
Original Intel's i386 \s-1CPU\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7578 |
.Ip "\fIi486\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7579 |
.IX Item "i486" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7580 |
Intel's i486 \s-1CPU\s0. (No scheduling is implemented for this chip.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7581 |
.Ip "\fIi586, pentium\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7582 |
.IX Item "i586, pentium" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7583 |
Intel Pentium \s-1CPU\s0 with no \s-1MMX\s0 support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7584 |
.Ip "\fIpentium-mmx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7585 |
.IX Item "pentium-mmx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7586 |
Intel PentiumMMX \s-1CPU\s0 based on Pentium core with \s-1MMX\s0 instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7587 |
.Ip "\fIi686, pentiumpro\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7588 |
.IX Item "i686, pentiumpro" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7589 |
Intel PentiumPro \s-1CPU\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7590 |
.Ip "\fIpentium2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7591 |
.IX Item "pentium2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7592 |
Intel Pentium2 \s-1CPU\s0 based on PentiumPro core with \s-1MMX\s0 instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7593 |
.Ip "\fIpentium3, pentium3m\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7594 |
.IX Item "pentium3, pentium3m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7595 |
Intel Pentium3 \s-1CPU\s0 based on PentiumPro core with \s-1MMX\s0 and \s-1SSE\s0 instruction set |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7596 |
support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7597 |
.Ip "\fIpentium-m\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7598 |
.IX Item "pentium-m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7599 |
Low power version of Intel Pentium3 \s-1CPU\s0 with \s-1MMX\s0, \s-1SSE\s0 and \s-1SSE2\s0 instruction set |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7600 |
support. Used by Centrino notebooks. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7601 |
.Ip "\fIpentium4, pentium4m\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7602 |
.IX Item "pentium4, pentium4m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7603 |
Intel Pentium4 \s-1CPU\s0 with \s-1MMX\s0, \s-1SSE\s0 and \s-1SSE2\s0 instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7604 |
.Ip "\fIprescott\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7605 |
.IX Item "prescott" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7606 |
Improved version of Intel Pentium4 \s-1CPU\s0 with \s-1MMX\s0, \s-1SSE\s0, \s-1SSE2\s0 and \s-1SSE3\s0 instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7607 |
set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7608 |
.Ip "\fInocona\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7609 |
.IX Item "nocona" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7610 |
Improved version of Intel Pentium4 \s-1CPU\s0 with 64\-bit extensions, \s-1MMX\s0, \s-1SSE\s0, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7611 |
\&\s-1SSE2\s0 and \s-1SSE3\s0 instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7612 |
.Ip "\fIk6\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7613 |
.IX Item "k6" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7614 |
\&\s-1AMD\s0 K6 \s-1CPU\s0 with \s-1MMX\s0 instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7615 |
.Ip "\fIk6\-2, k6\-3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7616 |
.IX Item "k6-2, k6-3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7617 |
Improved versions of \s-1AMD\s0 K6 \s-1CPU\s0 with \s-1MMX\s0 and 3dNOW! instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7618 |
.Ip "\fIathlon, athlon-tbird\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7619 |
.IX Item "athlon, athlon-tbird" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7620 |
\&\s-1AMD\s0 Athlon \s-1CPU\s0 with \s-1MMX\s0, 3dNOW!, enhanced 3dNOW! and \s-1SSE\s0 prefetch instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7621 |
support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7622 |
.Ip "\fIathlon-4, athlon-xp, athlon-mp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7623 |
.IX Item "athlon-4, athlon-xp, athlon-mp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7624 |
Improved \s-1AMD\s0 Athlon \s-1CPU\s0 with \s-1MMX\s0, 3dNOW!, enhanced 3dNOW! and full \s-1SSE\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7625 |
instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7626 |
.Ip "\fIk8, opteron, athlon64, athlon-fx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7627 |
.IX Item "k8, opteron, athlon64, athlon-fx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7628 |
\&\s-1AMD\s0 K8 core based CPUs with x86\-64 instruction set support. (This supersets |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7629 |
\&\s-1MMX\s0, \s-1SSE\s0, \s-1SSE2\s0, 3dNOW!, enhanced 3dNOW! and 64\-bit instruction set extensions.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7630 |
.Ip "\fIwinchip-c6\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7631 |
.IX Item "winchip-c6" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7632 |
\&\s-1IDT\s0 Winchip C6 \s-1CPU\s0, dealt in same way as i486 with additional \s-1MMX\s0 instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7633 |
set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7634 |
.Ip "\fIwinchip2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7635 |
.IX Item "winchip2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7636 |
\&\s-1IDT\s0 Winchip2 \s-1CPU\s0, dealt in same way as i486 with additional \s-1MMX\s0 and 3dNOW! |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7637 |
instruction set support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7638 |
.Ip "\fIc3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7639 |
.IX Item "c3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7640 |
Via C3 \s-1CPU\s0 with \s-1MMX\s0 and 3dNOW! instruction set support. (No scheduling is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7641 |
implemented for this chip.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7642 |
.Ip "\fIc3\-2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7643 |
.IX Item "c3-2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7644 |
Via C3\-2 \s-1CPU\s0 with \s-1MMX\s0 and \s-1SSE\s0 instruction set support. (No scheduling is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7645 |
implemented for this chip.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7646 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7647 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7648 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7649 |
While picking a specific \fIcpu-type\fR will schedule things appropriately |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7650 |
for that particular chip, the compiler will not generate any code that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7651 |
does not run on the i386 without the \fB\-march=\fR\fIcpu-type\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7652 |
being used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7653 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7654 |
.Ip "\fB\-march=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7655 |
.IX Item "-march=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7656 |
Generate instructions for the machine type \fIcpu-type\fR. The choices |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7657 |
for \fIcpu-type\fR are the same as for \fB\-mtune\fR. Moreover, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7658 |
specifying \fB\-march=\fR\fIcpu-type\fR implies \fB\-mtune=\fR\fIcpu-type\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7659 |
.Ip "\fB\-mcpu=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7660 |
.IX Item "-mcpu=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7661 |
A deprecated synonym for \fB\-mtune\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7662 |
.Ip "\fB\-m386\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7663 |
.IX Item "-m386" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7664 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7665 |
.Ip "\fB\-m486\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7666 |
.IX Item "-m486" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7667 |
.Ip "\fB\-mpentium\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7668 |
.IX Item "-mpentium" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7669 |
.Ip "\fB\-mpentiumpro\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7670 |
.IX Item "-mpentiumpro" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7671 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7672 |
These options are synonyms for \fB\-mtune=i386\fR, \fB\-mtune=i486\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7673 |
\&\fB\-mtune=pentium\fR, and \fB\-mtune=pentiumpro\fR respectively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7674 |
These synonyms are deprecated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7675 |
.Ip "\fB\-mfpmath=\fR\fIunit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7676 |
.IX Item "-mfpmath=unit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7677 |
Generate floating point arithmetics for selected unit \fIunit\fR. The choices |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7678 |
for \fIunit\fR are: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7679 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7680 |
.Ip "\fB387\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7681 |
.IX Item "387" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7682 |
Use the standard 387 floating point coprocessor present majority of chips and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7683 |
emulated otherwise. Code compiled with this option will run almost everywhere. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7684 |
The temporary results are computed in 80bit precision instead of precision |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7685 |
specified by the type resulting in slightly different results compared to most |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7686 |
of other chips. See \fB\-ffloat-store\fR for more detailed description. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7687 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7688 |
This is the default choice for i386 compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7689 |
.Ip "\fBsse\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7690 |
.IX Item "sse" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7691 |
Use scalar floating point instructions present in the \s-1SSE\s0 instruction set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7692 |
This instruction set is supported by Pentium3 and newer chips, in the \s-1AMD\s0 line |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7693 |
by Athlon-4, Athlon-xp and Athlon-mp chips. The earlier version of \s-1SSE\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7694 |
instruction set supports only single precision arithmetics, thus the double and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7695 |
extended precision arithmetics is still done using 387. Later version, present |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7696 |
only in Pentium4 and the future \s-1AMD\s0 x86\-64 chips supports double precision |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7697 |
arithmetics too. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7698 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7699 |
For i387 you need to use \fB\-march=\fR\fIcpu-type\fR, \fB\-msse\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7700 |
\&\fB\-msse2\fR switches to enable \s-1SSE\s0 extensions and make this option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7701 |
effective. For x86\-64 compiler, these extensions are enabled by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7702 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7703 |
The resulting code should be considerably faster in the majority of cases and avoid |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7704 |
the numerical instability problems of 387 code, but may break some existing |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7705 |
code that expects temporaries to be 80bit. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7706 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7707 |
This is the default choice for the x86\-64 compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7708 |
.Ip "\fBsse,387\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7709 |
.IX Item "sse,387" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7710 |
Attempt to utilize both instruction sets at once. This effectively double the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7711 |
amount of available registers and on chips with separate execution units for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7712 |
387 and \s-1SSE\s0 the execution resources too. Use this option with care, as it is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7713 |
still experimental, because the \s-1GCC\s0 register allocator does not model separate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7714 |
functional units well resulting in instable performance. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7715 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7716 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7717 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7718 |
.Ip "\fB\-masm=\fR\fIdialect\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7719 |
.IX Item "-masm=dialect" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7720 |
Output asm instructions using selected \fIdialect\fR. Supported choices are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7721 |
\&\fBintel\fR or \fBatt\fR (the default one). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7722 |
.Ip "\fB\-mieee-fp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7723 |
.IX Item "-mieee-fp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7724 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7725 |
.Ip "\fB\-mno-ieee-fp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7726 |
.IX Item "-mno-ieee-fp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7727 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7728 |
Control whether or not the compiler uses \s-1IEEE\s0 floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7729 |
comparisons. These handle correctly the case where the result of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7730 |
comparison is unordered. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7731 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7732 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7733 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7734 |
\&\fBWarning:\fR the requisite libraries are not part of \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7735 |
Normally the facilities of the machine's usual C compiler are used, but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7736 |
this can't be done directly in cross-compilation. You must make your |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7737 |
own arrangements to provide suitable library functions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7738 |
cross-compilation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7739 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7740 |
On machines where a function returns floating point results in the 80387 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7741 |
register stack, some floating point opcodes may be emitted even if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7742 |
\&\fB\-msoft-float\fR is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7743 |
.Ip "\fB\-mno-fp-ret-in-387\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7744 |
.IX Item "-mno-fp-ret-in-387" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7745 |
Do not use the \s-1FPU\s0 registers for return values of functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7746 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7747 |
The usual calling convention has functions return values of types |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7748 |
\&\f(CW\*(C`float\*(C'\fR and \f(CW\*(C`double\*(C'\fR in an \s-1FPU\s0 register, even if there |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7749 |
is no \s-1FPU\s0. The idea is that the operating system should emulate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7750 |
an \s-1FPU\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7751 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7752 |
The option \fB\-mno-fp-ret-in-387\fR causes such values to be returned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7753 |
in ordinary \s-1CPU\s0 registers instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7754 |
.Ip "\fB\-mno-fancy-math-387\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7755 |
.IX Item "-mno-fancy-math-387" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7756 |
Some 387 emulators do not support the \f(CW\*(C`sin\*(C'\fR, \f(CW\*(C`cos\*(C'\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7757 |
\&\f(CW\*(C`sqrt\*(C'\fR instructions for the 387. Specify this option to avoid |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7758 |
generating those instructions. This option is the default on FreeBSD, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7759 |
OpenBSD and NetBSD. This option is overridden when \fB\-march\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7760 |
indicates that the target cpu will always have an \s-1FPU\s0 and so the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7761 |
instruction will not need emulation. As of revision 2.6.1, these |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7762 |
instructions are not generated unless you also use the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7763 |
\&\fB\-funsafe-math-optimizations\fR switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7764 |
.Ip "\fB\-malign-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7765 |
.IX Item "-malign-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7766 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7767 |
.Ip "\fB\-mno-align-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7768 |
.IX Item "-mno-align-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7769 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7770 |
Control whether \s-1GCC\s0 aligns \f(CW\*(C`double\*(C'\fR, \f(CW\*(C`long double\*(C'\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7771 |
\&\f(CW\*(C`long long\*(C'\fR variables on a two word boundary or a one word |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7772 |
boundary. Aligning \f(CW\*(C`double\*(C'\fR variables on a two word boundary will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7773 |
produce code that runs somewhat faster on a \fBPentium\fR at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7774 |
expense of more memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7775 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7776 |
\&\fBWarning:\fR if you use the \fB\-malign-double\fR switch, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7777 |
structures containing the above types will be aligned differently than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7778 |
the published application binary interface specifications for the 386 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7779 |
and will not be binary compatible with structures in code compiled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7780 |
without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7781 |
.Ip "\fB\-m96bit-long-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7782 |
.IX Item "-m96bit-long-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7783 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7784 |
.Ip "\fB\-m128bit-long-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7785 |
.IX Item "-m128bit-long-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7786 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7787 |
These switches control the size of \f(CW\*(C`long double\*(C'\fR type. The i386 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7788 |
application binary interface specifies the size to be 96 bits, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7789 |
so \fB\-m96bit-long-double\fR is the default in 32 bit mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7790 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7791 |
Modern architectures (Pentium and newer) would prefer \f(CW\*(C`long double\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7792 |
to be aligned to an 8 or 16 byte boundary. In arrays or structures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7793 |
conforming to the \s-1ABI\s0, this would not be possible. So specifying a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7794 |
\&\fB\-m128bit-long-double\fR will align \f(CW\*(C`long double\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7795 |
to a 16 byte boundary by padding the \f(CW\*(C`long double\*(C'\fR with an additional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7796 |
32 bit zero. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7797 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7798 |
In the x86\-64 compiler, \fB\-m128bit-long-double\fR is the default choice as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7799 |
its \s-1ABI\s0 specifies that \f(CW\*(C`long double\*(C'\fR is to be aligned on 16 byte boundary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7800 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7801 |
Notice that neither of these options enable any extra precision over the x87 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7802 |
standard of 80 bits for a \f(CW\*(C`long double\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7803 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7804 |
\&\fBWarning:\fR if you override the default value for your target \s-1ABI\s0, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7805 |
structures and arrays containing \f(CW\*(C`long double\*(C'\fR variables will change |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7806 |
their size as well as function calling convention for function taking |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7807 |
\&\f(CW\*(C`long double\*(C'\fR will be modified. Hence they will not be binary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7808 |
compatible with arrays or structures in code compiled without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7809 |
.Ip "\fB\-msvr3\-shlib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7810 |
.IX Item "-msvr3-shlib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7811 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7812 |
.Ip "\fB\-mno-svr3\-shlib\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7813 |
.IX Item "-mno-svr3-shlib" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7814 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7815 |
Control whether \s-1GCC\s0 places uninitialized local variables into the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7816 |
\&\f(CW\*(C`bss\*(C'\fR or \f(CW\*(C`data\*(C'\fR segments. \fB\-msvr3\-shlib\fR places them |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7817 |
into \f(CW\*(C`bss\*(C'\fR. These options are meaningful only on System V Release 3. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7818 |
.Ip "\fB\-mrtd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7819 |
.IX Item "-mrtd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7820 |
Use a different function-calling convention, in which functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7821 |
take a fixed number of arguments return with the \f(CW\*(C`ret\*(C'\fR \fInum\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7822 |
instruction, which pops their arguments while returning. This saves one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7823 |
instruction in the caller since there is no need to pop the arguments |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7824 |
there. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7825 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7826 |
You can specify that an individual function is called with this calling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7827 |
sequence with the function attribute \fBstdcall\fR. You can also |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7828 |
override the \fB\-mrtd\fR option by using the function attribute |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7829 |
\&\fBcdecl\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7830 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7831 |
\&\fBWarning:\fR this calling convention is incompatible with the one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7832 |
normally used on Unix, so you cannot use it if you need to call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7833 |
libraries compiled with the Unix compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7834 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7835 |
Also, you must provide function prototypes for all functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7836 |
take variable numbers of arguments (including \f(CW\*(C`printf\*(C'\fR); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7837 |
otherwise incorrect code will be generated for calls to those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7838 |
functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7839 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7840 |
In addition, seriously incorrect code will result if you call a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7841 |
function with too many arguments. (Normally, extra arguments are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7842 |
harmlessly ignored.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7843 |
.Ip "\fB\-mregparm=\fR\fInum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7844 |
.IX Item "-mregparm=num" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7845 |
Control how many registers are used to pass integer arguments. By |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7846 |
default, no registers are used to pass arguments, and at most 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7847 |
registers can be used. You can control this behavior for a specific |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7848 |
function by using the function attribute \fBregparm\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7849 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7850 |
\&\fBWarning:\fR if you use this switch, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7851 |
\&\fInum\fR is nonzero, then you must build all modules with the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7852 |
value, including any libraries. This includes the system libraries and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7853 |
startup modules. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7854 |
.Ip "\fB\-mpreferred-stack-boundary=\fR\fInum\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7855 |
.IX Item "-mpreferred-stack-boundary=num" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7856 |
Attempt to keep the stack boundary aligned to a 2 raised to \fInum\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7857 |
byte boundary. If \fB\-mpreferred-stack-boundary\fR is not specified, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7858 |
the default is 4 (16 bytes or 128 bits), except when optimizing for code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7859 |
size (\fB\-Os\fR), in which case the default is the minimum correct |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7860 |
alignment (4 bytes for x86, and 8 bytes for x86\-64). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7861 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7862 |
On Pentium and PentiumPro, \f(CW\*(C`double\*(C'\fR and \f(CW\*(C`long double\*(C'\fR values |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7863 |
should be aligned to an 8 byte boundary (see \fB\-malign-double\fR) or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7864 |
suffer significant run time performance penalties. On Pentium \s-1III\s0, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7865 |
Streaming \s-1SIMD\s0 Extension (\s-1SSE\s0) data type \f(CW\*(C`_\|_m128\*(C'\fR suffers similar |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7866 |
penalties if it is not 16 byte aligned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7867 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7868 |
To ensure proper alignment of this values on the stack, the stack boundary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7869 |
must be as aligned as that required by any value stored on the stack. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7870 |
Further, every function must be generated such that it keeps the stack |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7871 |
aligned. Thus calling a function compiled with a higher preferred |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7872 |
stack boundary from a function compiled with a lower preferred stack |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7873 |
boundary will most likely misalign the stack. It is recommended that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7874 |
libraries that use callbacks always use the default setting. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7875 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7876 |
This extra alignment does consume extra stack space, and generally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7877 |
increases code size. Code that is sensitive to stack space usage, such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7878 |
as embedded systems and operating system kernels, may want to reduce the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7879 |
preferred alignment to \fB\-mpreferred-stack-boundary=2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7880 |
.Ip "\fB\-mmmx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7881 |
.IX Item "-mmmx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7882 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7883 |
.Ip "\fB\-mno-mmx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7884 |
.IX Item "-mno-mmx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7885 |
.Ip "\fB\-msse\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7886 |
.IX Item "-msse" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7887 |
.Ip "\fB\-mno-sse\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7888 |
.IX Item "-mno-sse" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7889 |
.Ip "\fB\-msse2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7890 |
.IX Item "-msse2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7891 |
.Ip "\fB\-mno-sse2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7892 |
.IX Item "-mno-sse2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7893 |
.Ip "\fB\-msse3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7894 |
.IX Item "-msse3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7895 |
.Ip "\fB\-mno-sse3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7896 |
.IX Item "-mno-sse3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7897 |
.Ip "\fB\-m3dnow\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7898 |
.IX Item "-m3dnow" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7899 |
.Ip "\fB\-mno-3dnow\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7900 |
.IX Item "-mno-3dnow" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7901 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7902 |
These switches enable or disable the use of built-in functions that allow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7903 |
direct access to the \s-1MMX\s0, \s-1SSE\s0, \s-1SSE2\s0, \s-1SSE3\s0 and 3Dnow extensions of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7904 |
instruction set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7905 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7906 |
To have \s-1SSE/SSE2\s0 instructions generated automatically from floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7907 |
code, see \fB\-mfpmath=sse\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7908 |
.Ip "\fB\-mpush-args\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7909 |
.IX Item "-mpush-args" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7910 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7911 |
.Ip "\fB\-mno-push-args\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7912 |
.IX Item "-mno-push-args" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7913 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7914 |
Use \s-1PUSH\s0 operations to store outgoing parameters. This method is shorter |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7915 |
and usually equally fast as method using \s-1SUB/MOV\s0 operations and is enabled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7916 |
by default. In some cases disabling it may improve performance because of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7917 |
improved scheduling and reduced dependencies. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7918 |
.Ip "\fB\-maccumulate-outgoing-args\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7919 |
.IX Item "-maccumulate-outgoing-args" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7920 |
If enabled, the maximum amount of space required for outgoing arguments will be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7921 |
computed in the function prologue. This is faster on most modern CPUs |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7922 |
because of reduced dependencies, improved scheduling and reduced stack usage |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7923 |
when preferred stack boundary is not equal to 2. The drawback is a notable |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7924 |
increase in code size. This switch implies \fB\-mno-push-args\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7925 |
.Ip "\fB\-mthreads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7926 |
.IX Item "-mthreads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7927 |
Support thread-safe exception handling on \fBMingw32\fR. Code that relies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7928 |
on thread-safe exception handling must compile and link all code with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7929 |
\&\fB\-mthreads\fR option. When compiling, \fB\-mthreads\fR defines |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7930 |
\&\fB\-D_MT\fR; when linking, it links in a special thread helper library |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7931 |
\&\fB\-lmingwthrd\fR which cleans up per thread exception handling data. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7932 |
.Ip "\fB\-mno-align-stringops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7933 |
.IX Item "-mno-align-stringops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7934 |
Do not align destination of inlined string operations. This switch reduces |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7935 |
code size and improves performance in case the destination is already aligned, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7936 |
but \s-1GCC\s0 doesn't know about it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7937 |
.Ip "\fB\-minline-all-stringops\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7938 |
.IX Item "-minline-all-stringops" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7939 |
By default \s-1GCC\s0 inlines string operations only when destination is known to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7940 |
aligned at least to 4 byte boundary. This enables more inlining, increase code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7941 |
size, but may improve performance of code that depends on fast memcpy, strlen |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7942 |
and memset for short lengths. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7943 |
.Ip "\fB\-momit-leaf-frame-pointer\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7944 |
.IX Item "-momit-leaf-frame-pointer" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7945 |
Don't keep the frame pointer in a register for leaf functions. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7946 |
avoids the instructions to save, set up and restore frame pointers and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7947 |
makes an extra register available in leaf functions. The option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7948 |
\&\fB\-fomit-frame-pointer\fR removes the frame pointer for all functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7949 |
which might make debugging harder. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7950 |
.Ip "\fB\-mtls-direct-seg-refs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7951 |
.IX Item "-mtls-direct-seg-refs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7952 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7953 |
.Ip "\fB\-mno-tls-direct-seg-refs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7954 |
.IX Item "-mno-tls-direct-seg-refs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7955 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7956 |
Controls whether \s-1TLS\s0 variables may be accessed with offsets from the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7957 |
\&\s-1TLS\s0 segment register (\f(CW\*(C`%gs\*(C'\fR for 32\-bit, \f(CW\*(C`%fs\*(C'\fR for 64\-bit), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7958 |
or whether the thread base pointer must be added. Whether or not this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7959 |
is legal depends on the operating system, and whether it maps the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7960 |
segment to cover the entire \s-1TLS\s0 area. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7961 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7962 |
For systems that use \s-1GNU\s0 libc, the default is on. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7963 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7964 |
These \fB\-m\fR switches are supported in addition to the above |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7965 |
on \s-1AMD\s0 x86\-64 processors in 64\-bit environments. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7966 |
.Ip "\fB\-m32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7967 |
.IX Item "-m32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7968 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7969 |
.Ip "\fB\-m64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7970 |
.IX Item "-m64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7971 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7972 |
Generate code for a 32\-bit or 64\-bit environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7973 |
The 32\-bit environment sets int, long and pointer to 32 bits and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7974 |
generates code that runs on any i386 system. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7975 |
The 64\-bit environment sets int to 32 bits and long and pointer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7976 |
to 64 bits and generates code for \s-1AMD\s0's x86\-64 architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7977 |
.Ip "\fB\-mno-red-zone\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7978 |
.IX Item "-mno-red-zone" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7979 |
Do not use a so called red zone for x86\-64 code. The red zone is mandated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7980 |
by the x86\-64 \s-1ABI\s0, it is a 128\-byte area beyond the location of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7981 |
stack pointer that will not be modified by signal or interrupt handlers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7982 |
and therefore can be used for temporary data without adjusting the stack |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7983 |
pointer. The flag \fB\-mno-red-zone\fR disables this red zone. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7984 |
.Ip "\fB\-mcmodel=small\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7985 |
.IX Item "-mcmodel=small" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7986 |
Generate code for the small code model: the program and its symbols must |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7987 |
be linked in the lower 2 \s-1GB\s0 of the address space. Pointers are 64 bits. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7988 |
Programs can be statically or dynamically linked. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7989 |
code model. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7990 |
.Ip "\fB\-mcmodel=kernel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7991 |
.IX Item "-mcmodel=kernel" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7992 |
Generate code for the kernel code model. The kernel runs in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7993 |
negative 2 \s-1GB\s0 of the address space. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7994 |
This model has to be used for Linux kernel code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7995 |
.Ip "\fB\-mcmodel=medium\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7996 |
.IX Item "-mcmodel=medium" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7997 |
Generate code for the medium model: The program is linked in the lower 2 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7998 |
\&\s-1GB\s0 of the address space but symbols can be located anywhere in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
7999 |
address space. Programs can be statically or dynamically linked, but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8000 |
building of shared libraries are not supported with the medium model. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8001 |
.Ip "\fB\-mcmodel=large\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8002 |
.IX Item "-mcmodel=large" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8003 |
Generate code for the large model: This model makes no assumptions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8004 |
about addresses and sizes of sections. Currently \s-1GCC\s0 does not implement |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8005 |
this model. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8006 |
.Ip "\fB\-mstack-arg-probe\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8007 |
.IX Item "-mstack-arg-probe" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8008 |
Emit code in function prologue to probe the stack when allocating more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8009 |
than \s-1CHECK_STACK_LIMIT\s0 bytes in one go. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8010 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8011 |
Currently, this is the default on windows systems (cygwin and mingw32), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8012 |
which define \s-1CHECK_STACK_LIMIT\s0 as 4000. On these systems, touching the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8013 |
stack at 4K increments is necessary to ensure that the guard pages used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8014 |
by the \s-1OS\s0 virtual memory manger are allocated in correct sequence. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8015 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8016 |
.I "\s-1HPPA\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8017 |
.IX Subsection "HPPA Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8018 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8019 |
These \fB\-m\fR options are defined for the \s-1HPPA\s0 family of computers: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8020 |
.Ip "\fB\-march=\fR\fIarchitecture-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8021 |
.IX Item "-march=architecture-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8022 |
Generate code for the specified architecture. The choices for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8023 |
\&\fIarchitecture-type\fR are \fB1.0\fR for \s-1PA\s0 1.0, \fB1.1\fR for \s-1PA\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8024 |
1.1, and \fB2.0\fR for \s-1PA\s0 2.0 processors. Refer to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8025 |
\&\fI/usr/lib/sched.models\fR on an \s-1HP-UX\s0 system to determine the proper |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8026 |
architecture option for your machine. Code compiled for lower numbered |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8027 |
architectures will run on higher numbered architectures, but not the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8028 |
other way around. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8029 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8030 |
\&\s-1PA\s0 2.0 support currently requires gas snapshot 19990413 or later. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8031 |
next release of binutils (current is 2.9.1) will probably contain \s-1PA\s0 2.0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8032 |
support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8033 |
.Ip "\fB\-mpa-risc-1\-0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8034 |
.IX Item "-mpa-risc-1-0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8035 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8036 |
.Ip "\fB\-mpa-risc-1\-1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8037 |
.IX Item "-mpa-risc-1-1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8038 |
.Ip "\fB\-mpa-risc-2\-0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8039 |
.IX Item "-mpa-risc-2-0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8040 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8041 |
Synonyms for \fB\-march=1.0\fR, \fB\-march=1.1\fR, and \fB\-march=2.0\fR respectively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8042 |
.Ip "\fB\-mbig-switch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8043 |
.IX Item "-mbig-switch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8044 |
Generate code suitable for big switch tables. Use this option only if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8045 |
the assembler/linker complain about out of range branches within a switch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8046 |
table. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8047 |
.Ip "\fB\-mjump-in-delay\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8048 |
.IX Item "-mjump-in-delay" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8049 |
Fill delay slots of function calls with unconditional jump instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8050 |
by modifying the return pointer for the function call to be the target |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8051 |
of the conditional jump. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8052 |
.Ip "\fB\-mdisable-fpregs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8053 |
.IX Item "-mdisable-fpregs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8054 |
Prevent floating point registers from being used in any manner. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8055 |
necessary for compiling kernels which perform lazy context switching of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8056 |
floating point registers. If you use this option and attempt to perform |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8057 |
floating point operations, the compiler will abort. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8058 |
.Ip "\fB\-mdisable-indexing\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8059 |
.IX Item "-mdisable-indexing" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8060 |
Prevent the compiler from using indexing address modes. This avoids some |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8061 |
rather obscure problems when compiling \s-1MIG\s0 generated code under \s-1MACH\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8062 |
.Ip "\fB\-mno-space-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8063 |
.IX Item "-mno-space-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8064 |
Generate code that assumes the target has no space registers. This allows |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8065 |
\&\s-1GCC\s0 to generate faster indirect calls and use unscaled index address modes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8066 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8067 |
Such code is suitable for level 0 \s-1PA\s0 systems and kernels. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8068 |
.Ip "\fB\-mfast-indirect-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8069 |
.IX Item "-mfast-indirect-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8070 |
Generate code that assumes calls never cross space boundaries. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8071 |
allows \s-1GCC\s0 to emit code which performs faster indirect calls. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8072 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8073 |
This option will not work in the presence of shared libraries or nested |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8074 |
functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8075 |
.Ip "\fB\-mlong-load-store\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8076 |
.IX Item "-mlong-load-store" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8077 |
Generate 3\-instruction load and store sequences as sometimes required by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8078 |
the \s-1HP-UX\s0 10 linker. This is equivalent to the \fB+k\fR option to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8079 |
the \s-1HP\s0 compilers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8080 |
.Ip "\fB\-mportable-runtime\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8081 |
.IX Item "-mportable-runtime" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8082 |
Use the portable calling conventions proposed by \s-1HP\s0 for \s-1ELF\s0 systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8083 |
.Ip "\fB\-mgas\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8084 |
.IX Item "-mgas" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8085 |
Enable the use of assembler directives only \s-1GAS\s0 understands. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8086 |
.Ip "\fB\-mschedule=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8087 |
.IX Item "-mschedule=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8088 |
Schedule code according to the constraints for the machine type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8089 |
\&\fIcpu-type\fR. The choices for \fIcpu-type\fR are \fB700\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8090 |
\&\fB7100\fR, \fB7100LC\fR, \fB7200\fR, \fB7300\fR and \fB8000\fR. Refer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8091 |
to \fI/usr/lib/sched.models\fR on an \s-1HP-UX\s0 system to determine the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8092 |
proper scheduling option for your machine. The default scheduling is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8093 |
\&\fB8000\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8094 |
.Ip "\fB\-mlinker-opt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8095 |
.IX Item "-mlinker-opt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8096 |
Enable the optimization pass in the \s-1HP-UX\s0 linker. Note this makes symbolic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8097 |
debugging impossible. It also triggers a bug in the \s-1HP-UX\s0 8 and \s-1HP-UX\s0 9 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8098 |
linkers in which they give bogus error messages when linking some programs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8099 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8100 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8101 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8102 |
\&\fBWarning:\fR the requisite libraries are not available for all \s-1HPPA\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8103 |
targets. Normally the facilities of the machine's usual C compiler are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8104 |
used, but this cannot be done directly in cross-compilation. You must make |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8105 |
your own arrangements to provide suitable library functions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8106 |
cross-compilation. The embedded target \fBhppa1.1\-*\-pro\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8107 |
does provide software floating point support. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8108 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8109 |
\&\fB\-msoft-float\fR changes the calling convention in the output file; |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8110 |
therefore, it is only useful if you compile \fIall\fR of a program with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8111 |
this option. In particular, you need to compile \fIlibgcc.a\fR, the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8112 |
library that comes with \s-1GCC\s0, with \fB\-msoft-float\fR in order for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8113 |
this to work. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8114 |
.Ip "\fB\-msio\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8115 |
.IX Item "-msio" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8116 |
Generate the predefine, \f(CW\*(C`_SIO\*(C'\fR, for server \s-1IO\s0. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8117 |
\&\fB\-mwsio\fR. This generates the predefines, \f(CW\*(C`_\|_hp9000s700\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8118 |
\&\f(CW\*(C`_\|_hp9000s700_\|_\*(C'\fR and \f(CW\*(C`_WSIO\*(C'\fR, for workstation \s-1IO\s0. These |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8119 |
options are available under \s-1HP-UX\s0 and \s-1HI-UX\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8120 |
.Ip "\fB\-mgnu-ld\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8121 |
.IX Item "-mgnu-ld" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8122 |
Use \s-1GNU\s0 ld specific options. This passes \fB\-shared\fR to ld when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8123 |
building a shared library. It is the default when \s-1GCC\s0 is configured, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8124 |
explicitly or implicitly, with the \s-1GNU\s0 linker. This option does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8125 |
have any affect on which ld is called, it only changes what parameters |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8126 |
are passed to that ld. The ld that is called is determined by the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8127 |
\&\fB\*(--with-ld\fR configure option, \s-1GCC\s0's program search path, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8128 |
finally by the user's \fB\s-1PATH\s0\fR. The linker used by \s-1GCC\s0 can be printed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8129 |
using \fBwhich `gcc \-print-prog-name=ld`\fR. This option is only available |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8130 |
on the 64 bit \s-1HP-UX\s0 \s-1GCC\s0, i.e. configured with \fBhppa*64*\-*\-hpux*\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8131 |
.Ip "\fB\-mhp-ld\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8132 |
.IX Item "-mhp-ld" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8133 |
Use \s-1HP\s0 ld specific options. This passes \fB\-b\fR to ld when building |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8134 |
a shared library and passes \fB+Accept TypeMismatch\fR to ld on all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8135 |
links. It is the default when \s-1GCC\s0 is configured, explicitly or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8136 |
implicitly, with the \s-1HP\s0 linker. This option does not have any affect on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8137 |
which ld is called, it only changes what parameters are passed to that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8138 |
ld. The ld that is called is determined by the \fB\*(--with-ld\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8139 |
configure option, \s-1GCC\s0's program search path, and finally by the user's |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8140 |
\&\fB\s-1PATH\s0\fR. The linker used by \s-1GCC\s0 can be printed using \fBwhich |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8141 |
`gcc \-print-prog-name=ld`\fR. This option is only available on the 64 bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8142 |
\&\s-1HP-UX\s0 \s-1GCC\s0, i.e. configured with \fBhppa*64*\-*\-hpux*\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8143 |
.Ip "\fB\-mlong-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8144 |
.IX Item "-mlong-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8145 |
Generate code that uses long call sequences. This ensures that a call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8146 |
is always able to reach linker generated stubs. The default is to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8147 |
long calls only when the distance from the call site to the beginning |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8148 |
of the function or translation unit, as the case may be, exceeds a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8149 |
predefined limit set by the branch type being used. The limits for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8150 |
normal calls are 7,600,000 and 240,000 bytes, respectively for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8151 |
\&\s-1PA\s0 2.0 and \s-1PA\s0 1.X architectures. Sibcalls are always limited at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8152 |
240,000 bytes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8153 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8154 |
Distances are measured from the beginning of functions when using the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8155 |
\&\fB\-ffunction-sections\fR option, or when using the \fB\-mgas\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8156 |
and \fB\-mno-portable-runtime\fR options together under \s-1HP-UX\s0 with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8157 |
the \s-1SOM\s0 linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8158 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8159 |
It is normally not desirable to use this option as it will degrade |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8160 |
performance. However, it may be useful in large applications, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8161 |
particularly when partial linking is used to build the application. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8162 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8163 |
The types of long calls used depends on the capabilities of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8164 |
assembler and linker, and the type of code being generated. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8165 |
impact on systems that support long absolute calls, and long pic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8166 |
symbol-difference or pc-relative calls should be relatively small. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8167 |
However, an indirect call is used on 32\-bit \s-1ELF\s0 systems in pic code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8168 |
and it is quite long. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8169 |
.Ip "\fB\-nolibdld\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8170 |
.IX Item "-nolibdld" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8171 |
Suppress the generation of link options to search libdld.sl when the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8172 |
\&\fB\-static\fR option is specified on \s-1HP-UX\s0 10 and later. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8173 |
.Ip "\fB\-static\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8174 |
.IX Item "-static" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8175 |
The \s-1HP-UX\s0 implementation of setlocale in libc has a dependency on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8176 |
libdld.sl. There isn't an archive version of libdld.sl. Thus, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8177 |
when the \fB\-static\fR option is specified, special link options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8178 |
are needed to resolve this dependency. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8179 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8180 |
On \s-1HP-UX\s0 10 and later, the \s-1GCC\s0 driver adds the necessary options to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8181 |
link with libdld.sl when the \fB\-static\fR option is specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8182 |
This causes the resulting binary to be dynamic. On the 64\-bit port, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8183 |
the linkers generate dynamic binaries by default in any case. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8184 |
\&\fB\-nolibdld\fR option can be used to prevent the \s-1GCC\s0 driver from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8185 |
adding these link options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8186 |
.Ip "\fB\-threads\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8187 |
.IX Item "-threads" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8188 |
Add support for multithreading with the \fIdce thread\fR library |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8189 |
under \s-1HP-UX\s0. This option sets flags for both the preprocessor and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8190 |
linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8191 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8192 |
.I "Intel 960 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8193 |
.IX Subsection "Intel 960 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8194 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8195 |
These \fB\-m\fR options are defined for the Intel 960 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8196 |
.Ip "\fB\-m\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8197 |
.IX Item "-mcpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8198 |
Assume the defaults for the machine type \fIcpu-type\fR for some of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8199 |
the other options, including instruction scheduling, floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8200 |
support, and addressing modes. The choices for \fIcpu-type\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8201 |
\&\fBka\fR, \fBkb\fR, \fBmc\fR, \fBca\fR, \fBcf\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8202 |
\&\fBsa\fR, and \fBsb\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8203 |
The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8204 |
\&\fBkb\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8205 |
.Ip "\fB\-mnumerics\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8206 |
.IX Item "-mnumerics" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8207 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8208 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8209 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8210 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8211 |
The \fB\-mnumerics\fR option indicates that the processor does support |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8212 |
floating-point instructions. The \fB\-msoft-float\fR option indicates |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8213 |
that floating-point support should not be assumed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8214 |
.Ip "\fB\-mleaf-procedures\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8215 |
.IX Item "-mleaf-procedures" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8216 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8217 |
.Ip "\fB\-mno-leaf-procedures\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8218 |
.IX Item "-mno-leaf-procedures" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8219 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8220 |
Do (or do not) attempt to alter leaf procedures to be callable with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8221 |
\&\f(CW\*(C`bal\*(C'\fR instruction as well as \f(CW\*(C`call\*(C'\fR. This will result in more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8222 |
efficient code for explicit calls when the \f(CW\*(C`bal\*(C'\fR instruction can be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8223 |
substituted by the assembler or linker, but less efficient code in other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8224 |
cases, such as calls via function pointers, or using a linker that doesn't |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8225 |
support this optimization. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8226 |
.Ip "\fB\-mtail-call\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8227 |
.IX Item "-mtail-call" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8228 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8229 |
.Ip "\fB\-mno-tail-call\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8230 |
.IX Item "-mno-tail-call" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8231 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8232 |
Do (or do not) make additional attempts (beyond those of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8233 |
machine-independent portions of the compiler) to optimize tail-recursive |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8234 |
calls into branches. You may not want to do this because the detection of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8235 |
cases where this is not valid is not totally complete. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8236 |
\&\fB\-mno-tail-call\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8237 |
.Ip "\fB\-mcomplex-addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8238 |
.IX Item "-mcomplex-addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8239 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8240 |
.Ip "\fB\-mno-complex-addr\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8241 |
.IX Item "-mno-complex-addr" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8242 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8243 |
Assume (or do not assume) that the use of a complex addressing mode is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8244 |
win on this implementation of the i960. Complex addressing modes may not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8245 |
be worthwhile on the K-series, but they definitely are on the C-series. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8246 |
The default is currently \fB\-mcomplex-addr\fR for all processors except |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8247 |
the \s-1CB\s0 and \s-1CC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8248 |
.Ip "\fB\-mcode-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8249 |
.IX Item "-mcode-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8250 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8251 |
.Ip "\fB\-mno-code-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8252 |
.IX Item "-mno-code-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8253 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8254 |
Align code to 8\-byte boundaries for faster fetching (or don't bother). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8255 |
Currently turned on by default for C-series implementations only. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8256 |
.Ip "\fB\-mic-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8257 |
.IX Item "-mic-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8258 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8259 |
.Ip "\fB\-mic2.0\-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8260 |
.IX Item "-mic2.0-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8261 |
.Ip "\fB\-mic3.0\-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8262 |
.IX Item "-mic3.0-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8263 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8264 |
Enable compatibility with iC960 v2.0 or v3.0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8265 |
.Ip "\fB\-masm-compat\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8266 |
.IX Item "-masm-compat" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8267 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8268 |
.Ip "\fB\-mintel-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8269 |
.IX Item "-mintel-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8270 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8271 |
Enable compatibility with the iC960 assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8272 |
.Ip "\fB\-mstrict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8273 |
.IX Item "-mstrict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8274 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8275 |
.Ip "\fB\-mno-strict-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8276 |
.IX Item "-mno-strict-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8277 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8278 |
Do not permit (do permit) unaligned accesses. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8279 |
.Ip "\fB\-mold-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8280 |
.IX Item "-mold-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8281 |
Enable structure-alignment compatibility with Intel's gcc release version |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8282 |
1.3 (based on gcc 1.37). This option implies \fB\-mstrict-align\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8283 |
.Ip "\fB\-mlong-double-64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8284 |
.IX Item "-mlong-double-64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8285 |
Implement type \fBlong double\fR as 64\-bit floating point numbers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8286 |
Without the option \fBlong double\fR is implemented by 80\-bit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8287 |
floating point numbers. The only reason we have it because there is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8288 |
no 128\-bit \fBlong double\fR support in \fBfp-bit.c\fR yet. So it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8289 |
is only useful for people using soft-float targets. Otherwise, we |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8290 |
should recommend against use of it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8291 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8292 |
.I "\s-1DEC\s0 Alpha Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8293 |
.IX Subsection "DEC Alpha Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8294 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8295 |
These \fB\-m\fR options are defined for the \s-1DEC\s0 Alpha implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8296 |
.Ip "\fB\-mno-soft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8297 |
.IX Item "-mno-soft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8298 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8299 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8300 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8301 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8302 |
Use (do not use) the hardware floating-point instructions for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8303 |
floating-point operations. When \fB\-msoft-float\fR is specified, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8304 |
functions in \fIlibgcc.a\fR will be used to perform floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8305 |
operations. Unless they are replaced by routines that emulate the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8306 |
floating-point operations, or compiled in such a way as to call such |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8307 |
emulations routines, these routines will issue floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8308 |
operations. If you are compiling for an Alpha without floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8309 |
operations, you must ensure that the library is built so as not to call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8310 |
them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8311 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8312 |
Note that Alpha implementations without floating-point operations are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8313 |
required to have floating-point registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8314 |
.Ip "\fB\-mfp-reg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8315 |
.IX Item "-mfp-reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8316 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8317 |
.Ip "\fB\-mno-fp-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8318 |
.IX Item "-mno-fp-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8319 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8320 |
Generate code that uses (does not use) the floating-point register set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8321 |
\&\fB\-mno-fp-regs\fR implies \fB\-msoft-float\fR. If the floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8322 |
register set is not used, floating point operands are passed in integer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8323 |
registers as if they were integers and floating-point results are passed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8324 |
in \f(CW\*(C`$0\*(C'\fR instead of \f(CW\*(C`$f0\*(C'\fR. This is a non-standard calling sequence, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8325 |
so any function with a floating-point argument or return value called by code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8326 |
compiled with \fB\-mno-fp-regs\fR must also be compiled with that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8327 |
option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8328 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8329 |
A typical use of this option is building a kernel that does not use, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8330 |
and hence need not save and restore, any floating-point registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8331 |
.Ip "\fB\-mieee\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8332 |
.IX Item "-mieee" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8333 |
The Alpha architecture implements floating-point hardware optimized for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8334 |
maximum performance. It is mostly compliant with the \s-1IEEE\s0 floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8335 |
point standard. However, for full compliance, software assistance is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8336 |
required. This option generates code fully \s-1IEEE\s0 compliant code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8337 |
\&\fIexcept\fR that the \fIinexact-flag\fR is not maintained (see below). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8338 |
If this option is turned on, the preprocessor macro \f(CW\*(C`_IEEE_FP\*(C'\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8339 |
defined during compilation. The resulting code is less efficient but is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8340 |
able to correctly support denormalized numbers and exceptional \s-1IEEE\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8341 |
values such as not-a-number and plus/minus infinity. Other Alpha |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8342 |
compilers call this option \fB\-ieee_with_no_inexact\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8343 |
.Ip "\fB\-mieee-with-inexact\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8344 |
.IX Item "-mieee-with-inexact" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8345 |
This is like \fB\-mieee\fR except the generated code also maintains |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8346 |
the \s-1IEEE\s0 \fIinexact-flag\fR. Turning on this option causes the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8347 |
generated code to implement fully-compliant \s-1IEEE\s0 math. In addition to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8348 |
\&\f(CW\*(C`_IEEE_FP\*(C'\fR, \f(CW\*(C`_IEEE_FP_EXACT\*(C'\fR is defined as a preprocessor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8349 |
macro. On some Alpha implementations the resulting code may execute |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8350 |
significantly slower than the code generated by default. Since there is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8351 |
very little code that depends on the \fIinexact-flag\fR, you should |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8352 |
normally not specify this option. Other Alpha compilers call this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8353 |
option \fB\-ieee_with_inexact\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8354 |
.Ip "\fB\-mfp-trap-mode=\fR\fItrap-mode\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8355 |
.IX Item "-mfp-trap-mode=trap-mode" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8356 |
This option controls what floating-point related traps are enabled. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8357 |
Other Alpha compilers call this option \fB\-fptm\fR \fItrap-mode\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8358 |
The trap mode can be set to one of four values: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8359 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8360 |
.Ip "\fBn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8361 |
.IX Item "n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8362 |
This is the default (normal) setting. The only traps that are enabled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8363 |
are the ones that cannot be disabled in software (e.g., division by zero |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8364 |
trap). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8365 |
.Ip "\fBu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8366 |
.IX Item "u" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8367 |
In addition to the traps enabled by \fBn\fR, underflow traps are enabled |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8368 |
as well. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8369 |
.Ip "\fBsu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8370 |
.IX Item "su" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8371 |
Like \fBsu\fR, but the instructions are marked to be safe for software |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8372 |
completion (see Alpha architecture manual for details). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8373 |
.Ip "\fBsui\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8374 |
.IX Item "sui" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8375 |
Like \fBsu\fR, but inexact traps are enabled as well. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8376 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8377 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8378 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8379 |
.Ip "\fB\-mfp-rounding-mode=\fR\fIrounding-mode\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8380 |
.IX Item "-mfp-rounding-mode=rounding-mode" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8381 |
Selects the \s-1IEEE\s0 rounding mode. Other Alpha compilers call this option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8382 |
\&\fB\-fprm\fR \fIrounding-mode\fR. The \fIrounding-mode\fR can be one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8383 |
of: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8384 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8385 |
.Ip "\fBn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8386 |
.IX Item "n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8387 |
Normal \s-1IEEE\s0 rounding mode. Floating point numbers are rounded towards |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8388 |
the nearest machine number or towards the even machine number in case |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8389 |
of a tie. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8390 |
.Ip "\fBm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8391 |
.IX Item "m" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8392 |
Round towards minus infinity. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8393 |
.Ip "\fBc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8394 |
.IX Item "c" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8395 |
Chopped rounding mode. Floating point numbers are rounded towards zero. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8396 |
.Ip "\fBd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8397 |
.IX Item "d" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8398 |
Dynamic rounding mode. A field in the floating point control register |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8399 |
(\fIfpcr\fR, see Alpha architecture reference manual) controls the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8400 |
rounding mode in effect. The C library initializes this register for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8401 |
rounding towards plus infinity. Thus, unless your program modifies the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8402 |
\&\fIfpcr\fR, \fBd\fR corresponds to round towards plus infinity. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8403 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8404 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8405 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8406 |
.Ip "\fB\-mtrap-precision=\fR\fItrap-precision\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8407 |
.IX Item "-mtrap-precision=trap-precision" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8408 |
In the Alpha architecture, floating point traps are imprecise. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8409 |
means without software assistance it is impossible to recover from a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8410 |
floating trap and program execution normally needs to be terminated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8411 |
\&\s-1GCC\s0 can generate code that can assist operating system trap handlers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8412 |
in determining the exact location that caused a floating point trap. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8413 |
Depending on the requirements of an application, different levels of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8414 |
precisions can be selected: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8415 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8416 |
.Ip "\fBp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8417 |
.IX Item "p" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8418 |
Program precision. This option is the default and means a trap handler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8419 |
can only identify which program caused a floating point exception. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8420 |
.Ip "\fBf\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8421 |
.IX Item "f" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8422 |
Function precision. The trap handler can determine the function that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8423 |
caused a floating point exception. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8424 |
.Ip "\fBi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8425 |
.IX Item "i" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8426 |
Instruction precision. The trap handler can determine the exact |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8427 |
instruction that caused a floating point exception. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8428 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8429 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8430 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8431 |
Other Alpha compilers provide the equivalent options called |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8432 |
\&\fB\-scope_safe\fR and \fB\-resumption_safe\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8433 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8434 |
.Ip "\fB\-mieee-conformant\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8435 |
.IX Item "-mieee-conformant" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8436 |
This option marks the generated code as \s-1IEEE\s0 conformant. You must not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8437 |
use this option unless you also specify \fB\-mtrap-precision=i\fR and either |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8438 |
\&\fB\-mfp-trap-mode=su\fR or \fB\-mfp-trap-mode=sui\fR. Its only effect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8439 |
is to emit the line \fB.eflag 48\fR in the function prologue of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8440 |
generated assembly file. Under \s-1DEC\s0 Unix, this has the effect that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8441 |
IEEE-conformant math library routines will be linked in. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8442 |
.Ip "\fB\-mbuild-constants\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8443 |
.IX Item "-mbuild-constants" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8444 |
Normally \s-1GCC\s0 examines a 32\- or 64\-bit integer constant to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8445 |
see if it can construct it from smaller constants in two or three |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8446 |
instructions. If it cannot, it will output the constant as a literal and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8447 |
generate code to load it from the data segment at runtime. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8448 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8449 |
Use this option to require \s-1GCC\s0 to construct \fIall\fR integer constants |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8450 |
using code, even if it takes more instructions (the maximum is six). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8451 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8452 |
You would typically use this option to build a shared library dynamic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8453 |
loader. Itself a shared library, it must relocate itself in memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8454 |
before it can find the variables and constants in its own data segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8455 |
.Ip "\fB\-malpha-as\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8456 |
.IX Item "-malpha-as" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8457 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8458 |
.Ip "\fB\-mgas\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8459 |
.IX Item "-mgas" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8460 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8461 |
Select whether to generate code to be assembled by the vendor-supplied |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8462 |
assembler (\fB\-malpha-as\fR) or by the \s-1GNU\s0 assembler \fB\-mgas\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8463 |
.Ip "\fB\-mbwx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8464 |
.IX Item "-mbwx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8465 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8466 |
.Ip "\fB\-mno-bwx\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8467 |
.IX Item "-mno-bwx" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8468 |
.Ip "\fB\-mcix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8469 |
.IX Item "-mcix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8470 |
.Ip "\fB\-mno-cix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8471 |
.IX Item "-mno-cix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8472 |
.Ip "\fB\-mfix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8473 |
.IX Item "-mfix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8474 |
.Ip "\fB\-mno-fix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8475 |
.IX Item "-mno-fix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8476 |
.Ip "\fB\-mmax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8477 |
.IX Item "-mmax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8478 |
.Ip "\fB\-mno-max\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8479 |
.IX Item "-mno-max" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8480 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8481 |
Indicate whether \s-1GCC\s0 should generate code to use the optional \s-1BWX\s0, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8482 |
\&\s-1CIX\s0, \s-1FIX\s0 and \s-1MAX\s0 instruction sets. The default is to use the instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8483 |
sets supported by the \s-1CPU\s0 type specified via \fB\-mcpu=\fR option or that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8484 |
of the \s-1CPU\s0 on which \s-1GCC\s0 was built if none was specified. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8485 |
.Ip "\fB\-mfloat-vax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8486 |
.IX Item "-mfloat-vax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8487 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8488 |
.Ip "\fB\-mfloat-ieee\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8489 |
.IX Item "-mfloat-ieee" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8490 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8491 |
Generate code that uses (does not use) \s-1VAX\s0 F and G floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8492 |
arithmetic instead of \s-1IEEE\s0 single and double precision. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8493 |
.Ip "\fB\-mexplicit-relocs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8494 |
.IX Item "-mexplicit-relocs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8495 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8496 |
.Ip "\fB\-mno-explicit-relocs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8497 |
.IX Item "-mno-explicit-relocs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8498 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8499 |
Older Alpha assemblers provided no way to generate symbol relocations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8500 |
except via assembler macros. Use of these macros does not allow |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8501 |
optimal instruction scheduling. \s-1GNU\s0 binutils as of version 2.12 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8502 |
supports a new syntax that allows the compiler to explicitly mark |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8503 |
which relocations should apply to which instructions. This option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8504 |
is mostly useful for debugging, as \s-1GCC\s0 detects the capabilities of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8505 |
the assembler when it is built and sets the default accordingly. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8506 |
.Ip "\fB\-msmall-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8507 |
.IX Item "-msmall-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8508 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8509 |
.Ip "\fB\-mlarge-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8510 |
.IX Item "-mlarge-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8511 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8512 |
When \fB\-mexplicit-relocs\fR is in effect, static data is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8513 |
accessed via \fIgp-relative\fR relocations. When \fB\-msmall-data\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8514 |
is used, objects 8 bytes long or smaller are placed in a \fIsmall data area\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8515 |
(the \f(CW\*(C`.sdata\*(C'\fR and \f(CW\*(C`.sbss\*(C'\fR sections) and are accessed via |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8516 |
16\-bit relocations off of the \f(CW\*(C`$gp\*(C'\fR register. This limits the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8517 |
size of the small data area to 64KB, but allows the variables to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8518 |
directly accessed via a single instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8519 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8520 |
The default is \fB\-mlarge-data\fR. With this option the data area |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8521 |
is limited to just below 2GB. Programs that require more than 2GB of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8522 |
data must use \f(CW\*(C`malloc\*(C'\fR or \f(CW\*(C`mmap\*(C'\fR to allocate the data in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8523 |
heap instead of in the program's data segment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8524 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8525 |
When generating code for shared libraries, \fB\-fpic\fR implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8526 |
\&\fB\-msmall-data\fR and \fB\-fPIC\fR implies \fB\-mlarge-data\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8527 |
.Ip "\fB\-msmall-text\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8528 |
.IX Item "-msmall-text" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8529 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8530 |
.Ip "\fB\-mlarge-text\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8531 |
.IX Item "-mlarge-text" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8532 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8533 |
When \fB\-msmall-text\fR is used, the compiler assumes that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8534 |
code of the entire program (or shared library) fits in 4MB, and is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8535 |
thus reachable with a branch instruction. When \fB\-msmall-data\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8536 |
is used, the compiler can assume that all local symbols share the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8537 |
same \f(CW\*(C`$gp\*(C'\fR value, and thus reduce the number of instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8538 |
required for a function call from 4 to 1. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8539 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8540 |
The default is \fB\-mlarge-text\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8541 |
.Ip "\fB\-mcpu=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8542 |
.IX Item "-mcpu=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8543 |
Set the instruction set and instruction scheduling parameters for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8544 |
machine type \fIcpu_type\fR. You can specify either the \fB\s-1EV\s0\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8545 |
style name or the corresponding chip number. \s-1GCC\s0 supports scheduling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8546 |
parameters for the \s-1EV4\s0, \s-1EV5\s0 and \s-1EV6\s0 family of processors and will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8547 |
choose the default values for the instruction set from the processor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8548 |
you specify. If you do not specify a processor type, \s-1GCC\s0 will default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8549 |
to the processor on which the compiler was built. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8550 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8551 |
Supported values for \fIcpu_type\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8552 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8553 |
.Ip "\fBev4\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8554 |
.IX Item "ev4" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8555 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8556 |
.Ip "\fBev45\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8557 |
.IX Item "ev45" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8558 |
.Ip "\fB21064\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8559 |
.IX Item "21064" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8560 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8561 |
Schedules as an \s-1EV4\s0 and has no instruction set extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8562 |
.Ip "\fBev5\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8563 |
.IX Item "ev5" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8564 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8565 |
.Ip "\fB21164\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8566 |
.IX Item "21164" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8567 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8568 |
Schedules as an \s-1EV5\s0 and has no instruction set extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8569 |
.Ip "\fBev56\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8570 |
.IX Item "ev56" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8571 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8572 |
.Ip "\fB21164a\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8573 |
.IX Item "21164a" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8574 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8575 |
Schedules as an \s-1EV5\s0 and supports the \s-1BWX\s0 extension. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8576 |
.Ip "\fBpca56\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8577 |
.IX Item "pca56" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8578 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8579 |
.Ip "\fB21164pc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8580 |
.IX Item "21164pc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8581 |
.Ip "\fB21164PC\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8582 |
.IX Item "21164PC" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8583 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8584 |
Schedules as an \s-1EV5\s0 and supports the \s-1BWX\s0 and \s-1MAX\s0 extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8585 |
.Ip "\fBev6\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8586 |
.IX Item "ev6" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8587 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8588 |
.Ip "\fB21264\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8589 |
.IX Item "21264" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8590 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8591 |
Schedules as an \s-1EV6\s0 and supports the \s-1BWX\s0, \s-1FIX\s0, and \s-1MAX\s0 extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8592 |
.Ip "\fBev67\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8593 |
.IX Item "ev67" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8594 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8595 |
.Ip "\fB21264a\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8596 |
.IX Item "21264a" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8597 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8598 |
Schedules as an \s-1EV6\s0 and supports the \s-1BWX\s0, \s-1CIX\s0, \s-1FIX\s0, and \s-1MAX\s0 extensions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8599 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8600 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8601 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8602 |
.Ip "\fB\-mtune=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8603 |
.IX Item "-mtune=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8604 |
Set only the instruction scheduling parameters for machine type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8605 |
\&\fIcpu_type\fR. The instruction set is not changed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8606 |
.Ip "\fB\-mmemory-latency=\fR\fItime\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8607 |
.IX Item "-mmemory-latency=time" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8608 |
Sets the latency the scheduler should assume for typical memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8609 |
references as seen by the application. This number is highly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8610 |
dependent on the memory access patterns used by the application |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8611 |
and the size of the external cache on the machine. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8612 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8613 |
Valid options for \fItime\fR are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8614 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8615 |
.Ip "\fInumber\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8616 |
.IX Item "number" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8617 |
A decimal number representing clock cycles. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8618 |
.Ip "\fBL1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8619 |
.IX Item "L1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8620 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8621 |
.Ip "\fBL2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8622 |
.IX Item "L2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8623 |
.Ip "\fBL3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8624 |
.IX Item "L3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8625 |
.Ip "\fBmain\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8626 |
.IX Item "main" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8627 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8628 |
The compiler contains estimates of the number of clock cycles for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8629 |
``typical'' \s-1EV4\s0 & \s-1EV5\s0 hardware for the Level 1, 2 & 3 caches |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8630 |
(also called Dcache, Scache, and Bcache), as well as to main memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8631 |
Note that L3 is only valid for \s-1EV5\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8632 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8633 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8634 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8635 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8636 |
.I "\s-1DEC\s0 Alpha/VMS Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8637 |
.IX Subsection "DEC Alpha/VMS Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8638 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8639 |
These \fB\-m\fR options are defined for the \s-1DEC\s0 Alpha/VMS implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8640 |
.Ip "\fB\-mvms-return-codes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8641 |
.IX Item "-mvms-return-codes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8642 |
Return \s-1VMS\s0 condition codes from main. The default is to return \s-1POSIX\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8643 |
style condition (e.g. error) codes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8644 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8645 |
.I "H8/300 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8646 |
.IX Subsection "H8/300 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8647 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8648 |
These \fB\-m\fR options are defined for the H8/300 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8649 |
.Ip "\fB\-mrelax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8650 |
.IX Item "-mrelax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8651 |
Shorten some address references at link time, when possible; uses the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8652 |
linker option \fB\-relax\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8653 |
.Ip "\fB\-mh\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8654 |
.IX Item "-mh" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8655 |
Generate code for the H8/300H. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8656 |
.Ip "\fB\-ms\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8657 |
.IX Item "-ms" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8658 |
Generate code for the H8S. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8659 |
.Ip "\fB\-mn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8660 |
.IX Item "-mn" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8661 |
Generate code for the H8S and H8/300H in the normal mode. This switch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8662 |
must be used either with \-mh or \-ms. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8663 |
.Ip "\fB\-ms2600\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8664 |
.IX Item "-ms2600" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8665 |
Generate code for the H8S/2600. This switch must be used with \fB\-ms\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8666 |
.Ip "\fB\-mint32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8667 |
.IX Item "-mint32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8668 |
Make \f(CW\*(C`int\*(C'\fR data 32 bits by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8669 |
.Ip "\fB\-malign-300\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8670 |
.IX Item "-malign-300" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8671 |
On the H8/300H and H8S, use the same alignment rules as for the H8/300. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8672 |
The default for the H8/300H and H8S is to align longs and floats on 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8673 |
byte boundaries. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8674 |
\&\fB\-malign-300\fR causes them to be aligned on 2 byte boundaries. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8675 |
This option has no effect on the H8/300. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8676 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8677 |
.I "\s-1SH\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8678 |
.IX Subsection "SH Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8679 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8680 |
These \fB\-m\fR options are defined for the \s-1SH\s0 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8681 |
.Ip "\fB\-m1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8682 |
.IX Item "-m1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8683 |
Generate code for the \s-1SH1\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8684 |
.Ip "\fB\-m2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8685 |
.IX Item "-m2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8686 |
Generate code for the \s-1SH2\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8687 |
.Ip "\fB\-m2e\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8688 |
.IX Item "-m2e" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8689 |
Generate code for the SH2e. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8690 |
.Ip "\fB\-m3\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8691 |
.IX Item "-m3" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8692 |
Generate code for the \s-1SH3\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8693 |
.Ip "\fB\-m3e\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8694 |
.IX Item "-m3e" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8695 |
Generate code for the SH3e. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8696 |
.Ip "\fB\-m4\-nofpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8697 |
.IX Item "-m4-nofpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8698 |
Generate code for the \s-1SH4\s0 without a floating-point unit. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8699 |
.Ip "\fB\-m4\-single-only\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8700 |
.IX Item "-m4-single-only" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8701 |
Generate code for the \s-1SH4\s0 with a floating-point unit that only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8702 |
supports single-precision arithmetic. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8703 |
.Ip "\fB\-m4\-single\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8704 |
.IX Item "-m4-single" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8705 |
Generate code for the \s-1SH4\s0 assuming the floating-point unit is in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8706 |
single-precision mode by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8707 |
.Ip "\fB\-m4\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8708 |
.IX Item "-m4" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8709 |
Generate code for the \s-1SH4\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8710 |
.Ip "\fB\-mb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8711 |
.IX Item "-mb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8712 |
Compile code for the processor in big endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8713 |
.Ip "\fB\-ml\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8714 |
.IX Item "-ml" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8715 |
Compile code for the processor in little endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8716 |
.Ip "\fB\-mdalign\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8717 |
.IX Item "-mdalign" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8718 |
Align doubles at 64\-bit boundaries. Note that this changes the calling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8719 |
conventions, and thus some functions from the standard C library will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8720 |
not work unless you recompile it first with \fB\-mdalign\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8721 |
.Ip "\fB\-mrelax\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8722 |
.IX Item "-mrelax" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8723 |
Shorten some address references at link time, when possible; uses the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8724 |
linker option \fB\-relax\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8725 |
.Ip "\fB\-mbigtable\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8726 |
.IX Item "-mbigtable" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8727 |
Use 32\-bit offsets in \f(CW\*(C`switch\*(C'\fR tables. The default is to use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8728 |
16\-bit offsets. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8729 |
.Ip "\fB\-mfmovd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8730 |
.IX Item "-mfmovd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8731 |
Enable the use of the instruction \f(CW\*(C`fmovd\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8732 |
.Ip "\fB\-mhitachi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8733 |
.IX Item "-mhitachi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8734 |
Comply with the calling conventions defined by Renesas. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8735 |
.Ip "\fB\-mnomacsave\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8736 |
.IX Item "-mnomacsave" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8737 |
Mark the \f(CW\*(C`MAC\*(C'\fR register as call-clobbered, even if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8738 |
\&\fB\-mhitachi\fR is given. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8739 |
.Ip "\fB\-mieee\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8740 |
.IX Item "-mieee" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8741 |
Increase IEEE-compliance of floating-point code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8742 |
.Ip "\fB\-misize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8743 |
.IX Item "-misize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8744 |
Dump instruction size and location in the assembly code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8745 |
.Ip "\fB\-mpadstruct\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8746 |
.IX Item "-mpadstruct" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8747 |
This option is deprecated. It pads structures to multiple of 4 bytes, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8748 |
which is incompatible with the \s-1SH\s0 \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8749 |
.Ip "\fB\-mspace\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8750 |
.IX Item "-mspace" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8751 |
Optimize for space instead of speed. Implied by \fB\-Os\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8752 |
.Ip "\fB\-mprefergot\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8753 |
.IX Item "-mprefergot" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8754 |
When generating position-independent code, emit function calls using |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8755 |
the Global Offset Table instead of the Procedure Linkage Table. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8756 |
.Ip "\fB\-musermode\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8757 |
.IX Item "-musermode" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8758 |
Generate a library function call to invalidate instruction cache |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8759 |
entries, after fixing up a trampoline. This library function call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8760 |
doesn't assume it can write to the whole memory address space. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8761 |
is the default when the target is \f(CW\*(C`sh\-*\-linux*\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8762 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8763 |
.I "Options for System V" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8764 |
.IX Subsection "Options for System V" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8765 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8766 |
These additional options are available on System V Release 4 for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8767 |
compatibility with other compilers on those systems: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8768 |
.Ip "\fB\-G\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8769 |
.IX Item "-G" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8770 |
Create a shared object. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8771 |
It is recommended that \fB\-symbolic\fR or \fB\-shared\fR be used instead. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8772 |
.Ip "\fB\-Qy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8773 |
.IX Item "-Qy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8774 |
Identify the versions of each tool used by the compiler, in a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8775 |
\&\f(CW\*(C`.ident\*(C'\fR assembler directive in the output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8776 |
.Ip "\fB\-Qn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8777 |
.IX Item "-Qn" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8778 |
Refrain from adding \f(CW\*(C`.ident\*(C'\fR directives to the output file (this is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8779 |
the default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8780 |
.Ip "\fB\-YP,\fR\fIdirs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8781 |
.IX Item "-YP,dirs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8782 |
Search the directories \fIdirs\fR, and no others, for libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8783 |
specified with \fB\-l\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8784 |
.Ip "\fB\-Ym,\fR\fIdir\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8785 |
.IX Item "-Ym,dir" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8786 |
Look in the directory \fIdir\fR to find the M4 preprocessor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8787 |
The assembler uses this option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8788 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8789 |
.I "TMS320C3x/C4x Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8790 |
.IX Subsection "TMS320C3x/C4x Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8791 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8792 |
These \fB\-m\fR options are defined for TMS320C3x/C4x implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8793 |
.Ip "\fB\-mcpu=\fR\fIcpu_type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8794 |
.IX Item "-mcpu=cpu_type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8795 |
Set the instruction set, register set, and instruction scheduling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8796 |
parameters for machine type \fIcpu_type\fR. Supported values for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8797 |
\&\fIcpu_type\fR are \fBc30\fR, \fBc31\fR, \fBc32\fR, \fBc40\fR, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8798 |
\&\fBc44\fR. The default is \fBc40\fR to generate code for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8799 |
\&\s-1TMS320C40\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8800 |
.Ip "\fB\-mbig-memory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8801 |
.IX Item "-mbig-memory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8802 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8803 |
.Ip "\fB\-mbig\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8804 |
.IX Item "-mbig" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8805 |
.Ip "\fB\-msmall-memory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8806 |
.IX Item "-msmall-memory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8807 |
.Ip "\fB\-msmall\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8808 |
.IX Item "-msmall" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8809 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8810 |
Generates code for the big or small memory model. The small memory |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8811 |
model assumed that all data fits into one 64K word page. At run-time |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8812 |
the data page (\s-1DP\s0) register must be set to point to the 64K page |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8813 |
containing the .bss and .data program sections. The big memory model is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8814 |
the default and requires reloading of the \s-1DP\s0 register for every direct |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8815 |
memory access. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8816 |
.Ip "\fB\-mbk\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8817 |
.IX Item "-mbk" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8818 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8819 |
.Ip "\fB\-mno-bk\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8820 |
.IX Item "-mno-bk" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8821 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8822 |
Allow (disallow) allocation of general integer operands into the block |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8823 |
count register \s-1BK\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8824 |
.Ip "\fB\-mdb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8825 |
.IX Item "-mdb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8826 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8827 |
.Ip "\fB\-mno-db\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8828 |
.IX Item "-mno-db" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8829 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8830 |
Enable (disable) generation of code using decrement and branch, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8831 |
\&\fIDBcond\fR\|(D), instructions. This is enabled by default for the C4x. To be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8832 |
on the safe side, this is disabled for the C3x, since the maximum |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8833 |
iteration count on the C3x is 2^{23 + 1} (but who iterates loops more than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8834 |
2^{23} times on the C3x?). Note that \s-1GCC\s0 will try to reverse a loop so |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8835 |
that it can utilize the decrement and branch instruction, but will give |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8836 |
up if there is more than one memory reference in the loop. Thus a loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8837 |
where the loop counter is decremented can generate slightly more |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8838 |
efficient code, in cases where the \s-1RPTB\s0 instruction cannot be utilized. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8839 |
.Ip "\fB\-mdp-isr-reload\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8840 |
.IX Item "-mdp-isr-reload" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8841 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8842 |
.Ip "\fB\-mparanoid\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8843 |
.IX Item "-mparanoid" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8844 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8845 |
Force the \s-1DP\s0 register to be saved on entry to an interrupt service |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8846 |
routine (\s-1ISR\s0), reloaded to point to the data section, and restored on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8847 |
exit from the \s-1ISR\s0. This should not be required unless someone has |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8848 |
violated the small memory model by modifying the \s-1DP\s0 register, say within |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8849 |
an object library. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8850 |
.Ip "\fB\-mmpyi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8851 |
.IX Item "-mmpyi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8852 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8853 |
.Ip "\fB\-mno-mpyi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8854 |
.IX Item "-mno-mpyi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8855 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8856 |
For the C3x use the 24\-bit \s-1MPYI\s0 instruction for integer multiplies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8857 |
instead of a library call to guarantee 32\-bit results. Note that if one |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8858 |
of the operands is a constant, then the multiplication will be performed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8859 |
using shifts and adds. If the \fB\-mmpyi\fR option is not specified for the C3x, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8860 |
then squaring operations are performed inline instead of a library call. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8861 |
.Ip "\fB\-mfast-fix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8862 |
.IX Item "-mfast-fix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8863 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8864 |
.Ip "\fB\-mno-fast-fix\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8865 |
.IX Item "-mno-fast-fix" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8866 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8867 |
The C3x/C4x \s-1FIX\s0 instruction to convert a floating point value to an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8868 |
integer value chooses the nearest integer less than or equal to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8869 |
floating point value rather than to the nearest integer. Thus if the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8870 |
floating point number is negative, the result will be incorrectly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8871 |
truncated an additional code is necessary to detect and correct this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8872 |
case. This option can be used to disable generation of the additional |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8873 |
code required to correct the result. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8874 |
.Ip "\fB\-mrptb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8875 |
.IX Item "-mrptb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8876 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8877 |
.Ip "\fB\-mno-rptb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8878 |
.IX Item "-mno-rptb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8879 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8880 |
Enable (disable) generation of repeat block sequences using the \s-1RPTB\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8881 |
instruction for zero overhead looping. The \s-1RPTB\s0 construct is only used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8882 |
for innermost loops that do not call functions or jump across the loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8883 |
boundaries. There is no advantage having nested \s-1RPTB\s0 loops due to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8884 |
overhead required to save and restore the \s-1RC\s0, \s-1RS\s0, and \s-1RE\s0 registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8885 |
This is enabled by default with \fB\-O2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8886 |
.Ip "\fB\-mrpts=\fR\fIcount\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8887 |
.IX Item "-mrpts=count" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8888 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8889 |
.Ip "\fB\-mno-rpts\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8890 |
.IX Item "-mno-rpts" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8891 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8892 |
Enable (disable) the use of the single instruction repeat instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8893 |
\&\s-1RPTS\s0. If a repeat block contains a single instruction, and the loop |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8894 |
count can be guaranteed to be less than the value \fIcount\fR, \s-1GCC\s0 will |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8895 |
emit a \s-1RPTS\s0 instruction instead of a \s-1RPTB\s0. If no value is specified, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8896 |
then a \s-1RPTS\s0 will be emitted even if the loop count cannot be determined |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8897 |
at compile time. Note that the repeated instruction following \s-1RPTS\s0 does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8898 |
not have to be reloaded from memory each iteration, thus freeing up the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8899 |
\&\s-1CPU\s0 buses for operands. However, since interrupts are blocked by this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8900 |
instruction, it is disabled by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8901 |
.Ip "\fB\-mloop-unsigned\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8902 |
.IX Item "-mloop-unsigned" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8903 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8904 |
.Ip "\fB\-mno-loop-unsigned\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8905 |
.IX Item "-mno-loop-unsigned" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8906 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8907 |
The maximum iteration count when using \s-1RPTS\s0 and \s-1RPTB\s0 (and \s-1DB\s0 on the C40) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8908 |
is 2^{31 + 1} since these instructions test if the iteration count is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8909 |
negative to terminate the loop. If the iteration count is unsigned |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8910 |
there is a possibility than the 2^{31 + 1} maximum iteration count may be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8911 |
exceeded. This switch allows an unsigned iteration count. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8912 |
.Ip "\fB\-mti\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8913 |
.IX Item "-mti" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8914 |
Try to emit an assembler syntax that the \s-1TI\s0 assembler (asm30) is happy |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8915 |
with. This also enforces compatibility with the \s-1API\s0 employed by the \s-1TI\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8916 |
C3x C compiler. For example, long doubles are passed as structures |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8917 |
rather than in floating point registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8918 |
.Ip "\fB\-mregparm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8919 |
.IX Item "-mregparm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8920 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8921 |
.Ip "\fB\-mmemparm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8922 |
.IX Item "-mmemparm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8923 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8924 |
Generate code that uses registers (stack) for passing arguments to functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8925 |
By default, arguments are passed in registers where possible rather |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8926 |
than by pushing arguments on to the stack. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8927 |
.Ip "\fB\-mparallel-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8928 |
.IX Item "-mparallel-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8929 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8930 |
.Ip "\fB\-mno-parallel-insns\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8931 |
.IX Item "-mno-parallel-insns" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8932 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8933 |
Allow the generation of parallel instructions. This is enabled by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8934 |
default with \fB\-O2\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8935 |
.Ip "\fB\-mparallel-mpy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8936 |
.IX Item "-mparallel-mpy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8937 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8938 |
.Ip "\fB\-mno-parallel-mpy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8939 |
.IX Item "-mno-parallel-mpy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8940 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8941 |
Allow the generation of MPY||ADD and MPY||SUB parallel instructions, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8942 |
provided \fB\-mparallel-insns\fR is also specified. These instructions have |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8943 |
tight register constraints which can pessimize the code generation |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8944 |
of large functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8945 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8946 |
.I "V850 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8947 |
.IX Subsection "V850 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8948 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8949 |
These \fB\-m\fR options are defined for V850 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8950 |
.Ip "\fB\-mlong-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8951 |
.IX Item "-mlong-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8952 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8953 |
.Ip "\fB\-mno-long-calls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8954 |
.IX Item "-mno-long-calls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8955 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8956 |
Treat all calls as being far away (near). If calls are assumed to be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8957 |
far away, the compiler will always load the functions address up into a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8958 |
register, and call indirect through the pointer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8959 |
.Ip "\fB\-mno-ep\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8960 |
.IX Item "-mno-ep" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8961 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8962 |
.Ip "\fB\-mep\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8963 |
.IX Item "-mep" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8964 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8965 |
Do not optimize (do optimize) basic blocks that use the same index |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8966 |
pointer 4 or more times to copy pointer into the \f(CW\*(C`ep\*(C'\fR register, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8967 |
use the shorter \f(CW\*(C`sld\*(C'\fR and \f(CW\*(C`sst\*(C'\fR instructions. The \fB\-mep\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8968 |
option is on by default if you optimize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8969 |
.Ip "\fB\-mno-prolog-function\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8970 |
.IX Item "-mno-prolog-function" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8971 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8972 |
.Ip "\fB\-mprolog-function\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8973 |
.IX Item "-mprolog-function" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8974 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8975 |
Do not use (do use) external functions to save and restore registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8976 |
at the prologue and epilogue of a function. The external functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8977 |
are slower, but use less code space if more than one function saves |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8978 |
the same number of registers. The \fB\-mprolog-function\fR option |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8979 |
is on by default if you optimize. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8980 |
.Ip "\fB\-mspace\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8981 |
.IX Item "-mspace" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8982 |
Try to make the code as small as possible. At present, this just turns |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8983 |
on the \fB\-mep\fR and \fB\-mprolog-function\fR options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8984 |
.Ip "\fB\-mtda=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8985 |
.IX Item "-mtda=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8986 |
Put static or global variables whose size is \fIn\fR bytes or less into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8987 |
the tiny data area that register \f(CW\*(C`ep\*(C'\fR points to. The tiny data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8988 |
area can hold up to 256 bytes in total (128 bytes for byte references). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8989 |
.Ip "\fB\-msda=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8990 |
.IX Item "-msda=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8991 |
Put static or global variables whose size is \fIn\fR bytes or less into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8992 |
the small data area that register \f(CW\*(C`gp\*(C'\fR points to. The small data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8993 |
area can hold up to 64 kilobytes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8994 |
.Ip "\fB\-mzda=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8995 |
.IX Item "-mzda=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8996 |
Put static or global variables whose size is \fIn\fR bytes or less into |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8997 |
the first 32 kilobytes of memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8998 |
.Ip "\fB\-mv850\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
8999 |
.IX Item "-mv850" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9000 |
Specify that the target processor is the V850. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9001 |
.Ip "\fB\-mbig-switch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9002 |
.IX Item "-mbig-switch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9003 |
Generate code suitable for big switch tables. Use this option only if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9004 |
the assembler/linker complain about out of range branches within a switch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9005 |
table. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9006 |
.Ip "\fB\-mapp-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9007 |
.IX Item "-mapp-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9008 |
This option will cause r2 and r5 to be used in the code generated by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9009 |
the compiler. This setting is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9010 |
.Ip "\fB\-mno-app-regs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9011 |
.IX Item "-mno-app-regs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9012 |
This option will cause r2 and r5 to be treated as fixed registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9013 |
.Ip "\fB\-mv850e1\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9014 |
.IX Item "-mv850e1" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9015 |
Specify that the target processor is the V850E1. The preprocessor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9016 |
constants \fB_\|_v850e1_\|_\fR and \fB_\|_v850e_\|_\fR will be defined if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9017 |
this option is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9018 |
.Ip "\fB\-mv850e\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9019 |
.IX Item "-mv850e" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9020 |
Specify that the target processor is the V850E. The preprocessor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9021 |
constant \fB_\|_v850e_\|_\fR will be defined if this option is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9022 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9023 |
If neither \fB\-mv850\fR nor \fB\-mv850e\fR nor \fB\-mv850e1\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9024 |
are defined then a default target processor will be chosen and the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9025 |
relevant \fB_\|_v850*_\|_\fR preprocessor constant will be defined. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9026 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9027 |
The preprocessor constants \fB_\|_v850\fR and \fB_\|_v851_\|_\fR are always |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9028 |
defined, regardless of which processor variant is the target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9029 |
.Ip "\fB\-mdisable-callt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9030 |
.IX Item "-mdisable-callt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9031 |
This option will suppress generation of the \s-1CALLT\s0 instruction for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9032 |
v850e and v850e1 flavors of the v850 architecture. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9033 |
\&\fB\-mno-disable-callt\fR which allows the \s-1CALLT\s0 instruction to be used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9034 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9035 |
.I "\s-1ARC\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9036 |
.IX Subsection "ARC Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9037 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9038 |
These options are defined for \s-1ARC\s0 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9039 |
.Ip "\fB\-EL\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9040 |
.IX Item "-EL" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9041 |
Compile code for little endian mode. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9042 |
.Ip "\fB\-EB\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9043 |
.IX Item "-EB" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9044 |
Compile code for big endian mode. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9045 |
.Ip "\fB\-mmangle-cpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9046 |
.IX Item "-mmangle-cpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9047 |
Prepend the name of the cpu to all public symbol names. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9048 |
In multiple-processor systems, there are many \s-1ARC\s0 variants with different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9049 |
instruction and register set characteristics. This flag prevents code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9050 |
compiled for one cpu to be linked with code compiled for another. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9051 |
No facility exists for handling variants that are ``almost identical''. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9052 |
This is an all or nothing option. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9053 |
.Ip "\fB\-mcpu=\fR\fIcpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9054 |
.IX Item "-mcpu=cpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9055 |
Compile code for \s-1ARC\s0 variant \fIcpu\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9056 |
Which variants are supported depend on the configuration. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9057 |
All variants support \fB\-mcpu=base\fR, this is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9058 |
.Ip "\fB\-mtext=\fR\fItext-section\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9059 |
.IX Item "-mtext=text-section" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9060 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9061 |
.Ip "\fB\-mdata=\fR\fIdata-section\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9062 |
.IX Item "-mdata=data-section" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9063 |
.Ip "\fB\-mrodata=\fR\fIreadonly-data-section\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9064 |
.IX Item "-mrodata=readonly-data-section" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9065 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9066 |
Put functions, data, and readonly data in \fItext-section\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9067 |
\&\fIdata-section\fR, and \fIreadonly-data-section\fR respectively |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9068 |
by default. This can be overridden with the \f(CW\*(C`section\*(C'\fR attribute. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9069 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9070 |
.I "\s-1NS32K\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9071 |
.IX Subsection "NS32K Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9072 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9073 |
These are the \fB\-m\fR options defined for the 32000 series. The default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9074 |
values for these options depends on which style of 32000 was selected when |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9075 |
the compiler was configured; the defaults for the most common choices are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9076 |
given below. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9077 |
.Ip "\fB\-m32032\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9078 |
.IX Item "-m32032" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9079 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9080 |
.Ip "\fB\-m32032\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9081 |
.IX Item "-m32032" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9082 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9083 |
Generate output for a 32032. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9084 |
when the compiler is configured for 32032 and 32016 based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9085 |
.Ip "\fB\-m32332\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9086 |
.IX Item "-m32332" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9087 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9088 |
.Ip "\fB\-m32332\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9089 |
.IX Item "-m32332" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9090 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9091 |
Generate output for a 32332. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9092 |
when the compiler is configured for 32332\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9093 |
.Ip "\fB\-m32532\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9094 |
.IX Item "-m32532" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9095 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9096 |
.Ip "\fB\-m32532\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9097 |
.IX Item "-m32532" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9098 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9099 |
Generate output for a 32532. This is the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9100 |
when the compiler is configured for 32532\-based systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9101 |
.Ip "\fB\-m32081\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9102 |
.IX Item "-m32081" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9103 |
Generate output containing 32081 instructions for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9104 |
This is the default for all systems. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9105 |
.Ip "\fB\-m32381\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9106 |
.IX Item "-m32381" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9107 |
Generate output containing 32381 instructions for floating point. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9108 |
also implies \fB\-m32081\fR. The 32381 is only compatible with the 32332 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9109 |
and 32532 cpus. This is the default for the pc532\-netbsd configuration. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9110 |
.Ip "\fB\-mmulti-add\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9111 |
.IX Item "-mmulti-add" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9112 |
Try and generate multiply-add floating point instructions \f(CW\*(C`polyF\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9113 |
and \f(CW\*(C`dotF\*(C'\fR. This option is only available if the \fB\-m32381\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9114 |
option is in effect. Using these instructions requires changes to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9115 |
register allocation which generally has a negative impact on |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9116 |
performance. This option should only be enabled when compiling code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9117 |
particularly likely to make heavy use of multiply-add instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9118 |
.Ip "\fB\-mnomulti-add\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9119 |
.IX Item "-mnomulti-add" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9120 |
Do not try and generate multiply-add floating point instructions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9121 |
\&\f(CW\*(C`polyF\*(C'\fR and \f(CW\*(C`dotF\*(C'\fR. This is the default on all platforms. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9122 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9123 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9124 |
Generate output containing library calls for floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9125 |
\&\fBWarning:\fR the requisite libraries may not be available. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9126 |
.Ip "\fB\-mieee-compare\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9127 |
.IX Item "-mieee-compare" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9128 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9129 |
.Ip "\fB\-mno-ieee-compare\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9130 |
.IX Item "-mno-ieee-compare" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9131 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9132 |
Control whether or not the compiler uses \s-1IEEE\s0 floating point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9133 |
comparisons. These handle correctly the case where the result of a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9134 |
comparison is unordered. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9135 |
\&\fBWarning:\fR the requisite kernel support may not be available. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9136 |
.Ip "\fB\-mnobitfield\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9137 |
.IX Item "-mnobitfield" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9138 |
Do not use the bit-field instructions. On some machines it is faster to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9139 |
use shifting and masking operations. This is the default for the pc532. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9140 |
.Ip "\fB\-mbitfield\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9141 |
.IX Item "-mbitfield" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9142 |
Do use the bit-field instructions. This is the default for all platforms |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9143 |
except the pc532. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9144 |
.Ip "\fB\-mrtd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9145 |
.IX Item "-mrtd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9146 |
Use a different function-calling convention, in which functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9147 |
that take a fixed number of arguments return pop their |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9148 |
arguments on return with the \f(CW\*(C`ret\*(C'\fR instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9149 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9150 |
This calling convention is incompatible with the one normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9151 |
used on Unix, so you cannot use it if you need to call libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9152 |
compiled with the Unix compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9153 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9154 |
Also, you must provide function prototypes for all functions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9155 |
take variable numbers of arguments (including \f(CW\*(C`printf\*(C'\fR); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9156 |
otherwise incorrect code will be generated for calls to those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9157 |
functions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9158 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9159 |
In addition, seriously incorrect code will result if you call a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9160 |
function with too many arguments. (Normally, extra arguments are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9161 |
harmlessly ignored.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9162 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9163 |
This option takes its name from the 680x0 \f(CW\*(C`rtd\*(C'\fR instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9164 |
.Ip "\fB\-mregparam\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9165 |
.IX Item "-mregparam" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9166 |
Use a different function-calling convention where the first two arguments |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9167 |
are passed in registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9168 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9169 |
This calling convention is incompatible with the one normally |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9170 |
used on Unix, so you cannot use it if you need to call libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9171 |
compiled with the Unix compiler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9172 |
.Ip "\fB\-mnoregparam\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9173 |
.IX Item "-mnoregparam" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9174 |
Do not pass any arguments in registers. This is the default for all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9175 |
targets. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9176 |
.Ip "\fB\-msb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9177 |
.IX Item "-msb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9178 |
It is \s-1OK\s0 to use the sb as an index register which is always loaded with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9179 |
zero. This is the default for the pc532\-netbsd target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9180 |
.Ip "\fB\-mnosb\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9181 |
.IX Item "-mnosb" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9182 |
The sb register is not available for use or has not been initialized to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9183 |
zero by the run time system. This is the default for all targets except |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9184 |
the pc532\-netbsd. It is also implied whenever \fB\-mhimem\fR or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9185 |
\&\fB\-fpic\fR is set. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9186 |
.Ip "\fB\-mhimem\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9187 |
.IX Item "-mhimem" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9188 |
Many ns32000 series addressing modes use displacements of up to 512MB. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9189 |
If an address is above 512MB then displacements from zero can not be used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9190 |
This option causes code to be generated which can be loaded above 512MB. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9191 |
This may be useful for operating systems or \s-1ROM\s0 code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9192 |
.Ip "\fB\-mnohimem\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9193 |
.IX Item "-mnohimem" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9194 |
Assume code will be loaded in the first 512MB of virtual address space. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9195 |
This is the default for all platforms. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9196 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9197 |
.I "\s-1AVR\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9198 |
.IX Subsection "AVR Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9199 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9200 |
These options are defined for \s-1AVR\s0 implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9201 |
.Ip "\fB\-mmcu=\fR\fImcu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9202 |
.IX Item "-mmcu=mcu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9203 |
Specify \s-1ATMEL\s0 \s-1AVR\s0 instruction set or \s-1MCU\s0 type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9204 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9205 |
Instruction set avr1 is for the minimal \s-1AVR\s0 core, not supported by the C |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9206 |
compiler, only for assembler programs (\s-1MCU\s0 types: at90s1200, attiny10, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9207 |
attiny11, attiny12, attiny15, attiny28). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9208 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9209 |
Instruction set avr2 (default) is for the classic \s-1AVR\s0 core with up to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9210 |
8K program memory space (\s-1MCU\s0 types: at90s2313, at90s2323, attiny22, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9211 |
at90s2333, at90s2343, at90s4414, at90s4433, at90s4434, at90s8515, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9212 |
at90c8534, at90s8535). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9213 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9214 |
Instruction set avr3 is for the classic \s-1AVR\s0 core with up to 128K program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9215 |
memory space (\s-1MCU\s0 types: atmega103, atmega603, at43usb320, at76c711). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9216 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9217 |
Instruction set avr4 is for the enhanced \s-1AVR\s0 core with up to 8K program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9218 |
memory space (\s-1MCU\s0 types: atmega8, atmega83, atmega85). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9219 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9220 |
Instruction set avr5 is for the enhanced \s-1AVR\s0 core with up to 128K program |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9221 |
memory space (\s-1MCU\s0 types: atmega16, atmega161, atmega163, atmega32, atmega323, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9222 |
atmega64, atmega128, at43usb355, at94k). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9223 |
.Ip "\fB\-msize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9224 |
.IX Item "-msize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9225 |
Output instruction sizes to the asm file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9226 |
.Ip "\fB\-minit-stack=\fR\fIN\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9227 |
.IX Item "-minit-stack=N" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9228 |
Specify the initial stack address, which may be a symbol or numeric value, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9229 |
\&\fB_\|_stack\fR is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9230 |
.Ip "\fB\-mno-interrupts\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9231 |
.IX Item "-mno-interrupts" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9232 |
Generated code is not compatible with hardware interrupts. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9233 |
Code size will be smaller. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9234 |
.Ip "\fB\-mcall-prologues\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9235 |
.IX Item "-mcall-prologues" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9236 |
Functions prologues/epilogues expanded as call to appropriate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9237 |
subroutines. Code size will be smaller. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9238 |
.Ip "\fB\-mno-tablejump\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9239 |
.IX Item "-mno-tablejump" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9240 |
Do not generate tablejump insns which sometimes increase code size. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9241 |
.Ip "\fB\-mtiny-stack\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9242 |
.IX Item "-mtiny-stack" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9243 |
Change only the low 8 bits of the stack pointer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9244 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9245 |
.I "MCore Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9246 |
.IX Subsection "MCore Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9247 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9248 |
These are the \fB\-m\fR options defined for the Motorola M*Core |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9249 |
processors. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9250 |
.Ip "\fB\-mhardlit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9251 |
.IX Item "-mhardlit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9252 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9253 |
.Ip "\fB\-mno-hardlit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9254 |
.IX Item "-mno-hardlit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9255 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9256 |
Inline constants into the code stream if it can be done in two |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9257 |
instructions or less. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9258 |
.Ip "\fB\-mdiv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9259 |
.IX Item "-mdiv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9260 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9261 |
.Ip "\fB\-mno-div\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9262 |
.IX Item "-mno-div" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9263 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9264 |
Use the divide instruction. (Enabled by default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9265 |
.Ip "\fB\-mrelax-immediate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9266 |
.IX Item "-mrelax-immediate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9267 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9268 |
.Ip "\fB\-mno-relax-immediate\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9269 |
.IX Item "-mno-relax-immediate" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9270 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9271 |
Allow arbitrary sized immediates in bit operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9272 |
.Ip "\fB\-mwide-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9273 |
.IX Item "-mwide-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9274 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9275 |
.Ip "\fB\-mno-wide-bitfields\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9276 |
.IX Item "-mno-wide-bitfields" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9277 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9278 |
Always treat bit-fields as int-sized. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9279 |
.Ip "\fB\-m4byte-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9280 |
.IX Item "-m4byte-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9281 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9282 |
.Ip "\fB\-mno-4byte-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9283 |
.IX Item "-mno-4byte-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9284 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9285 |
Force all functions to be aligned to a four byte boundary. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9286 |
.Ip "\fB\-mcallgraph-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9287 |
.IX Item "-mcallgraph-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9288 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9289 |
.Ip "\fB\-mno-callgraph-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9290 |
.IX Item "-mno-callgraph-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9291 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9292 |
Emit callgraph information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9293 |
.Ip "\fB\-mslow-bytes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9294 |
.IX Item "-mslow-bytes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9295 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9296 |
.Ip "\fB\-mno-slow-bytes\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9297 |
.IX Item "-mno-slow-bytes" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9298 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9299 |
Prefer word access when reading byte quantities. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9300 |
.Ip "\fB\-mlittle-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9301 |
.IX Item "-mlittle-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9302 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9303 |
.Ip "\fB\-mbig-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9304 |
.IX Item "-mbig-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9305 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9306 |
Generate code for a little endian target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9307 |
.Ip "\fB\-m210\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9308 |
.IX Item "-m210" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9309 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9310 |
.Ip "\fB\-m340\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9311 |
.IX Item "-m340" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9312 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9313 |
Generate code for the 210 processor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9314 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9315 |
.I "\s-1IA-64\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9316 |
.IX Subsection "IA-64 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9317 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9318 |
These are the \fB\-m\fR options defined for the Intel \s-1IA-64\s0 architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9319 |
.Ip "\fB\-mbig-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9320 |
.IX Item "-mbig-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9321 |
Generate code for a big endian target. This is the default for \s-1HP-UX\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9322 |
.Ip "\fB\-mlittle-endian\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9323 |
.IX Item "-mlittle-endian" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9324 |
Generate code for a little endian target. This is the default for \s-1AIX5\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9325 |
and GNU/Linux. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9326 |
.Ip "\fB\-mgnu-as\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9327 |
.IX Item "-mgnu-as" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9328 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9329 |
.Ip "\fB\-mno-gnu-as\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9330 |
.IX Item "-mno-gnu-as" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9331 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9332 |
Generate (or don't) code for the \s-1GNU\s0 assembler. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9333 |
.Ip "\fB\-mgnu-ld\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9334 |
.IX Item "-mgnu-ld" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9335 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9336 |
.Ip "\fB\-mno-gnu-ld\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9337 |
.IX Item "-mno-gnu-ld" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9338 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9339 |
Generate (or don't) code for the \s-1GNU\s0 linker. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9340 |
.Ip "\fB\-mno-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9341 |
.IX Item "-mno-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9342 |
Generate code that does not use a global pointer register. The result |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9343 |
is not position independent code, and violates the \s-1IA-64\s0 \s-1ABI\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9344 |
.Ip "\fB\-mvolatile-asm-stop\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9345 |
.IX Item "-mvolatile-asm-stop" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9346 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9347 |
.Ip "\fB\-mno-volatile-asm-stop\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9348 |
.IX Item "-mno-volatile-asm-stop" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9349 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9350 |
Generate (or don't) a stop bit immediately before and after volatile asm |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9351 |
statements. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9352 |
.Ip "\fB\-mb-step\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9353 |
.IX Item "-mb-step" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9354 |
Generate code that works around Itanium B step errata. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9355 |
.Ip "\fB\-mregister-names\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9356 |
.IX Item "-mregister-names" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9357 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9358 |
.Ip "\fB\-mno-register-names\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9359 |
.IX Item "-mno-register-names" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9360 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9361 |
Generate (or don't) \fBin\fR, \fBloc\fR, and \fBout\fR register names for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9362 |
the stacked registers. This may make assembler output more readable. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9363 |
.Ip "\fB\-mno-sdata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9364 |
.IX Item "-mno-sdata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9365 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9366 |
.Ip "\fB\-msdata\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9367 |
.IX Item "-msdata" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9368 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9369 |
Disable (or enable) optimizations that use the small data section. This may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9370 |
be useful for working around optimizer bugs. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9371 |
.Ip "\fB\-mconstant-gp\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9372 |
.IX Item "-mconstant-gp" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9373 |
Generate code that uses a single constant global pointer value. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9374 |
useful when compiling kernel code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9375 |
.Ip "\fB\-mauto-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9376 |
.IX Item "-mauto-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9377 |
Generate code that is self-relocatable. This implies \fB\-mconstant-gp\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9378 |
This is useful when compiling firmware code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9379 |
.Ip "\fB\-minline-float-divide-min-latency\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9380 |
.IX Item "-minline-float-divide-min-latency" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9381 |
Generate code for inline divides of floating point values |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9382 |
using the minimum latency algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9383 |
.Ip "\fB\-minline-float-divide-max-throughput\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9384 |
.IX Item "-minline-float-divide-max-throughput" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9385 |
Generate code for inline divides of floating point values |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9386 |
using the maximum throughput algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9387 |
.Ip "\fB\-minline-int-divide-min-latency\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9388 |
.IX Item "-minline-int-divide-min-latency" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9389 |
Generate code for inline divides of integer values |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9390 |
using the minimum latency algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9391 |
.Ip "\fB\-minline-int-divide-max-throughput\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9392 |
.IX Item "-minline-int-divide-max-throughput" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9393 |
Generate code for inline divides of integer values |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9394 |
using the maximum throughput algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9395 |
.Ip "\fB\-minline-sqrt-min-latency\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9396 |
.IX Item "-minline-sqrt-min-latency" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9397 |
Generate code for inline square roots |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9398 |
using the minimum latency algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9399 |
.Ip "\fB\-minline-sqrt-max-throughput\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9400 |
.IX Item "-minline-sqrt-max-throughput" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9401 |
Generate code for inline square roots |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9402 |
using the maximum throughput algorithm. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9403 |
.Ip "\fB\-mno-dwarf2\-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9404 |
.IX Item "-mno-dwarf2-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9405 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9406 |
.Ip "\fB\-mdwarf2\-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9407 |
.IX Item "-mdwarf2-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9408 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9409 |
Don't (or do) generate assembler code for the \s-1DWARF2\s0 line number debugging |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9410 |
info. This may be useful when not using the \s-1GNU\s0 assembler. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9411 |
.Ip "\fB\-mearly-stop-bits\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9412 |
.IX Item "-mearly-stop-bits" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9413 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9414 |
.Ip "\fB\-mno-early-stop-bits\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9415 |
.IX Item "-mno-early-stop-bits" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9416 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9417 |
Allow stop bits to be placed earlier than immediately preceding the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9418 |
instruction that triggered the stop bit. This can improve instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9419 |
scheduling, but does not always do so. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9420 |
.Ip "\fB\-mfixed-range=\fR\fIregister-range\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9421 |
.IX Item "-mfixed-range=register-range" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9422 |
Generate code treating the given register range as fixed registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9423 |
A fixed register is one that the register allocator can not use. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9424 |
useful when compiling kernel code. A register range is specified as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9425 |
two registers separated by a dash. Multiple register ranges can be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9426 |
specified separated by a comma. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9427 |
.Ip "\fB\-mtls-size=\fR\fItls-size\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9428 |
.IX Item "-mtls-size=tls-size" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9429 |
Specify bit size of immediate \s-1TLS\s0 offsets. Valid values are 14, 22, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9430 |
64. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9431 |
.Ip "\fB\-mtune=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9432 |
.IX Item "-mtune=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9433 |
Tune the instruction scheduling for a particular \s-1CPU\s0, Valid values are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9434 |
itanium, itanium1, merced, itanium2, and mckinley. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9435 |
.Ip "\fB\-mt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9436 |
.IX Item "-mt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9437 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9438 |
.Ip "\fB\-pthread\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9439 |
.IX Item "-pthread" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9440 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9441 |
Add support for multithreading using the \s-1POSIX\s0 threads library. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9442 |
option sets flags for both the preprocessor and linker. It does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9443 |
not affect the thread safety of object code produced by the compiler or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9444 |
that of libraries supplied with it. These are \s-1HP-UX\s0 specific flags. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9445 |
.Ip "\fB\-milp32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9446 |
.IX Item "-milp32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9447 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9448 |
.Ip "\fB\-mlp64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9449 |
.IX Item "-mlp64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9450 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9451 |
Generate code for a 32\-bit or 64\-bit environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9452 |
The 32\-bit environment sets int, long and pointer to 32 bits. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9453 |
The 64\-bit environment sets int to 32 bits and long and pointer |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9454 |
to 64 bits. These are \s-1HP-UX\s0 specific flags. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9455 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9456 |
.I "D30V Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9457 |
.IX Subsection "D30V Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9458 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9459 |
These \fB\-m\fR options are defined for D30V implementations: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9460 |
.Ip "\fB\-mextmem\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9461 |
.IX Item "-mextmem" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9462 |
Link the \fB.text\fR, \fB.data\fR, \fB.bss\fR, \fB.strings\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9463 |
\&\fB.rodata\fR, \fB.rodata1\fR, \fB.data1\fR sections into external |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9464 |
memory, which starts at location \f(CW\*(C`0x80000000\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9465 |
.Ip "\fB\-mextmemory\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9466 |
.IX Item "-mextmemory" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9467 |
Same as the \fB\-mextmem\fR switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9468 |
.Ip "\fB\-monchip\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9469 |
.IX Item "-monchip" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9470 |
Link the \fB.text\fR section into onchip text memory, which starts at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9471 |
location \f(CW\*(C`0x0\*(C'\fR. Also link \fB.data\fR, \fB.bss\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9472 |
\&\fB.strings\fR, \fB.rodata\fR, \fB.rodata1\fR, \fB.data1\fR sections |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9473 |
into onchip data memory, which starts at location \f(CW\*(C`0x20000000\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9474 |
.Ip "\fB\-mno-asm-optimize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9475 |
.IX Item "-mno-asm-optimize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9476 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9477 |
.Ip "\fB\-masm-optimize\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9478 |
.IX Item "-masm-optimize" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9479 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9480 |
Disable (enable) passing \fB\-O\fR to the assembler when optimizing. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9481 |
The assembler uses the \fB\-O\fR option to automatically parallelize |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9482 |
adjacent short instructions where possible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9483 |
.Ip "\fB\-mbranch-cost=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9484 |
.IX Item "-mbranch-cost=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9485 |
Increase the internal costs of branches to \fIn\fR. Higher costs means |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9486 |
that the compiler will issue more instructions to avoid doing a branch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9487 |
The default is 2. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9488 |
.Ip "\fB\-mcond-exec=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9489 |
.IX Item "-mcond-exec=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9490 |
Specify the maximum number of conditionally executed instructions that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9491 |
replace a branch. The default is 4. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9492 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9493 |
.I "S/390 and zSeries Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9494 |
.IX Subsection "S/390 and zSeries Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9495 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9496 |
These are the \fB\-m\fR options defined for the S/390 and zSeries architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9497 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9498 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9499 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9500 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9501 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9502 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9503 |
Use (do not use) the hardware floating-point instructions and registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9504 |
for floating-point operations. When \fB\-msoft-float\fR is specified, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9505 |
functions in \fIlibgcc.a\fR will be used to perform floating-point |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9506 |
operations. When \fB\-mhard-float\fR is specified, the compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9507 |
generates \s-1IEEE\s0 floating-point instructions. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9508 |
.Ip "\fB\-mbackchain\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9509 |
.IX Item "-mbackchain" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9510 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9511 |
.Ip "\fB\-mno-backchain\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9512 |
.IX Item "-mno-backchain" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9513 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9514 |
Generate (or do not generate) code which maintains an explicit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9515 |
backchain within the stack frame that points to the caller's frame. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9516 |
This may be needed to allow debugging using tools that do not understand |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9517 |
\&\s-1DWARF-2\s0 call frame information. The default is not to generate the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9518 |
backchain. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9519 |
.Ip "\fB\-msmall-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9520 |
.IX Item "-msmall-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9521 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9522 |
.Ip "\fB\-mno-small-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9523 |
.IX Item "-mno-small-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9524 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9525 |
Generate (or do not generate) code using the \f(CW\*(C`bras\*(C'\fR instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9526 |
to do subroutine calls. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9527 |
This only works reliably if the total executable size does not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9528 |
exceed 64k. The default is to use the \f(CW\*(C`basr\*(C'\fR instruction instead, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9529 |
which does not have this limitation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9530 |
.Ip "\fB\-m64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9531 |
.IX Item "-m64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9532 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9533 |
.Ip "\fB\-m31\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9534 |
.IX Item "-m31" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9535 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9536 |
When \fB\-m31\fR is specified, generate code compliant to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9537 |
GNU/Linux for S/390 \s-1ABI\s0. When \fB\-m64\fR is specified, generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9538 |
code compliant to the GNU/Linux for zSeries \s-1ABI\s0. This allows \s-1GCC\s0 in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9539 |
particular to generate 64\-bit instructions. For the \fBs390\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9540 |
targets, the default is \fB\-m31\fR, while the \fBs390x\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9541 |
targets default to \fB\-m64\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9542 |
.Ip "\fB\-mzarch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9543 |
.IX Item "-mzarch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9544 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9545 |
.Ip "\fB\-mesa\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9546 |
.IX Item "-mesa" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9547 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9548 |
When \fB\-mzarch\fR is specified, generate code using the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9549 |
instructions available on z/Architecture. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9550 |
When \fB\-mesa\fR is specified, generate code using the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9551 |
instructions available on \s-1ESA/390\s0. Note that \fB\-mesa\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9552 |
not possible with \fB\-m64\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9553 |
When generating code compliant to the GNU/Linux for S/390 \s-1ABI\s0, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9554 |
the default is \fB\-mesa\fR. When generating code compliant |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9555 |
to the GNU/Linux for zSeries \s-1ABI\s0, the default is \fB\-mzarch\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9556 |
.Ip "\fB\-mmvcle\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9557 |
.IX Item "-mmvcle" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9558 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9559 |
.Ip "\fB\-mno-mvcle\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9560 |
.IX Item "-mno-mvcle" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9561 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9562 |
Generate (or do not generate) code using the \f(CW\*(C`mvcle\*(C'\fR instruction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9563 |
to perform block moves. When \fB\-mno-mvcle\fR is specified, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9564 |
use a \f(CW\*(C`mvc\*(C'\fR loop instead. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9565 |
.Ip "\fB\-mdebug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9566 |
.IX Item "-mdebug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9567 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9568 |
.Ip "\fB\-mno-debug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9569 |
.IX Item "-mno-debug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9570 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9571 |
Print (or do not print) additional debug information when compiling. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9572 |
The default is to not print debug information. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9573 |
.Ip "\fB\-march=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9574 |
.IX Item "-march=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9575 |
Generate code that will run on \fIcpu-type\fR, which is the name of a system |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9576 |
representing a certain processor type. Possible values for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9577 |
\&\fIcpu-type\fR are \fBg5\fR, \fBg6\fR, \fBz900\fR, and \fBz990\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9578 |
When generating code using the instructions available on z/Architecture, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9579 |
the default is \fB\-march=z900\fR. Otherwise, the default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9580 |
\&\fB\-march=g5\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9581 |
.Ip "\fB\-mtune=\fR\fIcpu-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9582 |
.IX Item "-mtune=cpu-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9583 |
Tune to \fIcpu-type\fR everything applicable about the generated code, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9584 |
except for the \s-1ABI\s0 and the set of available instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9585 |
The list of \fIcpu-type\fR values is the same as for \fB\-march\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9586 |
The default is the value used for \fB\-march\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9587 |
.Ip "\fB\-mfused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9588 |
.IX Item "-mfused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9589 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9590 |
.Ip "\fB\-mno-fused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9591 |
.IX Item "-mno-fused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9592 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9593 |
Generate code that uses (does not use) the floating point multiply and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9594 |
accumulate instructions. These instructions are generated by default if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9595 |
hardware floating point is used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9596 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9597 |
.I "\s-1CRIS\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9598 |
.IX Subsection "CRIS Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9599 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9600 |
These options are defined specifically for the \s-1CRIS\s0 ports. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9601 |
.Ip "\fB\-march=\fR\fIarchitecture-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9602 |
.IX Item "-march=architecture-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9603 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9604 |
.Ip "\fB\-mcpu=\fR\fIarchitecture-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9605 |
.IX Item "-mcpu=architecture-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9606 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9607 |
Generate code for the specified architecture. The choices for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9608 |
\&\fIarchitecture-type\fR are \fBv3\fR, \fBv8\fR and \fBv10\fR for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9609 |
respectively \s-1ETRAX\s0\ 4, \s-1ETRAX\s0\ 100, and \s-1ETRAX\s0\ 100\ \s-1LX\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9610 |
Default is \fBv0\fR except for cris-axis-linux-gnu, where the default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9611 |
\&\fBv10\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9612 |
.Ip "\fB\-mtune=\fR\fIarchitecture-type\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9613 |
.IX Item "-mtune=architecture-type" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9614 |
Tune to \fIarchitecture-type\fR everything applicable about the generated |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9615 |
code, except for the \s-1ABI\s0 and the set of available instructions. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9616 |
choices for \fIarchitecture-type\fR are the same as for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9617 |
\&\fB\-march=\fR\fIarchitecture-type\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9618 |
.Ip "\fB\-mmax-stack-frame=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9619 |
.IX Item "-mmax-stack-frame=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9620 |
Warn when the stack frame of a function exceeds \fIn\fR bytes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9621 |
.Ip "\fB\-melinux-stacksize=\fR\fIn\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9622 |
.IX Item "-melinux-stacksize=n" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9623 |
Only available with the \fBcris-axis-aout\fR target. Arranges for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9624 |
indications in the program to the kernel loader that the stack of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9625 |
program should be set to \fIn\fR bytes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9626 |
.Ip "\fB\-metrax4\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9627 |
.IX Item "-metrax4" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9628 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9629 |
.Ip "\fB\-metrax100\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9630 |
.IX Item "-metrax100" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9631 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9632 |
The options \fB\-metrax4\fR and \fB\-metrax100\fR are synonyms for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9633 |
\&\fB\-march=v3\fR and \fB\-march=v8\fR respectively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9634 |
.Ip "\fB\-mmul-bug-workaround\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9635 |
.IX Item "-mmul-bug-workaround" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9636 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9637 |
.Ip "\fB\-mno-mul-bug-workaround\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9638 |
.IX Item "-mno-mul-bug-workaround" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9639 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9640 |
Work around a bug in the \f(CW\*(C`muls\*(C'\fR and \f(CW\*(C`mulu\*(C'\fR instructions for \s-1CPU\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9641 |
models where it applies. This option is active by default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9642 |
.Ip "\fB\-mpdebug\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9643 |
.IX Item "-mpdebug" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9644 |
Enable CRIS-specific verbose debug-related information in the assembly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9645 |
code. This option also has the effect to turn off the \fB#NO_APP\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9646 |
formatted-code indicator to the assembler at the beginning of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9647 |
assembly file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9648 |
.Ip "\fB\-mcc-init\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9649 |
.IX Item "-mcc-init" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9650 |
Do not use condition-code results from previous instruction; always emit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9651 |
compare and test instructions before use of condition codes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9652 |
.Ip "\fB\-mno-side-effects\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9653 |
.IX Item "-mno-side-effects" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9654 |
Do not emit instructions with side-effects in addressing modes other than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9655 |
post-increment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9656 |
.Ip "\fB\-mstack-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9657 |
.IX Item "-mstack-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9658 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9659 |
.Ip "\fB\-mno-stack-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9660 |
.IX Item "-mno-stack-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9661 |
.Ip "\fB\-mdata-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9662 |
.IX Item "-mdata-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9663 |
.Ip "\fB\-mno-data-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9664 |
.IX Item "-mno-data-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9665 |
.Ip "\fB\-mconst-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9666 |
.IX Item "-mconst-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9667 |
.Ip "\fB\-mno-const-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9668 |
.IX Item "-mno-const-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9669 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9670 |
These options (no-options) arranges (eliminate arrangements) for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9671 |
stack-frame, individual data and constants to be aligned for the maximum |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9672 |
single data access size for the chosen \s-1CPU\s0 model. The default is to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9673 |
arrange for 32\-bit alignment. \s-1ABI\s0 details such as structure layout are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9674 |
not affected by these options. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9675 |
.Ip "\fB\-m32\-bit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9676 |
.IX Item "-m32-bit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9677 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9678 |
.Ip "\fB\-m16\-bit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9679 |
.IX Item "-m16-bit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9680 |
.Ip "\fB\-m8\-bit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9681 |
.IX Item "-m8-bit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9682 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9683 |
Similar to the stack- data- and const-align options above, these options |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9684 |
arrange for stack-frame, writable data and constants to all be 32\-bit, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9685 |
16\-bit or 8\-bit aligned. The default is 32\-bit alignment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9686 |
.Ip "\fB\-mno-prologue-epilogue\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9687 |
.IX Item "-mno-prologue-epilogue" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9688 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9689 |
.Ip "\fB\-mprologue-epilogue\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9690 |
.IX Item "-mprologue-epilogue" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9691 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9692 |
With \fB\-mno-prologue-epilogue\fR, the normal function prologue and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9693 |
epilogue that sets up the stack-frame are omitted and no return |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9694 |
instructions or return sequences are generated in the code. Use this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9695 |
option only together with visual inspection of the compiled code: no |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9696 |
warnings or errors are generated when call-saved registers must be saved, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9697 |
or storage for local variable needs to be allocated. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9698 |
.Ip "\fB\-mno-gotplt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9699 |
.IX Item "-mno-gotplt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9700 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9701 |
.Ip "\fB\-mgotplt\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9702 |
.IX Item "-mgotplt" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9703 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9704 |
With \fB\-fpic\fR and \fB\-fPIC\fR, don't generate (do generate) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9705 |
instruction sequences that load addresses for functions from the \s-1PLT\s0 part |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9706 |
of the \s-1GOT\s0 rather than (traditional on other architectures) calls to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9707 |
\&\s-1PLT\s0. The default is \fB\-mgotplt\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9708 |
.Ip "\fB\-maout\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9709 |
.IX Item "-maout" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9710 |
Legacy no-op option only recognized with the cris-axis-aout target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9711 |
.Ip "\fB\-melf\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9712 |
.IX Item "-melf" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9713 |
Legacy no-op option only recognized with the cris-axis-elf and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9714 |
cris-axis-linux-gnu targets. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9715 |
.Ip "\fB\-melinux\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9716 |
.IX Item "-melinux" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9717 |
Only recognized with the cris-axis-aout target, where it selects a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9718 |
GNU/linux-like multilib, include files and instruction set for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9719 |
\&\fB\-march=v8\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9720 |
.Ip "\fB\-mlinux\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9721 |
.IX Item "-mlinux" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9722 |
Legacy no-op option only recognized with the cris-axis-linux-gnu target. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9723 |
.Ip "\fB\-sim\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9724 |
.IX Item "-sim" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9725 |
This option, recognized for the cris-axis-aout and cris-axis-elf arranges |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9726 |
to link with input-output functions from a simulator library. Code, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9727 |
initialized data and zero-initialized data are allocated consecutively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9728 |
.Ip "\fB\-sim2\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9729 |
.IX Item "-sim2" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9730 |
Like \fB\-sim\fR, but pass linker options to locate initialized data at |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9731 |
0x40000000 and zero-initialized data at 0x80000000. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9732 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9733 |
.I "\s-1MMIX\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9734 |
.IX Subsection "MMIX Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9735 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9736 |
These options are defined for the \s-1MMIX:\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9737 |
.Ip "\fB\-mlibfuncs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9738 |
.IX Item "-mlibfuncs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9739 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9740 |
.Ip "\fB\-mno-libfuncs\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9741 |
.IX Item "-mno-libfuncs" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9742 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9743 |
Specify that intrinsic library functions are being compiled, passing all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9744 |
values in registers, no matter the size. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9745 |
.Ip "\fB\-mepsilon\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9746 |
.IX Item "-mepsilon" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9747 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9748 |
.Ip "\fB\-mno-epsilon\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9749 |
.IX Item "-mno-epsilon" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9750 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9751 |
Generate floating-point comparison instructions that compare with respect |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9752 |
to the \f(CW\*(C`rE\*(C'\fR epsilon register. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9753 |
.Ip "\fB\-mabi=mmixware\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9754 |
.IX Item "-mabi=mmixware" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9755 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9756 |
.Ip "\fB\-mabi=gnu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9757 |
.IX Item "-mabi=gnu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9758 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9759 |
Generate code that passes function parameters and return values that (in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9760 |
the called function) are seen as registers \f(CW\*(C`$0\*(C'\fR and up, as opposed to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9761 |
the \s-1GNU\s0 \s-1ABI\s0 which uses global registers \f(CW\*(C`$231\*(C'\fR and up. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9762 |
.Ip "\fB\-mzero-extend\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9763 |
.IX Item "-mzero-extend" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9764 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9765 |
.Ip "\fB\-mno-zero-extend\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9766 |
.IX Item "-mno-zero-extend" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9767 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9768 |
When reading data from memory in sizes shorter than 64 bits, use (do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9769 |
use) zero-extending load instructions by default, rather than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9770 |
sign-extending ones. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9771 |
.Ip "\fB\-mknuthdiv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9772 |
.IX Item "-mknuthdiv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9773 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9774 |
.Ip "\fB\-mno-knuthdiv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9775 |
.IX Item "-mno-knuthdiv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9776 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9777 |
Make the result of a division yielding a remainder have the same sign as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9778 |
the divisor. With the default, \fB\-mno-knuthdiv\fR, the sign of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9779 |
remainder follows the sign of the dividend. Both methods are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9780 |
arithmetically valid, the latter being almost exclusively used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9781 |
.Ip "\fB\-mtoplevel-symbols\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9782 |
.IX Item "-mtoplevel-symbols" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9783 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9784 |
.Ip "\fB\-mno-toplevel-symbols\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9785 |
.IX Item "-mno-toplevel-symbols" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9786 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9787 |
Prepend (do not prepend) a \fB:\fR to all global symbols, so the assembly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9788 |
code can be used with the \f(CW\*(C`PREFIX\*(C'\fR assembly directive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9789 |
.Ip "\fB\-melf\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9790 |
.IX Item "-melf" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9791 |
Generate an executable in the \s-1ELF\s0 format, rather than the default |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9792 |
\&\fBmmo\fR format used by the \fBmmix\fR simulator. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9793 |
.Ip "\fB\-mbranch-predict\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9794 |
.IX Item "-mbranch-predict" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9795 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9796 |
.Ip "\fB\-mno-branch-predict\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9797 |
.IX Item "-mno-branch-predict" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9798 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9799 |
Use (do not use) the probable-branch instructions, when static branch |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9800 |
prediction indicates a probable branch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9801 |
.Ip "\fB\-mbase-addresses\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9802 |
.IX Item "-mbase-addresses" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9803 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9804 |
.Ip "\fB\-mno-base-addresses\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9805 |
.IX Item "-mno-base-addresses" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9806 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9807 |
Generate (do not generate) code that uses \fIbase addresses\fR. Using a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9808 |
base address automatically generates a request (handled by the assembler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9809 |
and the linker) for a constant to be set up in a global register. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9810 |
register is used for one or more base address requests within the range 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9811 |
to 255 from the value held in the register. The generally leads to short |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9812 |
and fast code, but the number of different data items that can be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9813 |
addressed is limited. This means that a program that uses lots of static |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9814 |
data may require \fB\-mno-base-addresses\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9815 |
.Ip "\fB\-msingle-exit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9816 |
.IX Item "-msingle-exit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9817 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9818 |
.Ip "\fB\-mno-single-exit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9819 |
.IX Item "-mno-single-exit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9820 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9821 |
Force (do not force) generated code to have a single exit point in each |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9822 |
function. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9823 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9824 |
.I "\s-1PDP-11\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9825 |
.IX Subsection "PDP-11 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9826 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9827 |
These options are defined for the \s-1PDP-11:\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9828 |
.Ip "\fB\-mfpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9829 |
.IX Item "-mfpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9830 |
Use hardware \s-1FPP\s0 floating point. This is the default. (\s-1FIS\s0 floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9831 |
point on the \s-1PDP-11/40\s0 is not supported.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9832 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9833 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9834 |
Do not use hardware floating point. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9835 |
.Ip "\fB\-mac0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9836 |
.IX Item "-mac0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9837 |
Return floating-point results in ac0 (fr0 in Unix assembler syntax). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9838 |
.Ip "\fB\-mno-ac0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9839 |
.IX Item "-mno-ac0" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9840 |
Return floating-point results in memory. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9841 |
.Ip "\fB\-m40\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9842 |
.IX Item "-m40" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9843 |
Generate code for a \s-1PDP-11/40\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9844 |
.Ip "\fB\-m45\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9845 |
.IX Item "-m45" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9846 |
Generate code for a \s-1PDP-11/45\s0. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9847 |
.Ip "\fB\-m10\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9848 |
.IX Item "-m10" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9849 |
Generate code for a \s-1PDP-11/10\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9850 |
.Ip "\fB\-mbcopy-builtin\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9851 |
.IX Item "-mbcopy-builtin" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9852 |
Use inline \f(CW\*(C`movstrhi\*(C'\fR patterns for copying memory. This is the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9853 |
default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9854 |
.Ip "\fB\-mbcopy\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9855 |
.IX Item "-mbcopy" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9856 |
Do not use inline \f(CW\*(C`movstrhi\*(C'\fR patterns for copying memory. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9857 |
.Ip "\fB\-mint16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9858 |
.IX Item "-mint16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9859 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9860 |
.Ip "\fB\-mno-int32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9861 |
.IX Item "-mno-int32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9862 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9863 |
Use 16\-bit \f(CW\*(C`int\*(C'\fR. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9864 |
.Ip "\fB\-mint32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9865 |
.IX Item "-mint32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9866 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9867 |
.Ip "\fB\-mno-int16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9868 |
.IX Item "-mno-int16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9869 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9870 |
Use 32\-bit \f(CW\*(C`int\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9871 |
.Ip "\fB\-mfloat64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9872 |
.IX Item "-mfloat64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9873 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9874 |
.Ip "\fB\-mno-float32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9875 |
.IX Item "-mno-float32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9876 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9877 |
Use 64\-bit \f(CW\*(C`float\*(C'\fR. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9878 |
.Ip "\fB\-mfloat32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9879 |
.IX Item "-mfloat32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9880 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9881 |
.Ip "\fB\-mno-float64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9882 |
.IX Item "-mno-float64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9883 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9884 |
Use 32\-bit \f(CW\*(C`float\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9885 |
.Ip "\fB\-mabshi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9886 |
.IX Item "-mabshi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9887 |
Use \f(CW\*(C`abshi2\*(C'\fR pattern. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9888 |
.Ip "\fB\-mno-abshi\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9889 |
.IX Item "-mno-abshi" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9890 |
Do not use \f(CW\*(C`abshi2\*(C'\fR pattern. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9891 |
.Ip "\fB\-mbranch-expensive\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9892 |
.IX Item "-mbranch-expensive" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9893 |
Pretend that branches are expensive. This is for experimenting with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9894 |
code generation only. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9895 |
.Ip "\fB\-mbranch-cheap\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9896 |
.IX Item "-mbranch-cheap" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9897 |
Do not pretend that branches are expensive. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9898 |
.Ip "\fB\-msplit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9899 |
.IX Item "-msplit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9900 |
Generate code for a system with split I&D. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9901 |
.Ip "\fB\-mno-split\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9902 |
.IX Item "-mno-split" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9903 |
Generate code for a system without split I&D. This is the default. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9904 |
.Ip "\fB\-munix-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9905 |
.IX Item "-munix-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9906 |
Use Unix assembler syntax. This is the default when configured for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9907 |
\&\fBpdp11\-*\-bsd\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9908 |
.Ip "\fB\-mdec-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9909 |
.IX Item "-mdec-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9910 |
Use \s-1DEC\s0 assembler syntax. This is the default when configured for any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9911 |
\&\s-1PDP-11\s0 target other than \fBpdp11\-*\-bsd\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9912 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9913 |
.I "Xstormy16 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9914 |
.IX Subsection "Xstormy16 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9915 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9916 |
These options are defined for Xstormy16: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9917 |
.Ip "\fB\-msim\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9918 |
.IX Item "-msim" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9919 |
Choose startup files and linker script suitable for the simulator. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9920 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9921 |
.I "\s-1FRV\s0 Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9922 |
.IX Subsection "FRV Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9923 |
.Ip "\fB\-mgpr-32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9924 |
.IX Item "-mgpr-32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9925 |
Only use the first 32 general purpose registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9926 |
.Ip "\fB\-mgpr-64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9927 |
.IX Item "-mgpr-64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9928 |
Use all 64 general purpose registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9929 |
.Ip "\fB\-mfpr-32\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9930 |
.IX Item "-mfpr-32" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9931 |
Use only the first 32 floating point registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9932 |
.Ip "\fB\-mfpr-64\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9933 |
.IX Item "-mfpr-64" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9934 |
Use all 64 floating point registers |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9935 |
.Ip "\fB\-mhard-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9936 |
.IX Item "-mhard-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9937 |
Use hardware instructions for floating point operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9938 |
.Ip "\fB\-msoft-float\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9939 |
.IX Item "-msoft-float" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9940 |
Use library routines for floating point operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9941 |
.Ip "\fB\-malloc-cc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9942 |
.IX Item "-malloc-cc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9943 |
Dynamically allocate condition code registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9944 |
.Ip "\fB\-mfixed-cc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9945 |
.IX Item "-mfixed-cc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9946 |
Do not try to dynamically allocate condition code registers, only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9947 |
use \f(CW\*(C`icc0\*(C'\fR and \f(CW\*(C`fcc0\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9948 |
.Ip "\fB\-mdword\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9949 |
.IX Item "-mdword" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9950 |
Change \s-1ABI\s0 to use double word insns. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9951 |
.Ip "\fB\-mno-dword\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9952 |
.IX Item "-mno-dword" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9953 |
Do not use double word instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9954 |
.Ip "\fB\-mdouble\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9955 |
.IX Item "-mdouble" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9956 |
Use floating point double instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9957 |
.Ip "\fB\-mno-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9958 |
.IX Item "-mno-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9959 |
Do not use floating point double instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9960 |
.Ip "\fB\-mmedia\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9961 |
.IX Item "-mmedia" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9962 |
Use media instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9963 |
.Ip "\fB\-mno-media\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9964 |
.IX Item "-mno-media" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9965 |
Do not use media instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9966 |
.Ip "\fB\-mmuladd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9967 |
.IX Item "-mmuladd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9968 |
Use multiply and add/subtract instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9969 |
.Ip "\fB\-mno-muladd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9970 |
.IX Item "-mno-muladd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9971 |
Do not use multiply and add/subtract instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9972 |
.Ip "\fB\-mlibrary-pic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9973 |
.IX Item "-mlibrary-pic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9974 |
Enable \s-1PIC\s0 support for building libraries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9975 |
.Ip "\fB\-macc-4\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9976 |
.IX Item "-macc-4" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9977 |
Use only the first four media accumulator registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9978 |
.Ip "\fB\-macc-8\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9979 |
.IX Item "-macc-8" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9980 |
Use all eight media accumulator registers. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9981 |
.Ip "\fB\-mpack\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9982 |
.IX Item "-mpack" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9983 |
Pack \s-1VLIW\s0 instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9984 |
.Ip "\fB\-mno-pack\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9985 |
.IX Item "-mno-pack" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9986 |
Do not pack \s-1VLIW\s0 instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9987 |
.Ip "\fB\-mno-eflags\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9988 |
.IX Item "-mno-eflags" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9989 |
Do not mark \s-1ABI\s0 switches in e_flags. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9990 |
.Ip "\fB\-mcond-move\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9991 |
.IX Item "-mcond-move" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9992 |
Enable the use of conditional-move instructions (default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9993 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9994 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9995 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9996 |
.Ip "\fB\-mno-cond-move\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9997 |
.IX Item "-mno-cond-move" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9998 |
Disable the use of conditional-move instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
9999 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10000 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10001 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10002 |
.Ip "\fB\-mscc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10003 |
.IX Item "-mscc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10004 |
Enable the use of conditional set instructions (default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10005 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10006 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10007 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10008 |
.Ip "\fB\-mno-scc\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10009 |
.IX Item "-mno-scc" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10010 |
Disable the use of conditional set instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10011 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10012 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10013 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10014 |
.Ip "\fB\-mcond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10015 |
.IX Item "-mcond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10016 |
Enable the use of conditional execution (default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10017 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10018 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10019 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10020 |
.Ip "\fB\-mno-cond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10021 |
.IX Item "-mno-cond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10022 |
Disable the use of conditional execution. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10023 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10024 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10025 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10026 |
.Ip "\fB\-mvliw-branch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10027 |
.IX Item "-mvliw-branch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10028 |
Run a pass to pack branches into \s-1VLIW\s0 instructions (default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10029 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10030 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10031 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10032 |
.Ip "\fB\-mno-vliw-branch\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10033 |
.IX Item "-mno-vliw-branch" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10034 |
Do not run a pass to pack branches into \s-1VLIW\s0 instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10035 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10036 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10037 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10038 |
.Ip "\fB\-mmulti-cond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10039 |
.IX Item "-mmulti-cond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10040 |
Enable optimization of \f(CW\*(C`&&\*(C'\fR and \f(CW\*(C`||\*(C'\fR in conditional execution |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10041 |
(default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10042 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10043 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10044 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10045 |
.Ip "\fB\-mno-multi-cond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10046 |
.IX Item "-mno-multi-cond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10047 |
Disable optimization of \f(CW\*(C`&&\*(C'\fR and \f(CW\*(C`||\*(C'\fR in conditional execution. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10048 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10049 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10050 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10051 |
.Ip "\fB\-mnested-cond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10052 |
.IX Item "-mnested-cond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10053 |
Enable nested conditional execution optimizations (default). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10054 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10055 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10056 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10057 |
.Ip "\fB\-mno-nested-cond-exec\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10058 |
.IX Item "-mno-nested-cond-exec" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10059 |
Disable nested conditional execution optimizations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10060 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10061 |
This switch is mainly for debugging the compiler and will likely be removed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10062 |
in a future version. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10063 |
.Ip "\fB\-mtomcat-stats\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10064 |
.IX Item "-mtomcat-stats" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10065 |
Cause gas to print out tomcat statistics. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10066 |
.Ip "\fB\-mcpu=\fR\fIcpu\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10067 |
.IX Item "-mcpu=cpu" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10068 |
Select the processor type for which to generate code. Possible values are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10069 |
\&\fBsimple\fR, \fBtomcat\fR, \fBfr500\fR, \fBfr400\fR, \fBfr300\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10070 |
\&\fBfrv\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10071 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10072 |
.I "Xtensa Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10073 |
.IX Subsection "Xtensa Options" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10074 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10075 |
These options are supported for Xtensa targets: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10076 |
.Ip "\fB\-mconst16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10077 |
.IX Item "-mconst16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10078 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10079 |
.Ip "\fB\-mno-const16\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10080 |
.IX Item "-mno-const16" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10081 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10082 |
Enable or disable use of \f(CW\*(C`CONST16\*(C'\fR instructions for loading |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10083 |
constant values. The \f(CW\*(C`CONST16\*(C'\fR instruction is currently not a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10084 |
standard option from Tensilica. When enabled, \f(CW\*(C`CONST16\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10085 |
instructions are always used in place of the standard \f(CW\*(C`L32R\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10086 |
instructions. The use of \f(CW\*(C`CONST16\*(C'\fR is enabled by default only if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10087 |
the \f(CW\*(C`L32R\*(C'\fR instruction is not available. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10088 |
.Ip "\fB\-mfused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10089 |
.IX Item "-mfused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10090 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10091 |
.Ip "\fB\-mno-fused-madd\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10092 |
.IX Item "-mno-fused-madd" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10093 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10094 |
Enable or disable use of fused multiply/add and multiply/subtract |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10095 |
instructions in the floating-point option. This has no effect if the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10096 |
floating-point option is not also enabled. Disabling fused multiply/add |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10097 |
and multiply/subtract instructions forces the compiler to use separate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10098 |
instructions for the multiply and add/subtract operations. This may be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10099 |
desirable in some cases where strict \s-1IEEE\s0 754\-compliant results are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10100 |
required: the fused multiply add/subtract instructions do not round the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10101 |
intermediate result, thereby producing results with \fImore\fR bits of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10102 |
precision than specified by the \s-1IEEE\s0 standard. Disabling fused multiply |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10103 |
add/subtract instructions also ensures that the program output is not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10104 |
sensitive to the compiler's ability to combine multiply and add/subtract |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10105 |
operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10106 |
.Ip "\fB\-mtext-section-literals\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10107 |
.IX Item "-mtext-section-literals" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10108 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10109 |
.Ip "\fB\-mno-text-section-literals\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10110 |
.IX Item "-mno-text-section-literals" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10111 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10112 |
Control the treatment of literal pools. The default is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10113 |
\&\fB\-mno-text-section-literals\fR, which places literals in a separate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10114 |
section in the output file. This allows the literal pool to be placed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10115 |
in a data \s-1RAM/ROM\s0, and it also allows the linker to combine literal |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10116 |
pools from separate object files to remove redundant literals and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10117 |
improve code size. With \fB\-mtext-section-literals\fR, the literals |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10118 |
are interspersed in the text section in order to keep them as close as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10119 |
possible to their references. This may be necessary for large assembly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10120 |
files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10121 |
.Ip "\fB\-mtarget-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10122 |
.IX Item "-mtarget-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10123 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10124 |
.Ip "\fB\-mno-target-align\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10125 |
.IX Item "-mno-target-align" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10126 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10127 |
When this option is enabled, \s-1GCC\s0 instructs the assembler to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10128 |
automatically align instructions to reduce branch penalties at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10129 |
expense of some code density. The assembler attempts to widen density |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10130 |
instructions to align branch targets and the instructions following call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10131 |
instructions. If there are not enough preceding safe density |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10132 |
instructions to align a target, no widening will be performed. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10133 |
default is \fB\-mtarget-align\fR. These options do not affect the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10134 |
treatment of auto-aligned instructions like \f(CW\*(C`LOOP\*(C'\fR, which the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10135 |
assembler will always align, either by widening density instructions or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10136 |
by inserting no-op instructions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10137 |
.Ip "\fB\-mlongcalls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10138 |
.IX Item "-mlongcalls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10139 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10140 |
.Ip "\fB\-mno-longcalls\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10141 |
.IX Item "-mno-longcalls" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10142 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10143 |
When this option is enabled, \s-1GCC\s0 instructs the assembler to translate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10144 |
direct calls to indirect calls unless it can determine that the target |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10145 |
of a direct call is in the range allowed by the call instruction. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10146 |
translation typically occurs for calls to functions in other source |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10147 |
files. Specifically, the assembler translates a direct \f(CW\*(C`CALL\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10148 |
instruction into an \f(CW\*(C`L32R\*(C'\fR followed by a \f(CW\*(C`CALLX\*(C'\fR instruction. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10149 |
The default is \fB\-mno-longcalls\fR. This option should be used in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10150 |
programs where the call target can potentially be out of range. This |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10151 |
option is implemented in the assembler, not the compiler, so the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10152 |
assembly code generated by \s-1GCC\s0 will still show direct call |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10153 |
instructions\-\-\-look at the disassembled object code to see the actual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10154 |
instructions. Note that the assembler will use an indirect call for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10155 |
every cross-file call, not just those that really will be out of range. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10156 |
.Sh "Options for Code Generation Conventions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10157 |
.IX Subsection "Options for Code Generation Conventions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10158 |
These machine-independent options control the interface conventions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10159 |
used in code generation. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10160 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10161 |
Most of them have both positive and negative forms; the negative form |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10162 |
of \fB\-ffoo\fR would be \fB\-fno-foo\fR. In the table below, only |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10163 |
one of the forms is listed\-\-\-the one which is not the default. You |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10164 |
can figure out the other form by either removing \fBno-\fR or adding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10165 |
it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10166 |
.Ip "\fB\-fbounds-check\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10167 |
.IX Item "-fbounds-check" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10168 |
For front-ends that support it, generate additional code to check that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10169 |
indices used to access arrays are within the declared range. This is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10170 |
currently only supported by the Java and Fortran 77 front-ends, where |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10171 |
this option defaults to true and false respectively. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10172 |
.Ip "\fB\-ftrapv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10173 |
.IX Item "-ftrapv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10174 |
This option generates traps for signed overflow on addition, subtraction, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10175 |
multiplication operations. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10176 |
.Ip "\fB\-fwrapv\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10177 |
.IX Item "-fwrapv" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10178 |
This option instructs the compiler to assume that signed arithmetic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10179 |
overflow of addition, subtraction and multiplication wraps around |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10180 |
using twos-complement representation. This flag enables some optimizations |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10181 |
and disables other. This option is enabled by default for the Java |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10182 |
front-end, as required by the Java language specification. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10183 |
.Ip "\fB\-fexceptions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10184 |
.IX Item "-fexceptions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10185 |
Enable exception handling. Generates extra code needed to propagate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10186 |
exceptions. For some targets, this implies \s-1GCC\s0 will generate frame |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10187 |
unwind information for all functions, which can produce significant data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10188 |
size overhead, although it does not affect execution. If you do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10189 |
specify this option, \s-1GCC\s0 will enable it by default for languages like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10190 |
\&\*(C+ which normally require exception handling, and disable it for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10191 |
languages like C that do not normally require it. However, you may need |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10192 |
to enable this option when compiling C code that needs to interoperate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10193 |
properly with exception handlers written in \*(C+. You may also wish to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10194 |
disable this option if you are compiling older \*(C+ programs that don't |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10195 |
use exception handling. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10196 |
.Ip "\fB\-fnon-call-exceptions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10197 |
.IX Item "-fnon-call-exceptions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10198 |
Generate code that allows trapping instructions to throw exceptions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10199 |
Note that this requires platform-specific runtime support that does |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10200 |
not exist everywhere. Moreover, it only allows \fItrapping\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10201 |
instructions to throw exceptions, i.e. memory references or floating |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10202 |
point instructions. It does not allow exceptions to be thrown from |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10203 |
arbitrary signal handlers such as \f(CW\*(C`SIGALRM\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10204 |
.Ip "\fB\-funwind-tables\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10205 |
.IX Item "-funwind-tables" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10206 |
Similar to \fB\-fexceptions\fR, except that it will just generate any needed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10207 |
static data, but will not affect the generated code in any other way. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10208 |
You will normally not enable this option; instead, a language processor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10209 |
that needs this handling would enable it on your behalf. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10210 |
.Ip "\fB\-fasynchronous-unwind-tables\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10211 |
.IX Item "-fasynchronous-unwind-tables" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10212 |
Generate unwind table in dwarf2 format, if supported by target machine. The |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10213 |
table is exact at each instruction boundary, so it can be used for stack |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10214 |
unwinding from asynchronous events (such as debugger or garbage collector). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10215 |
.Ip "\fB\-fpcc-struct-return\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10216 |
.IX Item "-fpcc-struct-return" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10217 |
Return ``short'' \f(CW\*(C`struct\*(C'\fR and \f(CW\*(C`union\*(C'\fR values in memory like |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10218 |
longer ones, rather than in registers. This convention is less |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10219 |
efficient, but it has the advantage of allowing intercallability between |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10220 |
GCC-compiled files and files compiled with other compilers, particularly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10221 |
the Portable C Compiler (pcc). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10222 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10223 |
The precise convention for returning structures in memory depends |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10224 |
on the target configuration macros. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10225 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10226 |
Short structures and unions are those whose size and alignment match |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10227 |
that of some integer type. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10228 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10229 |
\&\fBWarning:\fR code compiled with the \fB\-fpcc-struct-return\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10230 |
switch is not binary compatible with code compiled with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10231 |
\&\fB\-freg-struct-return\fR switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10232 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10233 |
.Ip "\fB\-freg-struct-return\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10234 |
.IX Item "-freg-struct-return" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10235 |
Return \f(CW\*(C`struct\*(C'\fR and \f(CW\*(C`union\*(C'\fR values in registers when possible. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10236 |
This is more efficient for small structures than |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10237 |
\&\fB\-fpcc-struct-return\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10238 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10239 |
If you specify neither \fB\-fpcc-struct-return\fR nor |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10240 |
\&\fB\-freg-struct-return\fR, \s-1GCC\s0 defaults to whichever convention is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10241 |
standard for the target. If there is no standard convention, \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10242 |
defaults to \fB\-fpcc-struct-return\fR, except on targets where \s-1GCC\s0 is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10243 |
the principal compiler. In those cases, we can choose the standard, and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10244 |
we chose the more efficient register return alternative. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10245 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10246 |
\&\fBWarning:\fR code compiled with the \fB\-freg-struct-return\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10247 |
switch is not binary compatible with code compiled with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10248 |
\&\fB\-fpcc-struct-return\fR switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10249 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10250 |
.Ip "\fB\-fshort-enums\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10251 |
.IX Item "-fshort-enums" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10252 |
Allocate to an \f(CW\*(C`enum\*(C'\fR type only as many bytes as it needs for the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10253 |
declared range of possible values. Specifically, the \f(CW\*(C`enum\*(C'\fR type |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10254 |
will be equivalent to the smallest integer type which has enough room. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10255 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10256 |
\&\fBWarning:\fR the \fB\-fshort-enums\fR switch causes \s-1GCC\s0 to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10257 |
code that is not binary compatible with code generated without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10258 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10259 |
.Ip "\fB\-fshort-double\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10260 |
.IX Item "-fshort-double" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10261 |
Use the same size for \f(CW\*(C`double\*(C'\fR as for \f(CW\*(C`float\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10262 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10263 |
\&\fBWarning:\fR the \fB\-fshort-double\fR switch causes \s-1GCC\s0 to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10264 |
code that is not binary compatible with code generated without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10265 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10266 |
.Ip "\fB\-fshort-wchar\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10267 |
.IX Item "-fshort-wchar" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10268 |
Override the underlying type for \fBwchar_t\fR to be \fBshort |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10269 |
unsigned int\fR instead of the default for the target. This option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10270 |
useful for building programs to run under \s-1WINE\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10271 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10272 |
\&\fBWarning:\fR the \fB\-fshort-wchar\fR switch causes \s-1GCC\s0 to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10273 |
code that is not binary compatible with code generated without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10274 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10275 |
.Ip "\fB\-fshared-data\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10276 |
.IX Item "-fshared-data" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10277 |
Requests that the data and non-\f(CW\*(C`const\*(C'\fR variables of this |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10278 |
compilation be shared data rather than private data. The distinction |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10279 |
makes sense only on certain operating systems, where shared data is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10280 |
shared between processes running the same program, while private data |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10281 |
exists in one copy per process. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10282 |
.Ip "\fB\-fno-common\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10283 |
.IX Item "-fno-common" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10284 |
In C, allocate even uninitialized global variables in the data section of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10285 |
object file, rather than generating them as common blocks. This has the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10286 |
effect that if the same variable is declared (without \f(CW\*(C`extern\*(C'\fR) in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10287 |
two different compilations, you will get an error when you link them. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10288 |
The only reason this might be useful is if you wish to verify that the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10289 |
program will work on other systems which always work this way. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10290 |
.Ip "\fB\-fno-ident\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10291 |
.IX Item "-fno-ident" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10292 |
Ignore the \fB#ident\fR directive. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10293 |
.Ip "\fB\-finhibit-size-directive\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10294 |
.IX Item "-finhibit-size-directive" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10295 |
Don't output a \f(CW\*(C`.size\*(C'\fR assembler directive, or anything else that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10296 |
would cause trouble if the function is split in the middle, and the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10297 |
two halves are placed at locations far apart in memory. This option is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10298 |
used when compiling \fIcrtstuff.c\fR; you should not need to use it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10299 |
for anything else. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10300 |
.Ip "\fB\-fverbose-asm\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10301 |
.IX Item "-fverbose-asm" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10302 |
Put extra commentary information in the generated assembly code to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10303 |
make it more readable. This option is generally only of use to those |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10304 |
who actually need to read the generated assembly code (perhaps while |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10305 |
debugging the compiler itself). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10306 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10307 |
\&\fB\-fno-verbose-asm\fR, the default, causes the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10308 |
extra information to be omitted and is useful when comparing two assembler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10309 |
files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10310 |
.Ip "\fB\-fpic\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10311 |
.IX Item "-fpic" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10312 |
Generate position-independent code (\s-1PIC\s0) suitable for use in a shared |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10313 |
library, if supported for the target machine. Such code accesses all |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10314 |
constant addresses through a global offset table (\s-1GOT\s0). The dynamic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10315 |
loader resolves the \s-1GOT\s0 entries when the program starts (the dynamic |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10316 |
loader is not part of \s-1GCC\s0; it is part of the operating system). If |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10317 |
the \s-1GOT\s0 size for the linked executable exceeds a machine-specific |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10318 |
maximum size, you get an error message from the linker indicating that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10319 |
\&\fB\-fpic\fR does not work; in that case, recompile with \fB\-fPIC\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10320 |
instead. (These maximums are 8k on the \s-1SPARC\s0 and 32k |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10321 |
on the m68k and \s-1RS/6000\s0. The 386 has no such limit.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10322 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10323 |
Position-independent code requires special support, and therefore works |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10324 |
only on certain machines. For the 386, \s-1GCC\s0 supports \s-1PIC\s0 for System V |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10325 |
but not for the Sun 386i. Code generated for the \s-1IBM\s0 \s-1RS/6000\s0 is always |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10326 |
position-independent. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10327 |
.Ip "\fB\-fPIC\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10328 |
.IX Item "-fPIC" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10329 |
If supported for the target machine, emit position-independent code, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10330 |
suitable for dynamic linking and avoiding any limit on the size of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10331 |
global offset table. This option makes a difference on the m68k |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10332 |
and the \s-1SPARC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10333 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10334 |
Position-independent code requires special support, and therefore works |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10335 |
only on certain machines. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10336 |
.Ip "\fB\-fpie\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10337 |
.IX Item "-fpie" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10338 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10339 |
.Ip "\fB\-fPIE\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10340 |
.IX Item "-fPIE" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10341 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10342 |
These options are similar to \fB\-fpic\fR and \fB\-fPIC\fR, but |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10343 |
generated position independent code can be only linked into executables. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10344 |
Usually these options are used when \fB\-pie\fR \s-1GCC\s0 option will be |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10345 |
used during linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10346 |
.Ip "\fB\-ffixed-\fR\fIreg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10347 |
.IX Item "-ffixed-reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10348 |
Treat the register named \fIreg\fR as a fixed register; generated code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10349 |
should never refer to it (except perhaps as a stack pointer, frame |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10350 |
pointer or in some other fixed role). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10351 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10352 |
\&\fIreg\fR must be the name of a register. The register names accepted |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10353 |
are machine-specific and are defined in the \f(CW\*(C`REGISTER_NAMES\*(C'\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10354 |
macro in the machine description macro file. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10355 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10356 |
This flag does not have a negative form, because it specifies a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10357 |
three-way choice. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10358 |
.Ip "\fB\-fcall-used-\fR\fIreg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10359 |
.IX Item "-fcall-used-reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10360 |
Treat the register named \fIreg\fR as an allocable register that is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10361 |
clobbered by function calls. It may be allocated for temporaries or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10362 |
variables that do not live across a call. Functions compiled this way |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10363 |
will not save and restore the register \fIreg\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10364 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10365 |
It is an error to used this flag with the frame pointer or stack pointer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10366 |
Use of this flag for other registers that have fixed pervasive roles in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10367 |
the machine's execution model will produce disastrous results. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10368 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10369 |
This flag does not have a negative form, because it specifies a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10370 |
three-way choice. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10371 |
.Ip "\fB\-fcall-saved-\fR\fIreg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10372 |
.IX Item "-fcall-saved-reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10373 |
Treat the register named \fIreg\fR as an allocable register saved by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10374 |
functions. It may be allocated even for temporaries or variables that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10375 |
live across a call. Functions compiled this way will save and restore |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10376 |
the register \fIreg\fR if they use it. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10377 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10378 |
It is an error to used this flag with the frame pointer or stack pointer. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10379 |
Use of this flag for other registers that have fixed pervasive roles in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10380 |
the machine's execution model will produce disastrous results. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10381 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10382 |
A different sort of disaster will result from the use of this flag for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10383 |
a register in which function values may be returned. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10384 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10385 |
This flag does not have a negative form, because it specifies a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10386 |
three-way choice. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10387 |
.Ip "\fB\-fpack-struct\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10388 |
.IX Item "-fpack-struct" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10389 |
Pack all structure members together without holes. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10390 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10391 |
\&\fBWarning:\fR the \fB\-fpack-struct\fR switch causes \s-1GCC\s0 to generate |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10392 |
code that is not binary compatible with code generated without that switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10393 |
Additionally, it makes the code suboptimal. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10394 |
Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10395 |
.Ip "\fB\-finstrument-functions\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10396 |
.IX Item "-finstrument-functions" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10397 |
Generate instrumentation calls for entry and exit to functions. Just |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10398 |
after function entry and just before function exit, the following |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10399 |
profiling functions will be called with the address of the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10400 |
function and its call site. (On some platforms, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10401 |
\&\f(CW\*(C`_\|_builtin_return_address\*(C'\fR does not work beyond the current |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10402 |
function, so the call site information may not be available to the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10403 |
profiling functions otherwise.) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10404 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10405 |
.Vb 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10406 |
\& void __cyg_profile_func_enter (void *this_fn, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10407 |
\& void *call_site); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10408 |
\& void __cyg_profile_func_exit (void *this_fn, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10409 |
\& void *call_site); |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10410 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10411 |
The first argument is the address of the start of the current function, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10412 |
which may be looked up exactly in the symbol table. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10413 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10414 |
This currently disables function inlining. This restriction is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10415 |
expected to be removed in future releases. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10416 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10417 |
A function may be given the attribute \f(CW\*(C`no_instrument_function\*(C'\fR, in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10418 |
which case this instrumentation will not be done. This can be used, for |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10419 |
example, for the profiling functions listed above, high-priority |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10420 |
interrupt routines, and any functions from which the profiling functions |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10421 |
cannot safely be called (perhaps signal handlers, if the profiling |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10422 |
routines generate output or allocate memory). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10423 |
.Ip "\fB\-fstack-check\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10424 |
.IX Item "-fstack-check" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10425 |
Generate code to verify that you do not go beyond the boundary of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10426 |
stack. You should specify this flag if you are running in an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10427 |
environment with multiple threads, but only rarely need to specify it in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10428 |
a single-threaded environment since stack overflow is automatically |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10429 |
detected on nearly all systems if there is only one stack. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10430 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10431 |
Note that this switch does not actually cause checking to be done; the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10432 |
operating system must do that. The switch causes generation of code |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10433 |
to ensure that the operating system sees the stack being extended. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10434 |
.Ip "\fB\-fstack-limit-register=\fR\fIreg\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10435 |
.IX Item "-fstack-limit-register=reg" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10436 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10437 |
.Ip "\fB\-fstack-limit-symbol=\fR\fIsym\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10438 |
.IX Item "-fstack-limit-symbol=sym" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10439 |
.Ip "\fB\-fno-stack-limit\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10440 |
.IX Item "-fno-stack-limit" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10441 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10442 |
Generate code to ensure that the stack does not grow beyond a certain value, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10443 |
either the value of a register or the address of a symbol. If the stack |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10444 |
would grow beyond the value, a signal is raised. For most targets, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10445 |
the signal is raised before the stack overruns the boundary, so |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10446 |
it is possible to catch the signal without taking special precautions. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10447 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10448 |
For instance, if the stack starts at absolute address \fB0x80000000\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10449 |
and grows downwards, you can use the flags |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10450 |
\&\fB\-fstack-limit-symbol=_\|_stack_limit\fR and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10451 |
\&\fB\-Wl,\-\-defsym,_\|_stack_limit=0x7ffe0000\fR to enforce a stack limit |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10452 |
of 128KB. Note that this may only work with the \s-1GNU\s0 linker. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10453 |
.Ip "\fB\-fargument-alias\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10454 |
.IX Item "-fargument-alias" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10455 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10456 |
.Ip "\fB\-fargument-noalias\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10457 |
.IX Item "-fargument-noalias" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10458 |
.Ip "\fB\-fargument-noalias-global\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10459 |
.IX Item "-fargument-noalias-global" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10460 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10461 |
Specify the possible relationships among parameters and between |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10462 |
parameters and global data. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10463 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10464 |
\&\fB\-fargument-alias\fR specifies that arguments (parameters) may |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10465 |
alias each other and may alias global storage.\fB\-fargument-noalias\fR specifies that arguments do not alias |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10466 |
each other, but may alias global storage.\fB\-fargument-noalias-global\fR specifies that arguments do not |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10467 |
alias each other and do not alias global storage. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10468 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10469 |
Each language will automatically use whatever option is required by |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10470 |
the language standard. You should not need to use these options yourself. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10471 |
.Ip "\fB\-fleading-underscore\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10472 |
.IX Item "-fleading-underscore" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10473 |
This option and its counterpart, \fB\-fno-leading-underscore\fR, forcibly |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10474 |
change the way C symbols are represented in the object file. One use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10475 |
is to help link with legacy assembly code. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10476 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10477 |
\&\fBWarning:\fR the \fB\-fleading-underscore\fR switch causes \s-1GCC\s0 to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10478 |
generate code that is not binary compatible with code generated without that |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10479 |
switch. Use it to conform to a non-default application binary interface. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10480 |
Not all targets provide complete support for this switch. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10481 |
.Ip "\fB\-ftls-model=\fR\fImodel\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10482 |
.IX Item "-ftls-model=model" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10483 |
Alter the thread-local storage model to be used. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10484 |
The \fImodel\fR argument should be one of \f(CW\*(C`global\-dynamic\*(C'\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10485 |
\&\f(CW\*(C`local\-dynamic\*(C'\fR, \f(CW\*(C`initial\-exec\*(C'\fR or \f(CW\*(C`local\-exec\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10486 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10487 |
The default without \fB\-fpic\fR is \f(CW\*(C`initial\-exec\*(C'\fR; with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10488 |
\&\fB\-fpic\fR the default is \f(CW\*(C`global\-dynamic\*(C'\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10489 |
.SH "ENVIRONMENT" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10490 |
.IX Header "ENVIRONMENT" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10491 |
This section describes several environment variables that affect how \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10492 |
operates. Some of them work by specifying directories or prefixes to use |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10493 |
when searching for various kinds of files. Some are used to specify other |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10494 |
aspects of the compilation environment. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10495 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10496 |
Note that you can also specify places to search using options such as |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10497 |
\&\fB\-B\fR, \fB\-I\fR and \fB\-L\fR. These |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10498 |
take precedence over places specified using environment variables, which |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10499 |
in turn take precedence over those specified by the configuration of \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10500 |
.Ip "\fB\s-1LANG\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10501 |
.IX Item "LANG" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10502 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10503 |
.Ip "\fB\s-1LC_CTYPE\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10504 |
.IX Item "LC_CTYPE" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10505 |
.Ip "\fB\s-1LC_MESSAGES\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10506 |
.IX Item "LC_MESSAGES" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10507 |
.Ip "\fB\s-1LC_ALL\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10508 |
.IX Item "LC_ALL" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10509 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10510 |
These environment variables control the way that \s-1GCC\s0 uses |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10511 |
localization information that allow \s-1GCC\s0 to work with different |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10512 |
national conventions. \s-1GCC\s0 inspects the locale categories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10513 |
\&\fB\s-1LC_CTYPE\s0\fR and \fB\s-1LC_MESSAGES\s0\fR if it has been configured to do |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10514 |
so. These locale categories can be set to any value supported by your |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10515 |
installation. A typical value is \fBen_GB.UTF-8\fR for English in the United |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10516 |
Kingdom encoded in \s-1UTF-8\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10517 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10518 |
The \fB\s-1LC_CTYPE\s0\fR environment variable specifies character |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10519 |
classification. \s-1GCC\s0 uses it to determine the character boundaries in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10520 |
a string; this is needed for some multibyte encodings that contain quote |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10521 |
and escape characters that would otherwise be interpreted as a string |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10522 |
end or escape. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10523 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10524 |
The \fB\s-1LC_MESSAGES\s0\fR environment variable specifies the language to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10525 |
use in diagnostic messages. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10526 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10527 |
If the \fB\s-1LC_ALL\s0\fR environment variable is set, it overrides the value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10528 |
of \fB\s-1LC_CTYPE\s0\fR and \fB\s-1LC_MESSAGES\s0\fR; otherwise, \fB\s-1LC_CTYPE\s0\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10529 |
and \fB\s-1LC_MESSAGES\s0\fR default to the value of the \fB\s-1LANG\s0\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10530 |
environment variable. If none of these variables are set, \s-1GCC\s0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10531 |
defaults to traditional C English behavior. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10532 |
.Ip "\fB\s-1TMPDIR\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10533 |
.IX Item "TMPDIR" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10534 |
If \fB\s-1TMPDIR\s0\fR is set, it specifies the directory to use for temporary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10535 |
files. \s-1GCC\s0 uses temporary files to hold the output of one stage of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10536 |
compilation which is to be used as input to the next stage: for example, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10537 |
the output of the preprocessor, which is the input to the compiler |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10538 |
proper. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10539 |
.Ip "\fB\s-1GCC_EXEC_PREFIX\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10540 |
.IX Item "GCC_EXEC_PREFIX" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10541 |
If \fB\s-1GCC_EXEC_PREFIX\s0\fR is set, it specifies a prefix to use in the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10542 |
names of the subprograms executed by the compiler. No slash is added |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10543 |
when this prefix is combined with the name of a subprogram, but you can |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10544 |
specify a prefix that ends with a slash if you wish. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10545 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10546 |
If \fB\s-1GCC_EXEC_PREFIX\s0\fR is not set, \s-1GCC\s0 will attempt to figure out |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10547 |
an appropriate prefix to use based on the pathname it was invoked with. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10548 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10549 |
If \s-1GCC\s0 cannot find the subprogram using the specified prefix, it |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10550 |
tries looking in the usual places for the subprogram. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10551 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10552 |
The default value of \fB\s-1GCC_EXEC_PREFIX\s0\fR is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10553 |
\&\fI\fIprefix\fI/lib/gcc/\fR where \fIprefix\fR is the value |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10554 |
of \f(CW\*(C`prefix\*(C'\fR when you ran the \fIconfigure\fR script. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10555 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10556 |
Other prefixes specified with \fB\-B\fR take precedence over this prefix. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10557 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10558 |
This prefix is also used for finding files such as \fIcrt0.o\fR that are |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10559 |
used for linking. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10560 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10561 |
In addition, the prefix is used in an unusual way in finding the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10562 |
directories to search for header files. For each of the standard |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10563 |
directories whose name normally begins with \fB/usr/local/lib/gcc\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10564 |
(more precisely, with the value of \fB\s-1GCC_INCLUDE_DIR\s0\fR), \s-1GCC\s0 tries |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10565 |
replacing that beginning with the specified prefix to produce an |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10566 |
alternate directory name. Thus, with \fB\-Bfoo/\fR, \s-1GCC\s0 will search |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10567 |
\&\fIfoo/bar\fR where it would normally search \fI/usr/local/lib/bar\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10568 |
These alternate directories are searched first; the standard directories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10569 |
come next. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10570 |
.Ip "\fB\s-1COMPILER_PATH\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10571 |
.IX Item "COMPILER_PATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10572 |
The value of \fB\s-1COMPILER_PATH\s0\fR is a colon-separated list of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10573 |
directories, much like \fB\s-1PATH\s0\fR. \s-1GCC\s0 tries the directories thus |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10574 |
specified when searching for subprograms, if it can't find the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10575 |
subprograms using \fB\s-1GCC_EXEC_PREFIX\s0\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10576 |
.Ip "\fB\s-1LIBRARY_PATH\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10577 |
.IX Item "LIBRARY_PATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10578 |
The value of \fB\s-1LIBRARY_PATH\s0\fR is a colon-separated list of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10579 |
directories, much like \fB\s-1PATH\s0\fR. When configured as a native compiler, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10580 |
\&\s-1GCC\s0 tries the directories thus specified when searching for special |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10581 |
linker files, if it can't find them using \fB\s-1GCC_EXEC_PREFIX\s0\fR. Linking |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10582 |
using \s-1GCC\s0 also uses these directories when searching for ordinary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10583 |
libraries for the \fB\-l\fR option (but directories specified with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10584 |
\&\fB\-L\fR come first). |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10585 |
.Ip "\fB\s-1LANG\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10586 |
.IX Item "LANG" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10587 |
This variable is used to pass locale information to the compiler. One way in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10588 |
which this information is used is to determine the character set to be used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10589 |
when character literals, string literals and comments are parsed in C and \*(C+. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10590 |
When the compiler is configured to allow multibyte characters, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10591 |
the following values for \fB\s-1LANG\s0\fR are recognized: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10592 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10593 |
.Ip "\fBC-JIS\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10594 |
.IX Item "C-JIS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10595 |
Recognize \s-1JIS\s0 characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10596 |
.Ip "\fBC-SJIS\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10597 |
.IX Item "C-SJIS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10598 |
Recognize \s-1SJIS\s0 characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10599 |
.Ip "\fBC-EUCJP\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10600 |
.IX Item "C-EUCJP" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10601 |
Recognize \s-1EUCJP\s0 characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10602 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10603 |
.RS 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10604 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10605 |
If \fB\s-1LANG\s0\fR is not defined, or if it has some other value, then the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10606 |
compiler will use mblen and mbtowc as defined by the default locale to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10607 |
recognize and translate multibyte characters. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10608 |
.RE |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10609 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10610 |
Some additional environments variables affect the behavior of the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10611 |
preprocessor. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10612 |
.Ip "\fB\s-1CPATH\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10613 |
.IX Item "CPATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10614 |
.PD 0 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10615 |
.Ip "\fBC_INCLUDE_PATH\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10616 |
.IX Item "C_INCLUDE_PATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10617 |
.Ip "\fB\s-1CPLUS_INCLUDE_PATH\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10618 |
.IX Item "CPLUS_INCLUDE_PATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10619 |
.Ip "\fB\s-1OBJC_INCLUDE_PATH\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10620 |
.IX Item "OBJC_INCLUDE_PATH" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10621 |
.PD |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10622 |
Each variable's value is a list of directories separated by a special |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10623 |
character, much like \fB\s-1PATH\s0\fR, in which to look for header files. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10624 |
The special character, \f(CW\*(C`PATH_SEPARATOR\*(C'\fR, is target-dependent and |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10625 |
determined at \s-1GCC\s0 build time. For Microsoft Windows-based targets it is a |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10626 |
semicolon, and for almost all other targets it is a colon. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10627 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10628 |
\&\fB\s-1CPATH\s0\fR specifies a list of directories to be searched as if |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10629 |
specified with \fB\-I\fR, but after any paths given with \fB\-I\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10630 |
options on the command line. This environment variable is used |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10631 |
regardless of which language is being preprocessed. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10632 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10633 |
The remaining environment variables apply only when preprocessing the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10634 |
particular language indicated. Each specifies a list of directories |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10635 |
to be searched as if specified with \fB\-isystem\fR, but after any |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10636 |
paths given with \fB\-isystem\fR options on the command line. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10637 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10638 |
In all these variables, an empty element instructs the compiler to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10639 |
search its current working directory. Empty elements can appear at the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10640 |
beginning or end of a path. For instance, if the value of |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10641 |
\&\fB\s-1CPATH\s0\fR is \f(CW\*(C`:/special/include\*(C'\fR, that has the same |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10642 |
effect as \fB\-I.\ \-I/special/include\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10643 |
.Ip "\fB\s-1DEPENDENCIES_OUTPUT\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10644 |
.IX Item "DEPENDENCIES_OUTPUT" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10645 |
If this variable is set, its value specifies how to output |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10646 |
dependencies for Make based on the non-system header files processed |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10647 |
by the compiler. System header files are ignored in the dependency |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10648 |
output. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10649 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10650 |
The value of \fB\s-1DEPENDENCIES_OUTPUT\s0\fR can be just a file name, in |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10651 |
which case the Make rules are written to that file, guessing the target |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10652 |
name from the source file name. Or the value can have the form |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10653 |
\&\fIfile\fR\fB \fR\fItarget\fR, in which case the rules are written to |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10654 |
file \fIfile\fR using \fItarget\fR as the target name. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10655 |
.Sp |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10656 |
In other words, this environment variable is equivalent to combining |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10657 |
the options \fB\-MM\fR and \fB\-MF\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10658 |
with an optional \fB\-MT\fR switch too. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10659 |
.Ip "\fB\s-1SUNPRO_DEPENDENCIES\s0\fR" 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10660 |
.IX Item "SUNPRO_DEPENDENCIES" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10661 |
This variable is the same as \fB\s-1DEPENDENCIES_OUTPUT\s0\fR (see above), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10662 |
except that system header files are not ignored, so it implies |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10663 |
\&\fB\-M\fR rather than \fB\-MM\fR. However, the dependence on the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10664 |
main input file is omitted. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10665 |
.SH "BUGS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10666 |
.IX Header "BUGS" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10667 |
For instructions on reporting bugs, see |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10668 |
<\fBhttp://gcc.gnu.org/bugs.html\fR>. Use of the \fBgccbug\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10669 |
script to report bugs is recommended. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10670 |
.SH "FOOTNOTES" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10671 |
.IX Header "FOOTNOTES" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10672 |
.Ip "1." 4 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10673 |
On some systems, \fBgcc \-shared\fR |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10674 |
needs to build supplementary stub code for constructors to work. On |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10675 |
multi-libbed systems, \fBgcc \-shared\fR must select the correct support |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10676 |
libraries to link against. Failing to supply the correct flags may lead |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10677 |
to subtle defects. Supplying them in cases where they are not necessary |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10678 |
is innocuous. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10679 |
.SH "SEE ALSO" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10680 |
.IX Header "SEE ALSO" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10681 |
\&\fIgpl\fR\|(7), \fIgfdl\fR\|(7), \fIfsf-funding\fR\|(7), |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10682 |
\&\fIcpp\fR\|(1), \fIgcov\fR\|(1), \fIg77\fR\|(1), \fIas\fR\|(1), \fIld\fR\|(1), \fIgdb\fR\|(1), \fIadb\fR\|(1), \fIdbx\fR\|(1), \fIsdb\fR\|(1) |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10683 |
and the Info entries for \fIgcc\fR, \fIcpp\fR, \fIg77\fR, \fIas\fR, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10684 |
\&\fIld\fR, \fIbinutils\fR and \fIgdb\fR. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10685 |
.SH "AUTHOR" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10686 |
.IX Header "AUTHOR" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10687 |
See the Info entry for \fBgcc\fR, or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10688 |
<\fBhttp://gcc.gnu.org/onlinedocs/gcc/Contributors.html\fR>, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10689 |
for contributors to \s-1GCC\s0. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10690 |
.SH "COPYRIGHT" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10691 |
.IX Header "COPYRIGHT" |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10692 |
Copyright (c) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10693 |
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10694 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10695 |
Permission is granted to copy, distribute and/or modify this document |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10696 |
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2 or |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10697 |
any later version published by the Free Software Foundation; with the |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10698 |
Invariant Sections being ``\s-1GNU\s0 General Public License'' and ``Funding |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10699 |
Free Software'', the Front-Cover texts being (a) (see below), and with |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10700 |
the Back-Cover Texts being (b) (see below). A copy of the license is |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10701 |
included in the \fIgfdl\fR\|(7) man page. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10702 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10703 |
(a) The \s-1FSF\s0's Front-Cover Text is: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10704 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10705 |
.Vb 1 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10706 |
\& A GNU Manual |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10707 |
.Ve |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10708 |
(b) The \s-1FSF\s0's Back-Cover Text is: |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10709 |
.PP |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10710 |
.Vb 3 |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10711 |
\& You have freedom to copy and modify this GNU Manual, like GNU |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10712 |
\& software. Copies published by the Free Software Foundation raise |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10713 |
\& funds for GNU development. |
76b1f169d9fe
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
10714 |
.Ve |