Effective-Target Keywords - GNU Compiler Collection (GCC) Internals
Description: GNU Compiler Collection (GCC) Internals

Next: Add Options, Previous: Selectors, Up: Test Directives

#### 7.2.3 Keywords describing target attributes

Effective-target keywords identify sets of targets that support particular functionality. They are used to limit tests to be run only for particular targets, or to specify that particular sets of targets are expected to fail some tests.

Effective-target keywords are defined in `lib/target-supports.exp` in the GCC testsuite, with the exception of those that are documented as being local to a particular test directory.

The ‘`effective target`’ takes into account all of the compiler options with which the test will be compiled, including the multilib options. By convention, keywords ending in `_nocache` can also include options specified for the particular test in an earlier `dg-options` or `dg-add-options` directive.

##### 7.2.3.1 Data type sizes

`ilp32`
  Target has 32-bit `int`, `long`, and pointers.
`lp64`
  Target has 32-bit `int`, 64-bit `long` and pointers.
`llp64`
  Target has 32-bit `int` and `long`, 64-bit `long long` and pointers.
`double64`
  Target has 64-bit `double`.
`double64plus`
  Target has `double` that is 64 bits or longer.
`int32plus`
  Target has `int` that is at 32 bits or longer.
`int16`
  Target has `int` that is 16 bits or shorter.
`large_double`
  Target supports `double` that is longer than `float`.
`large_long_double`
  Target supports `long double` that is longer than `double`.
`ptr32plus`
  Target has pointers that are 32 bits or longer.
`size32plus`
  Target supports array and structure sizes that are 32 bits or longer.
`4byte_wchar_t`
  Target has `wchar_t` that is at least 4 bytes.

##### 7.2.3.2 Fortran-specific attributes

`fortran_integer_16`
  Target supports Fortran `integer` that is 16 bytes or longer.
`fortran_large_int`
  Target supports Fortran `integer` kinds larger than `integer(8)`.
`fortran_large_real`
  Target supports Fortran `real` kinds larger than `real(8)`.

##### 7.2.3.3 Vector-specific attributes

`vect_condition`
  Target supports vector conditional operations.
`vect_double`
  Target supports hardware vectors of `double`.
`vect_float`
  Target supports hardware vectors of `float`.
`vect_int`
  Target supports hardware vectors of `int`.
`vect_long`
  Target supports hardware vectors of `long`.
`vect_long_long`
  Target supports hardware vectors of `long long`.
`vect_aligned_arrays`
  Target aligns arrays to vector alignment boundary.
`vect_hw_misalign`
  Target supports a vector misalign access.
`vect_no_align`
  Target does not support a vector alignment mechanism.
`vect_no_int_max`
  Target does not support a vector max instruction on `int`.
`vect_no_int_add`
  Target does not support a vector add instruction on `int`.
`vect_no_bitwise`
  Target does not support vector bitwise instructions.
`vect_char_mult`
  Target supports `vector char` multiplication.
`vect_short_mult`
  Target supports `vector short` multiplication.
`vect_int_mult`
  Target supports `vector int` multiplication.
`vect_extract_even_odd`
  Target supports vector even/odd element extraction.
`vect_extract_even_odd_wide`
  Target supports vector even/odd element extraction of vectors with elements `SImode` or larger.
`vect_interleave`
  Target supports vector interleaving.
`vect_strided`
  Target supports vector interleaving and extract even/odd.
`vect_strided_wide`
  Target supports vector interleaving and extract even/odd for wide element types.
`vect_perm`
  Target supports vector permutation.
`vect_shift`
  Target supports a hardware vector shift operation.
`vect_widen_sum_hi_to_si`
  Target supports a vector widening summation of `short` operands into `int` results, or can promote (unpack) from `short` to `int`.
`vect_widen_sum_qi_to_hi`
  Target supports a vector widening summation of `char` operands into `short` results, or can promote (unpack) from `char` to `short`.
`vect_widen_sum_qi_to_si`
  Target supports a vector widening summation of `char` operands into `int` results.
`vect_widen_mult_qi_to_hi`
  Target supports a vector widening multiplication of `char` operands into `short` results, or can promote (unpack) from `char` to `short` and perform non-widening multiplication of `short`.
`vect_widen_mult_hi_to_si`
  Target supports a vector widening multiplication of `short` operands into `int` results, or can promote (unpack) from `short` to `int` and perform non-widening multiplication of `int`.
`vect_sdot_qi`
  Target supports a vector dot-product of `signed char`.
`vect_udot_qi`
  Target supports a vector dot-product of `unsigned char`.
`vect_sdot_hi`
  Target supports a vector dot-product of `signed short`.
`vect_udot_hi`
  Target supports a vector dot-product of `unsigned short`.
`vect_pack_trunc`
  Target supports a vector demotion (packing) of `short` to `char` and from `int` to `short` using modulo arithmetic.
`vect_unpack`
  Target supports a vector promotion (unpacking) of `char` to `short` and from `char` to `int`.
`vect_intfloat_cvt`
  Target supports conversion from `signed int` to `float`.
`vect_uintfloat_cvt`
  Target supports conversion from `unsigned int` to `float`.
`vect_floatint_cvt`
  Target supports conversion from `float` to `signed int`.
`vect_floatuint_cvt`
  Target supports conversion from `float` to `unsigned int`.

##### 7.2.3.4 Thread Local Storage attributes

`tls`
  Target supports thread-local storage.
`tls_native`
  Target supports native (rather than emulated) thread-local storage.
`tls_runtime`
  Test system supports executing TLS executables.

##### 7.2.3.5 Decimal floating point attributes

`dfp`
  Targets supports compiling decimal floating point extension to C.
`dfp_nocache`
  Including the options used to compile this particular test, the target supports compiling decimal floating point extension to C.
`dfprt`
  Test system can execute decimal floating point tests.
`dfprt_nocache`
  Including the options used to compile this particular test, the test system can execute decimal floating point tests.
`hard_dfp`
  Target generates decimal floating point instructions with current options.

##### 7.2.3.6 ARM-specific attributes

`arm32`
  ARM target generates 32-bit code.
`arm_eabi`
  ARM target adheres to the ABI for the ARM Architecture.
`arm_hard_vfp_ok`
  ARM target supports `-mfpu=vfp -mfloat-abi=hard`. Some multilibs may be incompatible with these options.
`arm_iwmmxt_ok`
  ARM target supports `-mcpu=iwmmxt`. Some multilibs may be incompatible with this option.
`arm_neon`
  ARM target supports generating NEON instructions.
`arm_neon_hw`
  Test system supports executing NEON instructions.
`arm_neon_ok`
  ARM Target supports `-mfpu=neon -mfloat-abi=softfp` or compatible options. Some multilibs may be incompatible with these options.
`arm_neon_fp16_ok`
  ARM Target supports `-mfpu=neon-fp16 -mfloat-abi=softfp` or compatible options. Some multilibs may be incompatible with these options.
`arm_thumb1_ok`
  ARM target generates Thumb-1 code for `-mthumb`.
`arm_thumb2_ok`
  ARM target generates Thumb-2 code for `-mthumb`.
`arm_vfp_ok`
  ARM target supports `-mfpu=vfp -mfloat-abi=softfp`. Some multilibs may be incompatible with these options.

##### 7.2.3.7 MIPS-specific attributes

`mips64`
  MIPS target supports 64-bit instructions.
`nomips16`
  MIPS target does not produce MIPS16 code.
`mips16_attribute`
  MIPS target can generate MIPS16 code.
`mips_loongson`
  MIPS target is a Loongson-2E or -2F target using an ABI that supports the Loongson vector modes.
`mips_newabi_large_long_double`
  MIPS target supports `long double` larger than `double` when using the new ABI.
`mpaired_single`
  MIPS target supports `-mpaired-single`.

##### 7.2.3.8 PowerPC-specific attributes

`powerpc64`
  Test system supports executing 64-bit instructions.
`powerpc_altivec`
  PowerPC target supports AltiVec.
`powerpc_altivec_ok`
  PowerPC target supports `-maltivec`.
`powerpc_fprs`
  PowerPC target supports floating-point registers.
`powerpc_hard_double`
  PowerPC target supports hardware double-precision floating-point.
`powerpc_ppu_ok`
  PowerPC target supports `-mcpu=cell`.
`powerpc_spe`
  PowerPC target supports PowerPC SPE.
`powerpc_spe_nocache`
  Including the options used to compile this particular test, the PowerPC target supports PowerPC SPE.
`powerpc_spu`
  PowerPC target supports PowerPC SPU.
`spu_auto_overlay`
  SPU target has toolchain that supports automatic overlay generation.
`powerpc_vsx_ok`
  PowerPC target supports `-mvsx`.
`powerpc_405_nocache`
  Including the options used to compile this particular test, the PowerPC target supports PowerPC 405.
`vmx_hw`
  PowerPC target supports executing AltiVec instructions.

##### 7.2.3.9 Other hardware attributes

`avx`
  Target supports compiling `avx` instructions.
`avx_runtime`
  Target supports the execution of `avx` instructions.
`cell_hw`
  Test system can execute AltiVec and Cell PPU instructions.
`coldfire_fpu`
  Target uses a ColdFire FPU.
`hard_float`
  Target supports FPU instructions.
`sse`
  Target supports compiling `sse` instructions.
`sse_runtime`
  Target supports the execution of `sse` instructions.
`sse2`
  Target supports compiling `sse2` instructions.
`sse2_runtime`
  Target supports the execution of `sse2` instructions.
`sync_char_short`
  Target supports atomic operations on `char` and `short`.
`sync_int_long`
  Target supports atomic operations on `int` and `long`.
`ultrasparc_hw`
  Test environment appears to run executables on a simulator that accepts only `EM_SPARC` executables and chokes on `EM_SPARC32PLUS` or `EM_SPARCV9` executables.
`vect_cmdline_needed`
  Target requires a command line argument to enable a SIMD instruction set.

##### 7.2.3.10 Environment attributes

`c`
  The language for the compiler under test is C.
`c++`
  The language for the compiler under test is C++.
`c99_runtime`
  Target provides a full C99 runtime.
`correct_iso_cpp_string_wchar_protos`
  Target `string.h` and `wchar.h` headers provide C++ required overloads for `strchr` etc. functions.
`dummy_wcsftime`
  Target uses a dummy `wcsftime` function that always returns zero.
`fd_truncate`
  Target can truncate a file from a file descriptor, as used by `libgfortran/io/unix.c:fd_truncate`; i.e. `ftruncate` or `chsize`.
`freestanding`
  Target is ‘`freestanding`’ as defined in section 4 of the C99 standard. Effectively, it is a target which supports no extra headers or libraries other than what is considered essential.
`init_priority`
  Target supports constructors with initialization priority arguments.
`inttypes_types`
  Target has the basic signed and unsigned types in `inttypes.h`. This is for tests that GCC's notions of these types agree with those in the header, as some systems have only `inttypes.h`.
`lax_strtofp`
  Target might have errors of a few ULP in string to floating-point conversion functions and overflow is not always detected correctly by those functions.
`newlib`
  Target supports Newlib.
`pow10`
  Target provides `pow10` function.
`pthread`
  Target can compile using `pthread.h` with no errors or warnings.
`pthread_h`
  Target has `pthread.h`.
`run_expensive_tests`
  Expensive testcases (usually those that consume excessive amounts of CPU time) should be run on this target. This can be enabled by setting the `GCC_TEST_RUN_EXPENSIVE` environment variable to a non-empty string.
`simulator`
  Test system runs executables on a simulator (i.e. slowly) rather than hardware (i.e. fast).
`stdint_types`
  Target has the basic signed and unsigned C types in `stdint.h`. This will be obsolete when GCC ensures a working `stdint.h` for all targets.
`trampolines`
  Target supports trampolines.
`uclibc`
  Target supports uClibc.
`unwrapped`
  Target does not use a status wrapper.
`vxworks_kernel`
  Target is a VxWorks kernel.
`vxworks_rtp`
  Target is a VxWorks RTP.
`wchar`
  Target supports wide characters.

##### 7.2.3.11 Other attributes

`automatic_stack_alignment`
  Target supports automatic stack alignment.
`cxa_atexit`
  Target uses `__cxa_atexit`.
`default_packed`
  Target has packed layout of structure members by default.
`fgraphite`
  Target supports Graphite optimizations.
`fixed_point`
  Target supports fixed-point extension to C.
`fopenmp`
  Target supports OpenMP via `-fopenmp`.
`fpic`
  Target supports `-fpic` and `-fPIC`.
`freorder`
  Target supports `-freorder-blocks-and-partition`.
`fstack_protector`
  Target supports `-fstack-protector`.
`gas`
  Target uses GNU `as`.
`gc_sections`
  Target supports `--gc-sections`.
`keeps_null_pointer_checks`
  Target keeps null pointer checks, either due to the use of `-fno-delete-null-pointer-checks` or hardwired into the target.
`lto`
  Compiler has been configured to support link-time optimization (LTO).
`named_sections`
  Target supports named sections.
`natural_alignment_32`
  Target uses natural alignment (aligned to type size) for types of 32 bits or less.
`target_natural_alignment_64`
  Target uses natural alignment (aligned to type size) for types of 64 bits or less.
`nonpic`
  Target does not generate PIC by default.
`pcc_bitfield_type_matters`
  Target defines `PCC_BITFIELD_TYPE_MATTERS`.
`pe_aligned_commons`
  Target supports `-mpe-aligned-commons`.
`section_anchors`
  Target supports section anchors.
`short_enums`
  Target defaults to short enums.
`static`
  Target supports `-static`.
`static_libgfortran`
  Target supports statically linking ‘`libgfortran`’.
`string_merging`
  Target supports merging string constants at link time.
`ucn`
  Target supports compiling and assembling UCN.
`ucn_nocache`
  Including the options used to compile this particular test, the target supports compiling and assembling UCN.
`unaligned_stack`
  Target does not guarantee that its `STACK_BOUNDARY` is greater than or equal to the required vector alignment.
`vector_alignment_reachable`
  Vector alignment is reachable for types of 32 bits or less.
`vector_alignment_reachable_for_64bit`
  Vector alignment is reachable for types of 64 bits or less.
`wchar_t_char16_t_compatible`
  Target supports `wchar_t` that is compatible with `char16_t`.
`wchar_t_char32_t_compatible`
  Target supports `wchar_t` that is compatible with `char32_t`.

##### 7.2.3.12 Local to tests in `gcc.target/i386`

`3dnow`
  Target supports compiling `3dnow` instructions.
`aes`
  Target supports compiling `aes` instructions.
`fma4`
  Target supports compiling `fma4` instructions.
`ms_hook_prologue`
  Target supports attribute `ms_hook_prologue`.
`pclmul`
  Target supports compiling `pclmul` instructions.
`sse3`
  Target supports compiling `sse3` instructions.
`sse4`
  Target supports compiling `sse4` instructions.
`sse4a`
  Target supports compiling `sse4a` instructions.
`ssse3`
  Target supports compiling `ssse3` instructions.
`vaes`
  Target supports compiling `vaes` instructions.
`vpclmul`
  Target supports compiling `vpclmul` instructions.
`xop`
  Target supports compiling `xop` instructions.

##### 7.2.3.13 Local to tests in `gcc.target/spu/ea`

`ealib`
  Target `__ea` library functions are available.

##### 7.2.3.14 Local to tests in `gcc.test-framework`

`no`
  Always returns 0.
`yes`
  Always returns 1.