shylie/llvm-project
1
0
Fork 0
Code Issues Pull Requests Actions 6 Packages Projects Releases Wiki Activity
llvm-project/flang/docs/OpenACC.md
khaki3 ff0220d236
[flang][acc] Allow orphaned acc cache directive (#184448) 
While the spec allows the cache directive at the top of a loop body, the
directive has also been utilized at the top of an acc routine. This PR
removes the semantic check that rejects the cache directive outside of a
loop, allowing orphaned `!$acc cache` similar to CIR.

The OpenACC.md deviation document is updated to note this extension.
2026-03-04 09:41:48 -08:00

2.1 KiB
Raw Blame History

OpenACC in Flang

---
local:
---

Intentional deviation from the specification

  • The end directive for combined construct can omit the loop keyword.
  • An !$acc routine with no parallelism clause is treated as if the seq clause was present.
  • !$acc end loop does not trigger a parsing error and is just ignored.
  • The restriction on !$acc data required clauses is emitted as a portability warning instead of an error as other compiler accepts it.
  • The if clause accepts scalar integer expression in addition to scalar logical expression.
  • !$acc routine directive can be placed at the top level.
  • !$acc cache directive accepts scalar variable.
  • !$acc cache directive is accepted outside of a loop construct.
  • The !$acc declare directive accepts assumed size array arguments for deviceptr and present clauses.
  • The OpenACC specification disallows a variable appearing multiple times in clauses of !$acc declare directives for a function, subroutine, program, or module, but it is allowed with a warning when same clause is used.
  • The OpenACC specification does not prohibit the same variable from appearing in multiple data clauses, but this is disallowed for variables appearing in private, firstprivate, or reduction clauses.
  • The OpenACC specification does not prohibit the same variable from appearing multiple times in a use_device clause on a host_data construct, but this is disallowed.

Remarks about incompatibilities with other implementations

  • Array element references in the data clauses are equivalent to array sections consisting of this single element, i.e. copyin(a(n)) is equivalent to copyin(a(n:n)). Some other implementations have treated it as copyin(a(:n)), which does not correspond to OpenACC spec – Flang does not support this interpretation of an array element reference.