]>
Commit | Line | Data |
---|---|---|
c63539ff ML |
1 | .. |
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. | |
5 | ||
6 | .. _acc_update_self: | |
7 | ||
8 | acc_update_self -- Update host memory from mapped device memory. | |
9 | **************************************************************** | |
10 | ||
11 | Description | |
12 | This function updates the host copy from the previously mapped device memory. | |
13 | The host memory is specified with the host address :samp:`{a}` and a length of | |
14 | :samp:`{len}` bytes. | |
15 | ||
16 | In Fortran, two (2) forms are supported. In the first form, :samp:`{a}` specifies | |
17 | a contiguous array section. The second form :samp:`{a}` specifies a variable or | |
18 | array element and :samp:`{len}` specifies the length in bytes. | |
19 | ||
20 | C/C++: | |
21 | .. list-table:: | |
22 | ||
23 | * - *Prototype*: | |
24 | - ``acc_update_self(h_void *a, size_t len);`` | |
25 | * - *Prototype*: | |
26 | - ``acc_update_self_async(h_void *a, size_t len, int async);`` | |
27 | ||
28 | Fortran: | |
29 | .. list-table:: | |
30 | ||
31 | * - *Interface*: | |
32 | - ``subroutine acc_update_self(a)`` | |
33 | * - | |
34 | - ``type, dimension(:[,:]...) :: a`` | |
35 | * - *Interface*: | |
36 | - ``subroutine acc_update_self(a, len)`` | |
37 | * - | |
38 | - ``type, dimension(:[,:]...) :: a`` | |
39 | * - | |
40 | - ``integer len`` | |
41 | * - *Interface*: | |
42 | - ``subroutine acc_update_self_async(a, async)`` | |
43 | * - | |
44 | - ``type, dimension(:[,:]...) :: a`` | |
45 | * - | |
46 | - ``integer(acc_handle_kind) :: async`` | |
47 | * - *Interface*: | |
48 | - ``subroutine acc_update_self_async(a, len, async)`` | |
49 | * - | |
50 | - ``type, dimension(:[,:]...) :: a`` | |
51 | * - | |
52 | - ``integer len`` | |
53 | * - | |
54 | - ``integer(acc_handle_kind) :: async`` | |
55 | ||
56 | Reference: | |
57 | :openacc:`2.6`, section | |
3ed1b4ce | 58 | 3.2.25. |