summaryrefslogtreecommitdiff
path: root/share/doc/gccint/Add-Options.html
blob: d0afcfbabe212af449b6687a52c5dbf20152e6b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2023 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Funding Free Software", the Front-Cover
Texts being (a) (see below), and with the Back-Cover Texts being (b)
(see below).  A copy of the license is included in the section entitled
"GNU Free Documentation License".

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU
     software.  Copies published by the Free Software Foundation raise
     funds for GNU development. -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Compiler Collection (GCC) Internals: Add Options</title>

<meta name="description" content="GNU Compiler Collection (GCC) Internals: Add Options">
<meta name="keywords" content="GNU Compiler Collection (GCC) Internals: Add Options">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Test-Directives.html#Test-Directives" rel="up" title="Test Directives">
<link href="Require-Support.html#Require-Support" rel="next" title="Require Support">
<link href="Effective_002dTarget-Keywords.html#Effective_002dTarget-Keywords" rel="previous" title="Effective-Target Keywords">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Add-Options"></a>
<div class="header">
<p>
Next: <a href="Require-Support.html#Require-Support" accesskey="n" rel="next">Require Support</a>, Previous: <a href="Effective_002dTarget-Keywords.html#Effective_002dTarget-Keywords" accesskey="p" rel="previous">Effective-Target Keywords</a>, Up: <a href="Test-Directives.html#Test-Directives" accesskey="u" rel="up">Test Directives</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Features-for-dg_002dadd_002doptions"></a>
<h4 class="subsection">7.2.4 Features for <code>dg-add-options</code></h4>

<p>The supported values of <var>feature</var> for directive <code>dg-add-options</code>
are:
</p>
<dl compact="compact">
<dt><code>arm_fp</code></dt>
<dd><p><code>__ARM_FP</code> definition.  Only ARM targets support this feature, and only then
in certain modes; see the <a href="Effective_002dTarget-Keywords.html#arm_005ffp_005fok">arm_fp_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>arm_fp_dp</code></dt>
<dd><p><code>__ARM_FP</code> definition with double-precision support.  Only ARM
targets support this feature, and only then in certain modes; see the
<a href="Effective_002dTarget-Keywords.html#arm_005ffp_005fdp_005fok">arm_fp_dp_ok effective target keyword</a>.
</p>
</dd>
<dt><code>arm_neon</code></dt>
<dd><p>NEON support.  Only ARM targets support this feature, and only then
in certain modes; see the <a href="Effective_002dTarget-Keywords.html#arm_005fneon_005fok">arm_neon_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>arm_fp16</code></dt>
<dd><p>VFP half-precision floating point support.  This does not select the
FP16 format; for that, use <a href="#arm_005ffp16_005fieee">arm_fp16_ieee</a> or
<a href="#arm_005ffp16_005falternative">arm_fp16_alternative</a> instead.  This
feature is only supported by ARM targets and then only in certain
modes; see the <a href="Effective_002dTarget-Keywords.html#arm_005ffp16_005fok">arm_fp16_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>arm_fp16_ieee</code></dt>
<dd><a name="arm_005ffp16_005fieee"></a><p>ARM IEEE 754-2008 format VFP half-precision floating point support.
This feature is only supported by ARM targets and then only in certain
modes; see the <a href="Effective_002dTarget-Keywords.html#arm_005ffp16_005fok">arm_fp16_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>arm_fp16_alternative</code></dt>
<dd><a name="arm_005ffp16_005falternative"></a><p>ARM Alternative format VFP half-precision floating point support.
This feature is only supported by ARM targets and then only in certain
modes; see the <a href="Effective_002dTarget-Keywords.html#arm_005ffp16_005fok">arm_fp16_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>arm_neon_fp16</code></dt>
<dd><p>NEON and half-precision floating point support.  Only ARM targets
support this feature, and only then in certain modes; see
the <a href="Effective_002dTarget-Keywords.html#arm_005fneon_005ffp16_005fok">arm_neon_fp16_ok effective target keyword</a>.
</p>
</dd>
<dt><code>arm_vfp3</code></dt>
<dd><p>arm vfp3 floating point support; see
the <a href="Effective_002dTarget-Keywords.html#arm_005fvfp3_005fok">arm_vfp3_ok effective target keyword</a>.
</p>
</dd>
<dt><code>arm_arch_v8a_hard</code></dt>
<dd><p>Add options for ARMv8-A and the hard-float variant of the AAPCS,
if this is supported by the compiler; see the
<a href="Effective_002dTarget-Keywords.html#arm_005farch_005fv8a_005fhard_005fok">arm_arch_v8a_hard_ok</a> effective target keyword.
</p>
</dd>
<dt><code>arm_v8_1a_neon</code></dt>
<dd><p>Add options for ARMv8.1-A with Adv.SIMD support, if this is supported
by the target; see the <a href="Effective_002dTarget-Keywords.html#arm_005fv8_005f1a_005fneon_005fok">arm_v8_1a_neon_ok</a>
effective target keyword.
</p>
</dd>
<dt><code>arm_v8_2a_fp16_scalar</code></dt>
<dd><p>Add options for ARMv8.2-A with scalar FP16 support, if this is
supported by the target; see the
<a href="Effective_002dTarget-Keywords.html#arm_005fv8_005f2a_005ffp16_005fscalar_005fok">arm_v8_2a_fp16_scalar_ok</a> effective
target keyword.
</p>
</dd>
<dt><code>arm_v8_2a_fp16_neon</code></dt>
<dd><p>Add options for ARMv8.2-A with Adv.SIMD FP16 support, if this is
supported by the target; see the
<a href="Effective_002dTarget-Keywords.html#arm_005fv8_005f2a_005ffp16_005fneon_005fok">arm_v8_2a_fp16_neon_ok</a> effective target
keyword.
</p>
</dd>
<dt><code>arm_v8_2a_dotprod_neon</code></dt>
<dd><p>Add options for ARMv8.2-A with Adv.SIMD Dot Product support, if this is
supported by the target; see the
<a href="Effective_002dTarget-Keywords.html#arm_005fv8_005f2a_005fdotprod_005fneon_005fok">arm_v8_2a_dotprod_neon_ok</a> effective target keyword.
</p>
</dd>
<dt><code>arm_fp16fml_neon</code></dt>
<dd><p>Add options to enable generation of the <code>VFMAL</code> and <code>VFMSL</code>
instructions, if this is supported by the target; see the
<a href="Effective_002dTarget-Keywords.html#arm_005ffp16fml_005fneon_005fok">arm_fp16fml_neon_ok</a> effective target keyword.
</p>
</dd>
<dt><code>arm_dsp</code></dt>
<dd><p>Add options for ARM DSP intrinsics support, if this is supported by
the target; see the <a href="Effective_002dTarget-Keywords.html#arm_005fdsp_005fok">arm_dsp_ok effective target
keyword</a>.
</p>
</dd>
<dt><code>bind_pic_locally</code></dt>
<dd><p>Add the target-specific flags needed to enable functions to bind
locally when using pic/PIC passes in the testsuite.
</p>
</dd>
<dt><code>float<var>n</var></code></dt>
<dd><p>Add the target-specific flags needed to use the <code>_Float<var>n</var></code> type.
</p>
</dd>
<dt><code>float<var>n</var>x</code></dt>
<dd><p>Add the target-specific flags needed to use the <code>_Float<var>n</var>x</code> type.
</p>
</dd>
<dt><code>ieee</code></dt>
<dd><p>Add the target-specific flags needed to enable full IEEE
compliance mode.
</p>
</dd>
<dt><code>mips16_attribute</code></dt>
<dd><p><code>mips16</code> function attributes.
Only MIPS targets support this feature, and only then in certain modes.
</p>
</dd>
<dt><code>stack_size</code></dt>
<dd><a name="stack_005fsize_005fao"></a><p>Add the flags needed to define macro STACK_SIZE and set it to the stack size
limit associated with the <a href="Effective_002dTarget-Keywords.html#stack_005fsize_005fet"><code>stack_size</code> effective
target</a>.
</p>
</dd>
<dt><code>sqrt_insn</code></dt>
<dd><p>Add the target-specific flags needed to enable hardware square root
instructions, if any.
</p>
</dd>
<dt><code>tls</code></dt>
<dd><p>Add the target-specific flags needed to use thread-local storage.
</p>
</dd>
<dt><code>weak_undefined</code></dt>
<dd><p>Add the flags needed to enable support for weak undefined symbols.
</p></dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="Require-Support.html#Require-Support" accesskey="n" rel="next">Require Support</a>, Previous: <a href="Effective_002dTarget-Keywords.html#Effective_002dTarget-Keywords" accesskey="p" rel="previous">Effective-Target Keywords</a>, Up: <a href="Test-Directives.html#Test-Directives" accesskey="u" rel="up">Test Directives</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>