Observed issues › gcc/gcc-acc-link-in-routine-rejected
OpenACC: a declare link variable used in a routine is rejected ("with 'link' clause used in 'routine' function")
Legality: independently confirmed. 2 independent readings find the program legal and the result required. How this is checked
A variable in a declare link clause may be used in an accelerator routine (OpenACC 3.4 §2.13.3). GCC 16.2 rejects a routine seq procedure that reads such a variable: "'lv' with 'link' clause used in 'routine' function", in Fortran and C. CCE compiles and runs the Fortran program.
Affected variants
| Compiler | MI300A gfx942 unified memory (XNACK 1) | MI300A gfx942 copy (XNACK 0) | MI250X gfx90a copy (XNACK 0) | MI300X gfx942 copy (XNACK 0) | MI350X gfx950 copy (XNACK 0) | A100 sm_80 separate memory | A100 sm_80 managed memory |
|---|---|---|---|---|---|---|---|
| AFAR 24.3.0 | n/a | n/a | n/a | n/a | n/a | n/a | n/a |
| CCE 19.0.0 | correct | correct | unknown not run | unknown not run | unknown not run | n/a | n/a |
| CCE 20.0.2 | correct | correct | unknown not run | unknown not run | unknown not run | n/a | n/a |
| CCE 21.0.3 | correct | correct | unknown not run | unknown not run | unknown not run | n/a | n/a |
| CCE 21.0.4 | correct | correct | unknown not run | unknown not run | unknown not run | n/a | n/a |
| NVHPC 25.11 | n/a | n/a | n/a | n/a | n/a | fails another way | fails another way |
| NVHPC 26.9 | n/a | n/a | n/a | n/a | n/a | fails another way | fails another way |
| GCC 16.2.0 | not supported | not supported | not supported | not supported | not supported | not supported | n/a |
"behaves incorrectly" / "not supported": this issue, confirmed in up to four environments (another build directory, another node, a repeat). "fails another way": a different failure, not counted as this issue. "unknown": not run there, or the runs disagree.
Messages
| Result | Compiler and GPU | Message |
|---|---|---|
| not supported | GCC 16.2.0, MI300A unified GCC 16.2.0, MI300A copy GCC 16.2.0, MI250X GCC 16.2.0, MI300X GCC 16.2.0, MI350X GCC 16.2.0, A100 separate | showsite-gcc--gcc-acc-link-in-routine-rejected.f90:39:14:
39 | integer :: lv(64)
| ^~~~~~
Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function |
| fails another way | NVHPC 25.11, A100 separate NVHPC 25.11, A100 managed NVHPC 26.9, A100 separate NVHPC 26.9, A100 managed | showRESULT ran_on_host=0 check=fail |
Reproduce
GCC 16.2.0, MI300A unified
export LD_LIBRARY_PATH=$GCC_16_2/lib64:/opt/rocm-7.2.1/lib $GCC_16_2/bin/gfortran -fopenacc -foffload=amdgcn-amdhsa -foffload-options=amdgcn-amdhsa=-march=gfx942 -O2 repro.f90 -o repro HSA_XNACK=1 ./repro
GCC 16.2.0, A100 separate
export PATH=/usr/local/cuda/bin:$PATH export LD_LIBRARY_PATH=$GCC_16_2/lib64 $GCC_16_2/bin/gfortran -fopenacc -foffload=nvptx-none -foffload-options=nvptx-none=-march=sm_80 -foffload-options=nvptx-none=-latomic -O2 repro.f90 -o repro ./repro
CCE 19.0.0, MI300A unified (runs correctly)
module load cce/19.0.0 craype-accel-amd-gfx942 rocm/6.4.3 module unload cray-mpich ftn -h acc -O2 repro.f90 -o repro HSA_XNACK=1 ./repro
Program (76 lines)
! # Finding (GCC 16.2): a declare link variable used in an OpenACC routine is rejected (Fortran); the reproducer is the catalog
! program acc34-clause-link
!
! - toolchains: gcc_g90 (GCC 16.2.0, AMD Instinct MI250X gfx90a, Tioga) and gcc_sm80 (GCC 16.2.0,
! NVIDIA A100 sm_80, wingtip); separate memory only; -O2; OMP_TARGET_OFFLOAD=mandatory
! - build: gfortran -fopenacc -foffload=amdgcn-amdhsa -foffload-options=amdgcn-amdhsa=-march=gfx90a -O2 (gcc_g90);
! -foffload=nvptx-none -foffload-options=nvptx-none=-march=sm_80 -foffload-options=nvptx-none=-latomic -O2 (gcc_sm80)
! - failure: rejected: with .link. clause used in .routine. function
! - observed: `Error: 'lv' with 'link' clause used in 'routine' function` on both GPUs.
! - expected: compiles; `RESULT ran_on_host=0 check=pass`
! - spec: "The global variable or common block variables may be used in accelerator routines" (OpenACC 3.4 §2.13.3 l.3083-3084), for
! a variable in a declare link clause; the device copy exists while a data clause holds it (l.3079-3081), here the parallel loop's
! copyin(lv).
! - GCC 16.2 documentation (libgomp.texi "Enabling OpenACC"): "A complete description of all OpenACC directives accepted may be
! found in the OpenACC Application Programming Interface manual, version 2.6"; _OPENACC is 201711 (2.6). No list of OpenACC gaps
! is documented.
! - other families: CCE 19/20/21 compile and run it correctly (MI300A, MI250X); NVHPC 25.11/26.9 compile it and give a wrong answer
! (not studied here).
! - gate and confirmer: 2 cells (1 gcc_g90, 1 gcc_sm80), each confirmed in the gate's four environments (a-d;
! results/gcc/gate-tioga/ and gate-wingtip/ verdicts.jsonl); confirmer verdicts (results/gcc/confirm/batch.gcc_*.jsonl):
! compiler_bug (R11-compile-rejection) 2
! - catalog programs (1): acc34-clause-link
! - legality: the catalog programs are legal by construction (offload.engine.gen, c_gen and acc_gen
! check every program against the catalog rules and the offload scope as it is built; no
! compiler). GCC is a compiler under test only: never a legality witness, here or for another
! family's case (catalog/machines.yaml under_test_only).
! Generated by compliance.gen (OpenACC 3.4, free-form Fortran). Do not edit.
! id: acc34-clause-link
! primary atom: acc.clause.link
! legal: yes
! observable: yes
! ran_on_host: inside the compute region of interest (acc_on_device)
! evidence: construct
! needs: none
! std: f2008
module gen_mod
use openacc
implicit none
integer :: lv(64)
!$acc declare link(lv)
contains
integer function get_lv(k)
!$acc routine seq
integer, intent(in) :: k
get_lv = lv(k)
end function get_lv
end module gen_mod
program gen_prog
use openacc, only: acc_device_host, acc_on_device
use gen_mod
implicit none
integer, parameter :: n = 64
integer, allocatable, target :: a(:), b(:)
integer :: ref(n)
integer :: i, host_flag
logical :: ok
allocate(a(n), b(n))
do i = 1, n
a(i) = i
b(i) = 0
ref(i) = 2*i + 1
end do
host_flag = 1
do i = 1, n
lv(i) = 2*i + 1
end do
!$acc parallel loop copyin(a) copyout(b) copy(host_flag) copyin(lv)
do i = 1, n
if (i == 1) host_flag = merge(1, 0, acc_on_device(acc_device_host))
b(i) = get_lv(a(i))
end do
ok = all(b == ref)
print '(a,i0,a,a)', 'RESULT ran_on_host=', host_flag, ' check=', merge('pass', 'fail', ok)
deallocate(a, b)
end program gen_prog
Something to add? Dispute its legality · Report it fixed in a newer release · Report a mistake on this page
Expected and observed
Expected
check=pass
Observed where it behaves incorrectly
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14:
39 | integer :: lv(64)
| ^~~~~~
Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ function
site-gcc--gcc-acc-link-in-routine-rejected.f90:39:14: Error: ‘lv’ with ‘link’ clause used in ‘routine’ functionWhat the specification requires
The specification text this program relies on and the compiler is expected to support.
OpenACC 3.4 §2.13.3
The global variable or common block variables may be used in accelerator routines
OpenACC 3.4 §2.13.3
Evidence
Other compilers run it correctly
CCE 19.0.0, CCE 20.0.2, CCE 21.0.3, CCE 21.0.4