diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/LangRef.html | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/LangRef.html b/docs/LangRef.html index b1bc1687c4..137046fb7a 100644 --- a/docs/LangRef.html +++ b/docs/LangRef.html @@ -2516,6 +2516,31 @@ call void asm alignstack "eieio", ""() documented here. Constraints on what can be done (e.g. duplication, moving, etc need to be documented). This is probably best done by reference to another document that covers inline asm from a holistic perspective.</p> +</div> + +<div class="doc_subsubsection"> +<a name="inlineasm_md">Inline Asm Metadata</a> +</div> + +<div class="doc_text"> + +<p>The call instructions that wrap inline asm nodes may have a "!srcloc" MDNode + attached to it that contains a constant integer. If present, the code + generator will use the integer as the location cookie value when report + errors through the LLVMContext error reporting mechanisms. This allows a + front-end to corrolate backend errors that occur with inline asm back to the + source code that produced it. For example:</p> + +<div class="doc_code"> +<pre> +call void asm sideeffect "something bad", ""()<b>, !srcloc !42</b> +... +!42 = !{ i32 1234567 } +</pre> +</div> + +<p>It is up to the front-end to make sense of the magic numbers it places in the + IR.</p> </div> |