GNU Compiler Collection (GCC) Internals: Selectors

Next: Effective-Target Keywords, Previous: Directives, Up: Test Directives [Contents][Index]

#### 7.2.2 Selecting targets to which a test applies

Several test directives include selectors to limit the targets for which a test is run or to declare that a test is expected to fail on particular targets.

A selector is:

- one or more target triplets, possibly including wildcard characters; use ‘`*-*-*`’ to match any target
- a single effective-target keyword (see Effective-Target Keywords)
- a list of compiler options that should be included or excluded (as described in more detail below)
- a logical expression

Depending on the context, the selector specifies whether a test is skipped and reported as unsupported or is expected to fail. A context that allows either ‘`target`’ or ‘`xfail`’ also allows ‘`{ target selector1 xfail selector2 }`’ to skip the test for targets that don’t match selector1 and the test to fail for targets that match selector2.

A selector expression appears within curly braces and uses a single logical operator: one of ‘`!`’, ‘`&&`’, or ‘`||`’. An operand is one of the following:

- another selector expression, in curly braces
- an effective-target keyword, such as `lp64`
- a single target triplet
- a list of target triplets within quotes or curly braces
- one of the following:
  ‘`{ any-opts opt1 … optn }`’

    Each of opt1 to optn is a space-separated list of option globs. The selector expression evaluates to true if, for one of these strings, every glob in the string matches an option that was passed to the compiler. For example:

        { any-opts "-O3 -flto" "-O[2g]" }

    is true if any of the following are true:

    - `-O2` was passed to the compiler
    - `-Og` was passed to the compiler
    - both `-O3` and `-flto` were passed to the compiler

    This kind of selector can only be used within `dg-final` directives. Use `dg-skip-if`, `dg-xfail-if` or `dg-xfail-run-if` to skip whole tests based on options, or to mark them as expected to fail with certain options.

  ‘`{ no-opts opt1 … optn }`’

    As for `any-opts` above, each of opt1 to optn is a space-separated list of option globs. The selector expression evaluates to true if, for all of these strings, there is at least one glob that does not match an option that was passed to the compiler. It is shorthand for:

        { ! { any-opts opt1 … optn } }

    For example:

        { no-opts "-O3 -flto" "-O[2g]" }

    is true if all of the following are true:

    - `-O2` was not passed to the compiler
    - `-Og` was not passed to the compiler
    - at least one of `-O3` or `-flto` was not passed to the compiler

    Like `any-opts`, this kind of selector can only be used within `dg-final` directives.

Here are some examples of full target selectors:

    { target { ! "hppa*-*-* ia64*-*-*" } }
    { target { powerpc*-*-* && lp64 } }
    { xfail { lp64 || vect_no_align } }
    { xfail { aarch64*-*-* && { any-opts "-O2" } } }

Next: Effective-Target Keywords, Previous: Directives, Up: Test Directives [Contents][Index]