首頁 探索 說明
註冊 登入
huangmeng
/
Embedded_AI
1
0
複刻 0
Files 問題管理 0 合併請求 0 Wiki
分支: master
分支列表 標籤列表
Embedded_AI
/
gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf
/
share
/
doc
/
libgomp.html
/
OpenACC-Runtime-Library-Routines.html

OpenACC-Runtime-Library-Routines.html 13 KB
永久連結 文件歷史 原始文件

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191 
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3. <!-- Copyright (C) 2006-2017 Free Software Foundation, Inc.
    4. 

  4. 

  5. Permission is granted to copy, distribute and/or modify this document
    6. 

  6. under the terms of the GNU Free Documentation License, Version 1.3 or
    7. 

  7. any later version published by the Free Software Foundation; with the
    8. 

  8. Invariant Sections being "Funding Free Software", the Front-Cover
    9. 

  9. texts being (a) (see below), and with the Back-Cover Texts being (b)
    10. 

  10. (see below).  A copy of the license is included in the section entitled
    11. 

  11. "GNU Free Documentation License".
    12. 

  12. 

  13. (a) The FSF's Front-Cover Text is:
    14. 

  14. 

  15. A GNU Manual
    16. 

  16. 

  17. (b) The FSF's Back-Cover Text is:
    18. 

  18. 

  19. You have freedom to copy and modify this GNU Manual, like GNU
    20. 

  20.      software.  Copies published by the Free Software Foundation raise
    21. 

  21.      funds for GNU development. -->
    22. 

  22. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    23. 

  23. <head>
    24. 

  24. <title>GNU libgomp: OpenACC Runtime Library Routines</title>
    25. 

  25. 

  26. <meta name="description" content="GNU libgomp: OpenACC Runtime Library Routines">
    27. 

  27. <meta name="keywords" content="GNU libgomp: OpenACC Runtime Library Routines">
    28. 

  28. <meta name="resource-type" content="document">
    29. 

  29. <meta name="distribution" content="global">
    30. 

  30. <meta name="Generator" content="makeinfo">
    31. 

  31. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    32. 

  32. <link href="index.html#Top" rel="start" title="Top">
    33. 

  33. <link href="Library-Index.html#Library-Index" rel="index" title="Library Index">
    34. 

  34. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    35. 

  35. <link href="index.html#Top" rel="up" title="Top">
    36. 

  36. <link href="acc_005fget_005fnum_005fdevices.html#acc_005fget_005fnum_005fdevices" rel="next" title="acc_get_num_devices">
    37. 

  37. <link href="Enabling-OpenACC.html#Enabling-OpenACC" rel="prev" title="Enabling OpenACC">
    38. 

  38. <style type="text/css">
    39. 

  39. <!--
    40. 

  40. a.summary-letter {text-decoration: none}
    41. 

  41. blockquote.smallquotation {font-size: smaller}
    42. 

  42. div.display {margin-left: 3.2em}
    43. 

  43. div.example {margin-left: 3.2em}
    44. 

  44. div.indentedblock {margin-left: 3.2em}
    45. 

  45. div.lisp {margin-left: 3.2em}
    46. 

  46. div.smalldisplay {margin-left: 3.2em}
    47. 

  47. div.smallexample {margin-left: 3.2em}
    48. 

  48. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    49. 

  49. div.smalllisp {margin-left: 3.2em}
    50. 

  50. kbd {font-style:oblique}
    51. 

  51. pre.display {font-family: inherit}
    52. 

  52. pre.format {font-family: inherit}
    53. 

  53. pre.menu-comment {font-family: serif}
    54. 

  54. pre.menu-preformatted {font-family: serif}
    55. 

  55. pre.smalldisplay {font-family: inherit; font-size: smaller}
    56. 

  56. pre.smallexample {font-size: smaller}
    57. 

  57. pre.smallformat {font-family: inherit; font-size: smaller}
    58. 

  58. pre.smalllisp {font-size: smaller}
    59. 

  59. span.nocodebreak {white-space:nowrap}
    60. 

  60. span.nolinebreak {white-space:nowrap}
    61. 

  61. span.roman {font-family:serif; font-weight:normal}
    62. 

  62. span.sansserif {font-family:sans-serif; font-weight:normal}
    63. 

  63. ul.no-bullet {list-style: none}
    64. 

  64. -->
    65. 

  65. </style>
    66. 

  66. 

  67. 

  68. </head>
    69. 

  69. 

  70. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    71. 

  71. <a name="OpenACC-Runtime-Library-Routines"></a>
    72. 

  72. <div class="header">
    73. 

  73. <p>
    74. 

  74. Next: <a href="OpenACC-Environment-Variables.html#OpenACC-Environment-Variables" accesskey="n" rel="next">OpenACC Environment Variables</a>, Previous: <a href="Enabling-OpenACC.html#Enabling-OpenACC" accesskey="p" rel="prev">Enabling OpenACC</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Library-Index.html#Library-Index" title="Index" rel="index">Index</a>]</p>
    75. 

  75. </div>
    76. 

  76. <hr>
    77. 

  77. <a name="OpenACC-Runtime-Library-Routines-1"></a>
    78. 

  78. <h2 class="chapter">5 OpenACC Runtime Library Routines</h2>
    79. 

  79. 

  80. <p>The runtime routines described here are defined by section 3 of the OpenACC
    81. 

  81. specifications in version 2.0.
    82. 

  82. They have C linkage, and do not throw exceptions.
    83. 

  83. Generally, they are available only for the host, with the exception of
    84. 

  84. <code>acc_on_device</code>, which is available for both the host and the
    85. 

  85. acceleration device.
    86. 

  86. </p>
    87. 

  87. <table class="menu" border="0" cellspacing="0">
    88. 

  88. <tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fnum_005fdevices.html#acc_005fget_005fnum_005fdevices" accesskey="1">acc_get_num_devices</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get number of devices for the given device
    89. 

  89.                                 type.
    90. 

  90. </td></tr>
    91. 

  91. <tr><td align="left" valign="top">&bull; <a href="acc_005fset_005fdevice_005ftype.html#acc_005fset_005fdevice_005ftype" accesskey="2">acc_set_device_type</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set type of device accelerator to use.
    92. 

  92. </td></tr>
    93. 

  93. <tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fdevice_005ftype.html#acc_005fget_005fdevice_005ftype" accesskey="3">acc_get_device_type</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get type of device accelerator to be used.
    94. 

  94. </td></tr>
    95. 

  95. <tr><td align="left" valign="top">&bull; <a href="acc_005fset_005fdevice_005fnum.html#acc_005fset_005fdevice_005fnum" accesskey="4">acc_set_device_num</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set device number to use.
    96. 

  96. </td></tr>
    97. 

  97. <tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fdevice_005fnum.html#acc_005fget_005fdevice_005fnum" accesskey="5">acc_get_device_num</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get device number to be used.
    98. 

  98. </td></tr>
    99. 

  99. <tr><td align="left" valign="top">&bull; <a href="acc_005fasync_005ftest.html#acc_005fasync_005ftest" accesskey="6">acc_async_test</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tests for completion of a specific asynchronous
    100. 

  100.                                 operation.
    101. 

  101. </td></tr>
    102. 

  102. <tr><td align="left" valign="top">&bull; <a href="acc_005fasync_005ftest_005fall.html#acc_005fasync_005ftest_005fall" accesskey="7">acc_async_test_all</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Tests for completion of all asychronous
    103. 

  103.                                 operations.
    104. 

  104. </td></tr>
    105. 

  105. <tr><td align="left" valign="top">&bull; <a href="acc_005fwait.html#acc_005fwait" accesskey="8">acc_wait</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Wait for completion of a specific asynchronous
    106. 

  106.                                 operation.
    107. 

  107. </td></tr>
    108. 

  108. <tr><td align="left" valign="top">&bull; <a href="acc_005fwait_005fall.html#acc_005fwait_005fall" accesskey="9">acc_wait_all</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Waits for completion of all asyncrhonous
    109. 

  109.                                 operations.
    110. 

  110. </td></tr>
    111. 

  111. <tr><td align="left" valign="top">&bull; <a href="acc_005fwait_005fall_005fasync.html#acc_005fwait_005fall_005fasync">acc_wait_all_async</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Wait for completion of all asynchronous
    112. 

  112.                                 operations.
    113. 

  113. </td></tr>
    114. 

  114. <tr><td align="left" valign="top">&bull; <a href="acc_005fwait_005fasync.html#acc_005fwait_005fasync">acc_wait_async</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Wait for completion of asynchronous operations.
    115. 

  115. </td></tr>
    116. 

  116. <tr><td align="left" valign="top">&bull; <a href="acc_005finit.html#acc_005finit">acc_init</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Initialize runtime for a specific device type.
    117. 

  117. </td></tr>
    118. 

  118. <tr><td align="left" valign="top">&bull; <a href="acc_005fshutdown.html#acc_005fshutdown">acc_shutdown</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Shuts down the runtime for a specific device
    119. 

  119.                                 type.
    120. 

  120. </td></tr>
    121. 

  121. <tr><td align="left" valign="top">&bull; <a href="acc_005fon_005fdevice.html#acc_005fon_005fdevice">acc_on_device</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Whether executing on a particular device
    122. 

  122. </td></tr>
    123. 

  123. <tr><td align="left" valign="top">&bull; <a href="acc_005fmalloc.html#acc_005fmalloc">acc_malloc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Allocate device memory.
    124. 

  124. </td></tr>
    125. 

  125. <tr><td align="left" valign="top">&bull; <a href="acc_005ffree.html#acc_005ffree">acc_free</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Free device memory.
    126. 

  126. </td></tr>
    127. 

  127. <tr><td align="left" valign="top">&bull; <a href="acc_005fcopyin.html#acc_005fcopyin">acc_copyin</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Allocate device memory and copy host memory to
    128. 

  128.                                 it.
    129. 

  129. </td></tr>
    130. 

  130. <tr><td align="left" valign="top">&bull; <a href="acc_005fpresent_005for_005fcopyin.html#acc_005fpresent_005for_005fcopyin">acc_present_or_copyin</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If the data is not present on the device,
    131. 

  131.                                 allocate device memory and copy from host
    132. 

  132.                                 memory.
    133. 

  133. </td></tr>
    134. 

  134. <tr><td align="left" valign="top">&bull; <a href="acc_005fcreate.html#acc_005fcreate">acc_create</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Allocate device memory and map it to host
    135. 

  135.                                 memory.
    136. 

  136. </td></tr>
    137. 

  137. <tr><td align="left" valign="top">&bull; <a href="acc_005fpresent_005for_005fcreate.html#acc_005fpresent_005for_005fcreate">acc_present_or_create</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">If the data is not present on the device,
    138. 

  138.                                 allocate device memory and map it to host
    139. 

  139.                                 memory.
    140. 

  140. </td></tr>
    141. 

  141. <tr><td align="left" valign="top">&bull; <a href="acc_005fcopyout.html#acc_005fcopyout">acc_copyout</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Copy device memory to host memory.
    142. 

  142. </td></tr>
    143. 

  143. <tr><td align="left" valign="top">&bull; <a href="acc_005fdelete.html#acc_005fdelete">acc_delete</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Free device memory.
    144. 

  144. </td></tr>
    145. 

  145. <tr><td align="left" valign="top">&bull; <a href="acc_005fupdate_005fdevice.html#acc_005fupdate_005fdevice">acc_update_device</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Update device memory from mapped host memory.
    146. 

  146. </td></tr>
    147. 

  147. <tr><td align="left" valign="top">&bull; <a href="acc_005fupdate_005fself.html#acc_005fupdate_005fself">acc_update_self</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Update host memory from mapped device memory.
    148. 

  148. </td></tr>
    149. 

  149. <tr><td align="left" valign="top">&bull; <a href="acc_005fmap_005fdata.html#acc_005fmap_005fdata">acc_map_data</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Map previously allocated device memory to host
    150. 

  150.                                 memory.
    151. 

  151. </td></tr>
    152. 

  152. <tr><td align="left" valign="top">&bull; <a href="acc_005funmap_005fdata.html#acc_005funmap_005fdata">acc_unmap_data</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Unmap device memory from host memory.
    153. 

  153. </td></tr>
    154. 

  154. <tr><td align="left" valign="top">&bull; <a href="acc_005fdeviceptr.html#acc_005fdeviceptr">acc_deviceptr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get device pointer associated with specific
    155. 

  155.                                 host address.
    156. 

  156. </td></tr>
    157. 

  157. <tr><td align="left" valign="top">&bull; <a href="acc_005fhostptr.html#acc_005fhostptr">acc_hostptr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get host pointer associated with specific
    158. 

  158.                                 device address.
    159. 

  159. </td></tr>
    160. 

  160. <tr><td align="left" valign="top">&bull; <a href="acc_005fis_005fpresent.html#acc_005fis_005fpresent">acc_is_present</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Indiciate whether host variable / array is
    161. 

  161.                                 present on device.
    162. 

  162. </td></tr>
    163. 

  163. <tr><td align="left" valign="top">&bull; <a href="acc_005fmemcpy_005fto_005fdevice.html#acc_005fmemcpy_005fto_005fdevice">acc_memcpy_to_device</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Copy host memory to device memory.
    164. 

  164. </td></tr>
    165. 

  165. <tr><td align="left" valign="top">&bull; <a href="acc_005fmemcpy_005ffrom_005fdevice.html#acc_005fmemcpy_005ffrom_005fdevice">acc_memcpy_from_device</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Copy device memory to host memory.
    166. 

  166. </td></tr>
    167. 

  167. <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
    168. 

  168. API routines for target platforms.
    169. 

  169. 

  170. </pre></th></tr><tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fcurrent_005fcuda_005fdevice.html#acc_005fget_005fcurrent_005fcuda_005fdevice">acc_get_current_cuda_device</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get CUDA device handle.
    171. 

  171. </td></tr>
    172. 

  172. <tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fcurrent_005fcuda_005fcontext.html#acc_005fget_005fcurrent_005fcuda_005fcontext">acc_get_current_cuda_context</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get CUDA context handle.
    173. 

  173. </td></tr>
    174. 

  174. <tr><td align="left" valign="top">&bull; <a href="acc_005fget_005fcuda_005fstream.html#acc_005fget_005fcuda_005fstream">acc_get_cuda_stream</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Get CUDA stream handle.
    175. 

  175. </td></tr>
    176. 

  176. <tr><td align="left" valign="top">&bull; <a href="acc_005fset_005fcuda_005fstream.html#acc_005fset_005fcuda_005fstream">acc_set_cuda_stream</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Set CUDA stream handle.
    177. 

  177. </td></tr>
    178. 

  178. </table>
    179. 

  179. 

  180. 

  181. 

  182. <hr>
    183. 

  183. <div class="header">
    184. 

  184. <p>
    185. 

  185. Next: <a href="OpenACC-Environment-Variables.html#OpenACC-Environment-Variables" accesskey="n" rel="next">OpenACC Environment Variables</a>, Previous: <a href="Enabling-OpenACC.html#Enabling-OpenACC" accesskey="p" rel="prev">Enabling OpenACC</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Library-Index.html#Library-Index" title="Index" rel="index">Index</a>]</p>
    186. 

  186. </div>
    187. 

  187. 

  188. 

  189. 

  190. </body>
    191. 

  191. </html>
    192.