IA_002d64-Options.html 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- This file documents the GNU Assembler "as".
  4. Copyright (C) 1991-2017 Free Software Foundation, Inc.
  5. Permission is granted to copy, distribute and/or modify this document
  6. under the terms of the GNU Free Documentation License, Version 1.3
  7. or any later version published by the Free Software Foundation;
  8. with no Invariant Sections, with no Front-Cover Texts, and with no
  9. Back-Cover Texts. A copy of the license is included in the
  10. section entitled "GNU Free Documentation License".
  11. -->
  12. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  13. <head>
  14. <title>Using as: IA-64 Options</title>
  15. <meta name="description" content="Using as: IA-64 Options">
  16. <meta name="keywords" content="Using as: IA-64 Options">
  17. <meta name="resource-type" content="document">
  18. <meta name="distribution" content="global">
  19. <meta name="Generator" content="makeinfo">
  20. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  21. <link href="index.html#Top" rel="start" title="Top">
  22. <link href="AS-Index.html#AS-Index" rel="index" title="AS Index">
  23. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  24. <link href="IA_002d64_002dDependent.html#IA_002d64_002dDependent" rel="up" title="IA-64-Dependent">
  25. <link href="IA_002d64-Syntax.html#IA_002d64-Syntax" rel="next" title="IA-64 Syntax">
  26. <link href="IA_002d64_002dDependent.html#IA_002d64_002dDependent" rel="prev" title="IA-64-Dependent">
  27. <style type="text/css">
  28. <!--
  29. a.summary-letter {text-decoration: none}
  30. blockquote.smallquotation {font-size: smaller}
  31. div.display {margin-left: 3.2em}
  32. div.example {margin-left: 3.2em}
  33. div.indentedblock {margin-left: 3.2em}
  34. div.lisp {margin-left: 3.2em}
  35. div.smalldisplay {margin-left: 3.2em}
  36. div.smallexample {margin-left: 3.2em}
  37. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  38. div.smalllisp {margin-left: 3.2em}
  39. kbd {font-style:oblique}
  40. pre.display {font-family: inherit}
  41. pre.format {font-family: inherit}
  42. pre.menu-comment {font-family: serif}
  43. pre.menu-preformatted {font-family: serif}
  44. pre.smalldisplay {font-family: inherit; font-size: smaller}
  45. pre.smallexample {font-size: smaller}
  46. pre.smallformat {font-family: inherit; font-size: smaller}
  47. pre.smalllisp {font-size: smaller}
  48. span.nocodebreak {white-space:nowrap}
  49. span.nolinebreak {white-space:nowrap}
  50. span.roman {font-family:serif; font-weight:normal}
  51. span.sansserif {font-family:sans-serif; font-weight:normal}
  52. ul.no-bullet {list-style: none}
  53. -->
  54. </style>
  55. </head>
  56. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  57. <a name="IA_002d64-Options"></a>
  58. <div class="header">
  59. <p>
  60. Next: <a href="IA_002d64-Syntax.html#IA_002d64-Syntax" accesskey="n" rel="next">IA-64 Syntax</a>, Up: <a href="IA_002d64_002dDependent.html#IA_002d64_002dDependent" accesskey="u" rel="up">IA-64-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  61. </div>
  62. <hr>
  63. <a name="Options-11"></a>
  64. <h4 class="subsection">9.18.1 Options</h4>
  65. <a name="index-IA_002d64-options"></a>
  66. <a name="index-options-for-IA_002d64"></a>
  67. <dl compact="compact">
  68. <dd><a name="index-_002dmconstant_002dgp-command-line-option_002c-IA_002d64"></a>
  69. </dd>
  70. <dt><samp>-mconstant-gp</samp></dt>
  71. <dd><p>This option instructs the assembler to mark the resulting object file
  72. as using the &ldquo;constant GP&rdquo; model. With this model, it is assumed
  73. that the entire program uses a single global pointer (GP) value. Note
  74. that this option does not in any fashion affect the machine code
  75. emitted by the assembler. All it does is turn on the EF_IA_64_CONS_GP
  76. flag in the ELF file header.
  77. </p>
  78. </dd>
  79. <dt><samp>-mauto-pic</samp></dt>
  80. <dd><p>This option instructs the assembler to mark the resulting object file
  81. as using the &ldquo;constant GP without function descriptor&rdquo; data model.
  82. This model is like the &ldquo;constant GP&rdquo; model, except that it
  83. additionally does away with function descriptors. What this means is
  84. that the address of a function refers directly to the function&rsquo;s code
  85. entry-point. Normally, such an address would refer to a function
  86. descriptor, which contains both the code entry-point and the GP-value
  87. needed by the function. Note that this option does not in any fashion
  88. affect the machine code emitted by the assembler. All it does is
  89. turn on the EF_IA_64_NOFUNCDESC_CONS_GP flag in the ELF file header.
  90. </p>
  91. </dd>
  92. <dt><samp>-milp32</samp></dt>
  93. <dt><samp>-milp64</samp></dt>
  94. <dt><samp>-mlp64</samp></dt>
  95. <dt><samp>-mp64</samp></dt>
  96. <dd><p>These options select the data model. The assembler defaults to <code>-mlp64</code>
  97. (LP64 data model).
  98. </p>
  99. </dd>
  100. <dt><samp>-mle</samp></dt>
  101. <dt><samp>-mbe</samp></dt>
  102. <dd><p>These options select the byte order. The <code>-mle</code> option selects little-endian
  103. byte order (default) and <code>-mbe</code> selects big-endian byte order. Note that
  104. IA-64 machine code always uses little-endian byte order.
  105. </p>
  106. </dd>
  107. <dt><samp>-mtune=itanium1</samp></dt>
  108. <dt><samp>-mtune=itanium2</samp></dt>
  109. <dd><p>Tune for a particular IA-64 CPU, <var>itanium1</var> or <var>itanium2</var>. The
  110. default is <var>itanium2</var>.
  111. </p>
  112. </dd>
  113. <dt><samp>-munwind-check=warning</samp></dt>
  114. <dt><samp>-munwind-check=error</samp></dt>
  115. <dd><p>These options control what the assembler will do when performing
  116. consistency checks on unwind directives. <code>-munwind-check=warning</code>
  117. will make the assembler issue a warning when an unwind directive check
  118. fails. This is the default. <code>-munwind-check=error</code> will make the
  119. assembler issue an error when an unwind directive check fails.
  120. </p>
  121. </dd>
  122. <dt><samp>-mhint.b=ok</samp></dt>
  123. <dt><samp>-mhint.b=warning</samp></dt>
  124. <dt><samp>-mhint.b=error</samp></dt>
  125. <dd><p>These options control what the assembler will do when the &lsquo;<samp>hint.b</samp>&rsquo;
  126. instruction is used. <code>-mhint.b=ok</code> will make the assembler accept
  127. &lsquo;<samp>hint.b</samp>&rsquo;. <code>-mint.b=warning</code> will make the assembler issue a
  128. warning when &lsquo;<samp>hint.b</samp>&rsquo; is used. <code>-mhint.b=error</code> will make
  129. the assembler treat &lsquo;<samp>hint.b</samp>&rsquo; as an error, which is the default.
  130. </p>
  131. </dd>
  132. <dt><samp>-x</samp></dt>
  133. <dt><samp>-xexplicit</samp></dt>
  134. <dd><p>These options turn on dependency violation checking.
  135. </p>
  136. </dd>
  137. <dt><samp>-xauto</samp></dt>
  138. <dd><p>This option instructs the assembler to automatically insert stop bits where necessary
  139. to remove dependency violations. This is the default mode.
  140. </p>
  141. </dd>
  142. <dt><samp>-xnone</samp></dt>
  143. <dd><p>This option turns off dependency violation checking.
  144. </p>
  145. </dd>
  146. <dt><samp>-xdebug</samp></dt>
  147. <dd><p>This turns on debug output intended to help tracking down bugs in the dependency
  148. violation checker.
  149. </p>
  150. </dd>
  151. <dt><samp>-xdebugn</samp></dt>
  152. <dd><p>This is a shortcut for -xnone -xdebug.
  153. </p>
  154. </dd>
  155. <dt><samp>-xdebugx</samp></dt>
  156. <dd><p>This is a shortcut for -xexplicit -xdebug.
  157. </p>
  158. </dd>
  159. </dl>
  160. <a name="index-IA_002d64-Syntax"></a>
  161. <hr>
  162. <div class="header">
  163. <p>
  164. Next: <a href="IA_002d64-Syntax.html#IA_002d64-Syntax" accesskey="n" rel="next">IA-64 Syntax</a>, Up: <a href="IA_002d64_002dDependent.html#IA_002d64_002dDependent" accesskey="u" rel="up">IA-64-Dependent</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AS-Index.html#AS-Index" title="Index" rel="index">Index</a>]</p>
  165. </div>
  166. </body>
  167. </html>