gcc/ChangeLog:
[official-gcc.git] / gcc / config / mips / mips.opt
blobced243218e34377b00e90b53a58109286e132858
1 ; Options for the MIPS port of the compiler
3 ; Copyright (C) 2005-2017 Free Software Foundation, Inc.
5 ; This file is part of GCC.
7 ; GCC is free software; you can redistribute it and/or modify it under
8 ; the terms of the GNU General Public License as published by the Free
9 ; Software Foundation; either version 3, or (at your option) any later
10 ; version.
12 ; GCC is distributed in the hope that it will be useful, but WITHOUT
13 ; ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
14 ; or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
15 ; License for more details.
17 ; You should have received a copy of the GNU General Public License
18 ; along with GCC; see the file COPYING3.  If not see
19 ; <http://www.gnu.org/licenses/>.
21 HeaderInclude
22 config/mips/mips-opts.h
25 Driver
28 Driver
30 mabi=
31 Target RejectNegative Joined Enum(mips_abi) Var(mips_abi) Init(MIPS_ABI_DEFAULT)
32 -mabi=ABI       Generate code that conforms to the given ABI.
34 Enum
35 Name(mips_abi) Type(int)
36 Known MIPS ABIs (for use with the -mabi= option):
38 EnumValue
39 Enum(mips_abi) String(32) Value(ABI_32)
41 EnumValue
42 Enum(mips_abi) String(o64) Value(ABI_O64)
44 EnumValue
45 Enum(mips_abi) String(n32) Value(ABI_N32)
47 EnumValue
48 Enum(mips_abi) String(64) Value(ABI_64)
50 EnumValue
51 Enum(mips_abi) String(eabi) Value(ABI_EABI)
53 mabicalls
54 Target Report Mask(ABICALLS)
55 Generate code that can be used in SVR4-style dynamic objects.
57 mmad
58 Target Report Var(TARGET_MAD)
59 Use PMC-style 'mad' instructions.
61 mimadd
62 Target Report Mask(IMADD)
63 Use integer madd/msub instructions.
65 march=
66 Target RejectNegative Joined Var(mips_arch_option) ToLower Enum(mips_arch_opt_value)
67 -march=ISA      Generate code for the given ISA.
69 mbranch-cost=
70 Target RejectNegative Joined UInteger Var(mips_branch_cost)
71 -mbranch-cost=COST      Set the cost of branches to roughly COST instructions.
73 mbranch-likely
74 Target Report Mask(BRANCHLIKELY)
75 Use Branch Likely instructions, overriding the architecture default.
77 mflip-mips16
78 Target Report Var(TARGET_FLIP_MIPS16)
79 Switch on/off MIPS16 ASE on alternating functions for compiler testing.
81 mcheck-zero-division
82 Target Report Mask(CHECK_ZERO_DIV)
83 Trap on integer divide by zero.
85 mcode-readable=
86 Target RejectNegative Joined Enum(mips_code_readable_setting) Var(mips_code_readable) Init(CODE_READABLE_YES)
87 -mcode-readable=SETTING Specify when instructions are allowed to access code.
89 Enum
90 Name(mips_code_readable_setting) Type(enum mips_code_readable_setting)
91 Valid arguments to -mcode-readable=:
93 EnumValue
94 Enum(mips_code_readable_setting) String(yes) Value(CODE_READABLE_YES)
96 EnumValue
97 Enum(mips_code_readable_setting) String(pcrel) Value(CODE_READABLE_PCREL)
99 EnumValue
100 Enum(mips_code_readable_setting) String(no) Value(CODE_READABLE_NO)
102 mdivide-breaks
103 Target Report RejectNegative Mask(DIVIDE_BREAKS)
104 Use branch-and-break sequences to check for integer divide by zero.
106 mdivide-traps
107 Target Report RejectNegative InverseMask(DIVIDE_BREAKS, DIVIDE_TRAPS)
108 Use trap instructions to check for integer divide by zero.
110 mdmx
111 Target Report RejectNegative Var(TARGET_MDMX)
112 Allow the use of MDMX instructions.
114 mdouble-float
115 Target Report RejectNegative InverseMask(SINGLE_FLOAT, DOUBLE_FLOAT)
116 Allow hardware floating-point instructions to cover both 32-bit and 64-bit operations.
118 mdsp
119 Target Report Var(TARGET_DSP)
120 Use MIPS-DSP instructions.
122 mdspr2
123 Target Report Var(TARGET_DSPR2)
124 Use MIPS-DSP REV 2 instructions.
126 mdebug
127 Target Var(TARGET_DEBUG_MODE) Undocumented
129 mdebugd
130 Target Var(TARGET_DEBUG_D_MODE) Undocumented
133 Target Report RejectNegative Mask(BIG_ENDIAN)
134 Use big-endian byte order.
137 Target Report RejectNegative InverseMask(BIG_ENDIAN, LITTLE_ENDIAN)
138 Use little-endian byte order.
140 membedded-data
141 Target Report Var(TARGET_EMBEDDED_DATA)
142 Use ROM instead of RAM.
144 meva
145 Target Report Var(TARGET_EVA)
146 Use Enhanced Virtual Addressing instructions.
148 mexplicit-relocs
149 Target Report Mask(EXPLICIT_RELOCS)
150 Use NewABI-style %reloc() assembly operators.
152 mextern-sdata
153 Target Report Var(TARGET_EXTERN_SDATA) Init(1)
154 Use -G for data that is not defined by the current object.
156 mfix-24k
157 Target Report Var(TARGET_FIX_24K)
158 Work around certain 24K errata.
160 mfix-r4000
161 Target Report Mask(FIX_R4000)
162 Work around certain R4000 errata.
164 mfix-r4400
165 Target Report Mask(FIX_R4400)
166 Work around certain R4400 errata.
168 mfix-rm7000
169 Target Report Var(TARGET_FIX_RM7000)
170 Work around certain RM7000 errata.
172 mfix-r10000
173 Target Report Mask(FIX_R10000)
174 Work around certain R10000 errata.
176 mfix-sb1
177 Target Report Var(TARGET_FIX_SB1)
178 Work around errata for early SB-1 revision 2 cores.
180 mfix-vr4120
181 Target Report Var(TARGET_FIX_VR4120)
182 Work around certain VR4120 errata.
184 mfix-vr4130
185 Target Report Var(TARGET_FIX_VR4130)
186 Work around VR4130 mflo/mfhi errata.
188 mfix4300
189 Target Report Var(TARGET_4300_MUL_FIX)
190 Work around an early 4300 hardware bug.
192 mfp-exceptions
193 Target Report Var(TARGET_FP_EXCEPTIONS) Init(1)
194 FP exceptions are enabled.
196 mfp32
197 Target Report RejectNegative InverseMask(FLOAT64)
198 Use 32-bit floating-point registers.
200 mfpxx
201 Target Report RejectNegative Mask(FLOATXX)
202 Conform to the o32 FPXX ABI.
204 mfp64
205 Target Report RejectNegative Mask(FLOAT64)
206 Use 64-bit floating-point registers.
208 mflush-func=
209 Target RejectNegative Joined Var(mips_cache_flush_func) Init(CACHE_FLUSH_FUNC)
210 -mflush-func=FUNC       Use FUNC to flush the cache before calling stack trampolines.
212 mabs=
213 Target RejectNegative Joined Enum(mips_ieee_754_value) Var(mips_abs) Init(MIPS_IEEE_754_DEFAULT)
214 -mabs=MODE      Select the IEEE 754 ABS/NEG instruction execution mode.
216 mnan=
217 Target RejectNegative Joined Enum(mips_ieee_754_value) Var(mips_nan) Init(MIPS_IEEE_754_DEFAULT)
218 -mnan=ENCODING  Select the IEEE 754 NaN data encoding.
220 Enum
221 Name(mips_ieee_754_value) Type(int)
222 Known MIPS IEEE 754 settings (for use with the -mabs= and -mnan= options):
224 EnumValue
225 Enum(mips_ieee_754_value) String(2008) Value(MIPS_IEEE_754_2008)
227 EnumValue
228 Enum(mips_ieee_754_value) String(legacy) Value(MIPS_IEEE_754_LEGACY)
230 mgp32
231 Target Report RejectNegative InverseMask(64BIT)
232 Use 32-bit general registers.
234 mgp64
235 Target Report RejectNegative Mask(64BIT)
236 Use 64-bit general registers.
238 mgpopt
239 Target Report Var(TARGET_GPOPT) Init(1)
240 Use GP-relative addressing to access small data.
242 mplt
243 Target Report Var(TARGET_PLT)
244 When generating -mabicalls code, allow executables to use PLTs and copy relocations.
246 mhard-float
247 Target Report RejectNegative InverseMask(SOFT_FLOAT_ABI, HARD_FLOAT_ABI)
248 Allow the use of hardware floating-point ABI and instructions.
250 minterlink-compressed
251 Target Report Var(TARGET_INTERLINK_COMPRESSED) Init(0)
252 Generate code that is link-compatible with MIPS16 and microMIPS code.
254 minterlink-mips16
255 Target Report Var(TARGET_INTERLINK_COMPRESSED) Init(0)
256 An alias for minterlink-compressed provided for backward-compatibility.
258 mips
259 Target RejectNegative Joined ToLower Enum(mips_mips_opt_value) Var(mips_isa_option)
260 -mipsN  Generate code for ISA level N.
262 mips16
263 Target Report RejectNegative Mask(MIPS16)
264 Generate MIPS16 code.
266 mips3d
267 Target Report RejectNegative Var(TARGET_MIPS3D)
268 Use MIPS-3D instructions.
270 mllsc
271 Target Report Mask(LLSC)
272 Use ll, sc and sync instructions.
274 mlocal-sdata
275 Target Report Var(TARGET_LOCAL_SDATA) Init(1)
276 Use -G for object-local data.
278 mlong-calls
279 Target Report Var(TARGET_LONG_CALLS)
280 Use indirect calls.
282 mlong32
283 Target Report RejectNegative InverseMask(LONG64, LONG32)
284 Use a 32-bit long type.
286 mlong64
287 Target Report RejectNegative Mask(LONG64)
288 Use a 64-bit long type.
290 mmcount-ra-address
291 Target Report Var(TARGET_MCOUNT_RA_ADDRESS)
292 Pass the address of the ra save location to _mcount in $12.
294 mmemcpy
295 Target Report Mask(MEMCPY)
296 Don't optimize block moves.
298 mmicromips
299 Target Report Mask(MICROMIPS)
300 Use microMIPS instructions.
302 mmsa
303 Target Report Var(TARGET_MSA)
304 Use MIPS MSA Extension instructions.
307 Target Report Var(TARGET_MT)
308 Allow the use of MT instructions.
310 mno-float
311 Target Report RejectNegative Var(TARGET_NO_FLOAT) Condition(TARGET_SUPPORTS_NO_FLOAT)
312 Prevent the use of all floating-point operations.
314 mmcu
315 Target Report Var(TARGET_MCU)
316 Use MCU instructions.
318 mno-flush-func
319 Target RejectNegative
320 Do not use a cache-flushing function before calling stack trampolines.
322 mno-mdmx
323 Target Report RejectNegative Var(TARGET_MDMX, 0)
324 Do not use MDMX instructions.
326 mno-mips16
327 Target Report RejectNegative InverseMask(MIPS16)
328 Generate normal-mode code.
330 mno-mips3d
331 Target Report RejectNegative Var(TARGET_MIPS3D, 0)
332 Do not use MIPS-3D instructions.
334 mpaired-single
335 Target Report Mask(PAIRED_SINGLE_FLOAT)
336 Use paired-single floating-point instructions.
338 mr10k-cache-barrier=
339 Target Joined RejectNegative Enum(mips_r10k_cache_barrier_setting) Var(mips_r10k_cache_barrier) Init(R10K_CACHE_BARRIER_NONE)
340 -mr10k-cache-barrier=SETTING    Specify when r10k cache barriers should be inserted.
342 Enum
343 Name(mips_r10k_cache_barrier_setting) Type(enum mips_r10k_cache_barrier_setting)
344 Valid arguments to -mr10k-cache-barrier=:
346 EnumValue
347 Enum(mips_r10k_cache_barrier_setting) String(load-store) Value(R10K_CACHE_BARRIER_LOAD_STORE)
349 EnumValue
350 Enum(mips_r10k_cache_barrier_setting) String(store) Value(R10K_CACHE_BARRIER_STORE)
352 EnumValue
353 Enum(mips_r10k_cache_barrier_setting) String(none) Value(R10K_CACHE_BARRIER_NONE)
355 mrelax-pic-calls
356 Target Report Mask(RELAX_PIC_CALLS)
357 Try to allow the linker to turn PIC calls into direct calls.
359 mshared
360 Target Report Var(TARGET_SHARED) Init(1)
361 When generating -mabicalls code, make the code suitable for use in shared libraries.
363 msingle-float
364 Target Report RejectNegative Mask(SINGLE_FLOAT)
365 Restrict the use of hardware floating-point instructions to 32-bit operations.
367 msmartmips
368 Target Report Mask(SMARTMIPS)
369 Use SmartMIPS instructions.
371 msoft-float
372 Target Report RejectNegative Mask(SOFT_FLOAT_ABI)
373 Prevent the use of all hardware floating-point instructions.
375 msplit-addresses
376 Target Report Mask(SPLIT_ADDRESSES)
377 Optimize lui/addiu address loads.
379 msym32
380 Target Report Var(TARGET_SYM32)
381 Assume all symbols have 32-bit values.
383 msynci
384 Target Report Mask(SYNCI)
385 Use synci instruction to invalidate i-cache.
387 mlra
388 Target Report Var(mips_lra_flag) Init(1) Save
389 Use LRA instead of reload.
391 mlxc1-sxc1
392 Target Report Var(mips_lxc1_sxc1) Init(1)
393 Use lwxc1/swxc1/ldxc1/sdxc1 instructions where applicable.
395 mmadd4
396 Target Report Var(mips_madd4) Init(1)
397 Use 4-operand madd.s/madd.d and related instructions where applicable.
399 mtune=
400 Target RejectNegative Joined Var(mips_tune_option) ToLower Enum(mips_arch_opt_value)
401 -mtune=PROCESSOR        Optimize the output for PROCESSOR.
403 muninit-const-in-rodata
404 Target Report Var(TARGET_UNINIT_CONST_IN_RODATA)
405 Put uninitialized constants in ROM (needs -membedded-data).
407 mvirt
408 Target Report Var(TARGET_VIRT)
409 Use Virtualization (VZ) instructions.
411 mxpa
412 Target Report Var(TARGET_XPA)
413 Use eXtended Physical Address (XPA) instructions.
415 mvr4130-align
416 Target Report Mask(VR4130_ALIGN)
417 Perform VR4130-specific alignment optimizations.
419 mxgot
420 Target Report Var(TARGET_XGOT)
421 Lift restrictions on GOT size.
423 modd-spreg
424 Target Report Mask(ODD_SPREG)
425 Enable use of odd-numbered single-precision registers.
427 mframe-header-opt
428 Target Report Var(flag_frame_header_optimization) Optimization
429 Optimize frame header.
431 noasmopt
432 Driver
434 mload-store-pairs
435 Target Report Var(TARGET_LOAD_STORE_PAIRS) Init(1)
436 Enable load/store bonding.
438 mcompact-branches=
439 Target RejectNegative JoinedOrMissing Var(mips_cb) Report Enum(mips_cb_setting) Init(MIPS_CB_OPTIMAL)
440 Specify the compact branch usage policy.
442 Enum
443 Name(mips_cb_setting) Type(enum mips_cb_setting)
444 Policies available for use with -mcompact-branches=:
446 EnumValue
447 Enum(mips_cb_setting) String(never) Value(MIPS_CB_NEVER)
449 EnumValue
450 Enum(mips_cb_setting) String(optimal) Value(MIPS_CB_OPTIMAL)
452 EnumValue
453 Enum(mips_cb_setting) String(always) Value(MIPS_CB_ALWAYS)