Effective-Target Keywords - 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_int_mult: Target supports a vector widening multiplication of short operands into an int result, or supports promotion (unpacking) from short to int and a non-widening multiplication 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. 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.
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.