2 Copyright 1988-2022 Free Software Foundation, Inc.
3 This is part of the GCC manual.
4 For copying conditions, see the copyright.rst file.
8 acc_copyout -- Copy device memory to host memory.
9 *************************************************
12 This function copies mapped device memory to host memory which is specified
13 by host address :samp:`{a}` for a length :samp:`{len}` bytes in C/C++.
15 In Fortran, two (2) forms are supported. In the first form, :samp:`{a}` specifies
16 a contiguous array section. The second form :samp:`{a}` specifies a variable or
17 array element and :samp:`{len}` specifies the length in bytes.
23 - ``acc_copyout(h_void *a, size_t len);``
25 - ``acc_copyout_async(h_void *a, size_t len, int async);``
27 - ``acc_copyout_finalize(h_void *a, size_t len);``
29 - ``acc_copyout_finalize_async(h_void *a, size_t len, int async);``
35 - ``subroutine acc_copyout(a)``
37 - ``type, dimension(:[,:]...) :: a``
39 - ``subroutine acc_copyout(a, len)``
41 - ``type, dimension(:[,:]...) :: a``
45 - ``subroutine acc_copyout_async(a, async)``
47 - ``type, dimension(:[,:]...) :: a``
49 - ``integer(acc_handle_kind) :: async``
51 - ``subroutine acc_copyout_async(a, len, async)``
53 - ``type, dimension(:[,:]...) :: a``
57 - ``integer(acc_handle_kind) :: async``
59 - ``subroutine acc_copyout_finalize(a)``
61 - ``type, dimension(:[,:]...) :: a``
63 - ``subroutine acc_copyout_finalize(a, len)``
65 - ``type, dimension(:[,:]...) :: a``
69 - ``subroutine acc_copyout_finalize_async(a, async)``
71 - ``type, dimension(:[,:]...) :: a``
73 - ``integer(acc_handle_kind) :: async``
75 - ``subroutine acc_copyout_finalize_async(a, len, async)``
77 - ``type, dimension(:[,:]...) :: a``
81 - ``integer(acc_handle_kind) :: async``
84 :openacc:`2.6`, section