Nvidia-PTX-Options.html 6.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>Using the GNU Compiler Collection (GCC): Nvidia PTX Options</title>
  20. <meta name="description" content="Using the GNU Compiler Collection (GCC): Nvidia PTX Options">
  21. <meta name="keywords" content="Using the GNU Compiler Collection (GCC): Nvidia PTX Options">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Submodel-Options.html#Submodel-Options" rel="up" title="Submodel Options">
  30. <link href="PDP_002d11-Options.html#PDP_002d11-Options" rel="next" title="PDP-11 Options">
  31. <link href="Nios-II-Options.html#Nios-II-Options" rel="prev" title="Nios II Options">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="Nvidia-PTX-Options"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="PDP_002d11-Options.html#PDP_002d11-Options" accesskey="n" rel="next">PDP-11 Options</a>, Previous: <a href="Nios-II-Options.html#Nios-II-Options" accesskey="p" rel="prev">Nios II Options</a>, Up: <a href="Submodel-Options.html#Submodel-Options" accesskey="u" rel="up">Submodel Options</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  66. </div>
  67. <hr>
  68. <a name="Nvidia-PTX-Options-1"></a>
  69. <h4 class="subsection">3.18.33 Nvidia PTX Options</h4>
  70. <a name="index-Nvidia-PTX-options"></a>
  71. <a name="index-nvptx-options"></a>
  72. <p>These options are defined for Nvidia PTX:
  73. </p>
  74. <dl compact="compact">
  75. <dt><code>-m32</code></dt>
  76. <dt><code>-m64</code></dt>
  77. <dd><a name="index-m32"></a>
  78. <a name="index-m64"></a>
  79. <p>Generate code for 32-bit or 64-bit ABI.
  80. </p>
  81. </dd>
  82. <dt><code>-mmainkernel</code></dt>
  83. <dd><a name="index-mmainkernel"></a>
  84. <p>Link in code for a __main kernel. This is for stand-alone instead of
  85. offloading execution.
  86. </p>
  87. </dd>
  88. <dt><code>-moptimize</code></dt>
  89. <dd><a name="index-moptimize"></a>
  90. <p>Apply partitioned execution optimizations. This is the default when any
  91. level of optimization is selected.
  92. </p>
  93. </dd>
  94. <dt><code>-msoft-stack</code></dt>
  95. <dd><a name="index-msoft_002dstack"></a>
  96. <p>Generate code that does not use <code>.local</code> memory
  97. directly for stack storage. Instead, a per-warp stack pointer is
  98. maintained explicitly. This enables variable-length stack allocation (with
  99. variable-length arrays or <code>alloca</code>), and when global memory is used for
  100. underlying storage, makes it possible to access automatic variables from other
  101. threads, or with atomic instructions. This code generation variant is used
  102. for OpenMP offloading, but the option is exposed on its own for the purpose
  103. of testing the compiler; to generate code suitable for linking into programs
  104. using OpenMP offloading, use option <samp>-mgomp</samp>.
  105. </p>
  106. </dd>
  107. <dt><code>-muniform-simt</code></dt>
  108. <dd><a name="index-muniform_002dsimt"></a>
  109. <p>Switch to code generation variant that allows to execute all threads in each
  110. warp, while maintaining memory state and side effects as if only one thread
  111. in each warp was active outside of OpenMP SIMD regions. All atomic operations
  112. and calls to runtime (malloc, free, vprintf) are conditionally executed (iff
  113. current lane index equals the master lane index), and the register being
  114. assigned is copied via a shuffle instruction from the master lane. Outside of
  115. SIMD regions lane 0 is the master; inside, each thread sees itself as the
  116. master. Shared memory array <code>int __nvptx_uni[]</code> stores all-zeros or
  117. all-ones bitmasks for each warp, indicating current mode (0 outside of SIMD
  118. regions). Each thread can bitwise-and the bitmask at position <code>tid.y</code>
  119. with current lane index to compute the master lane index.
  120. </p>
  121. </dd>
  122. <dt><code>-mgomp</code></dt>
  123. <dd><a name="index-mgomp"></a>
  124. <p>Generate code for use in OpenMP offloading: enables <samp>-msoft-stack</samp> and
  125. <samp>-muniform-simt</samp> options, and selects corresponding multilib variant.
  126. </p>
  127. </dd>
  128. </dl>
  129. <hr>
  130. <div class="header">
  131. <p>
  132. Next: <a href="PDP_002d11-Options.html#PDP_002d11-Options" accesskey="n" rel="next">PDP-11 Options</a>, Previous: <a href="Nios-II-Options.html#Nios-II-Options" accesskey="p" rel="prev">Nios II Options</a>, Up: <a href="Submodel-Options.html#Submodel-Options" accesskey="u" rel="up">Submodel Options</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  133. </div>
  134. </body>
  135. </html>