Next: , 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.
longdouble128
Target has 128-bit long double.
int32plus
Target has int that is at 32 bits or longer.
int16
Target has int that is 16 bits or shorter.
long_neq_int
Target has int and long with different sizes.
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_widen_mult_si_to_di_pattern
Target supports a vector widening multiplication of int operands into long results.
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_hf_eabi
ARM target adheres to the VFP and Advanced SIMD Register Arguments variant of the ABI for the ARM Architecture (as selected with -mfloat-abi=hard).
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_neonv2_hw
Test system supports executing NEON v2 instructions.
arm_neon_ok
ARM Target supports -mfpu=neon -mfloat-abi=softfp or compatible options. Some multilibs may be incompatible with these options.
arm_neonv2_ok
ARM Target supports -mfpu=neon-vfpv4 -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.
arm_vfp3_ok
ARM target supports -mfpu=vfp3 -mfloat-abi=softfp. Some multilibs may be incompatible with these options.
arm_v8_vfp_ok
ARM target supports -mfpu=fp-armv8 -mfloat-abi=softfp. Some multilibs may be incompatible with these options.
arm_v8_neon_ok
ARM target supports -mfpu=neon-fp-armv8 -mfloat-abi=softfp. Some multilibs may be incompatible with these options.
arm_prefer_ldrd_strd
ARM target prefers LDRD and STRD instructions over LDM and STM instructions.
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
dfp_hw
PowerPC target supports executing hardware DFP instructions.
p8vector_hw
PowerPC target supports executing VSX instructions (ISA 2.07).
powerpc64
Test system supports executing 64-bit instructions.
powerpc_altivec
PowerPC target supports AltiVec.
powerpc_altivec_ok
PowerPC target supports -maltivec.
powerpc_eabi_ok
PowerPC target supports -meabi.
powerpc_elfv2
PowerPC target supports -mabi=elfv2.
powerpc_fprs
PowerPC target supports floating-point registers.
powerpc_hard_double
PowerPC target supports hardware double-precision floating-point.
powerpc_htm_ok
PowerPC target supports -mhtm
powerpc_p8vector_ok
PowerPC target supports -mpower8-vector
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.
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.
ppc_recip_hw
PowerPC target supports executing reciprocal estimate instructions.
spu_auto_overlay
SPU target has toolchain that supports automatic overlay generation.
vmx_hw
PowerPC target supports executing AltiVec instructions.
vsx_hw
PowerPC target supports executing VSX instructions (ISA 2.06).
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.
mmap
Target supports mmap.
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.
gld
Target uses GNU ld.
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).
naked_functions
Target supports the naked function attribute.
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.
pie
Target supports -pie, -fpie and -fPIE.
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.