2011/11/23 Chandler Carruth <span dir="ltr"><<a href="mailto:chandlerc@google.com" target="_blank">chandlerc@google.com</a>></span><br><div class="gmail_quote"><div class="gmail_quote"><div><div class="h5"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

It has come up when reviewing Kostya's patch to add the necessary support fort linking in the Address Sanitizer runtime library that we need a proper scheme and plan for deploying runtime libraries along with Clang.<div>


<br></div><div>I've CC'ed llvmdev on this for compiler-rt developers' input.</div><div><br></div><div>The key issues I see when locating runtime libraries are the following:</div><div><br></div><div>- These libraries should be shipped with Clang, not installed separately on the system.</div>


<div>- They are likely to be somewhat tied to specific versions of Clang/LLVM.</div><div>- To support cross-compiling, we should be able to install multiple copies of these libraries in a single Clang installation, and use the appropriate one when targeting a particular platform.</div>


<div>- The above cross-compiling concern extends to ABI compatibility -- many of the ABIs are already fixed in this space.</div><div>- These are different from builtin header files which can use the preprocessor to internally differentiate their contents based on the target platform.</div>


<div><br></div><div>My proposed solution:</div><div><br></div><div>- Base the path on the shared "resource directory" concept which already exists in Clang.</div><div>  - Builtin header files are at <ResourceDir>/include already.</div>


<div>- Append a "base" triple directory name.</div><div>- Append a "lib" directory name for runtime libraries</div><div>- Place the runtime libraries as "libcompiler_rt_<sublib>.a" for each sub-library component "<sublib>".</div>


<div><br></div><div>Example for "x/bin/clang" installation:</div><div>  x/bin/../lib/clang/3.1/x86_64-linux-gnu/lib/libcompiler_rt_asan.a</div><div><br></div><div>What is a "base" triple? It is the simplest form we can reduce a triple to while guaranteeing compatibility. The concept is best explained by an example. All of the following triples reduce to the base triple of "x86_64-linux-gnu":</div>


<div>  x86_64-linux-gnu</div><div>  x86_64-pc-linux-gnu</div><div>  x86_64-unknown-linux-gnu</div><div>  x86_64-redhat-linux</div><div>  x86_64-redhat-linux6E</div><div>  ...</div><div><br></div><div>A different ABI could be expressed much like ARM's is with the last element: "*-gnueabi". This would *not* reduce to the triple ending in '-gnu'. Due to the adhoc and poorly spec'ed nature of existing triples, this will largely be a fixed mapping much like already exists in the Clang driver, but consolidated into LLVM's core triple logic.</div>

</blockquote></div></div><div><br>This does kind of push the GNU triple language on LLVM/Clang internally, although the jury was still out on the true specification for cross-compiling platform names. Although internal, it really will keep spreading like a "disease" to more exposed parts of Clang.<br>

<br></div><div class="im"><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div><br></div><div><br></div><div>Open Questions:</div><div><br></div><div>How do we handle 'i686' vs 'i386'? Is it useful to have separate installed libraries for i386 and i686 in order to get better performance for the latter *and* maintain compatibility for the former? We could collapse to either i386 or i686, and define either to mean whatever we want (for example, Debian uses i386-linux-gnu for its "base" triple in multiarch, and does *not* support i386 processors).</div>

</blockquote></div><div><br>This difference is so 1990's; Debian is stubborn and they even use  completely different triple names by default, just to be different. It's not an example to follow by far...<br></div>
<div class="im"><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">

<div><br></div><div>This scheme closely mirrors GCC's existing scheme with one exception: GCC puts the triple first, and the version number second. I don't think this matters greatly either way, but currently Clang puts its version number first. I think this reflects the inherent design of Clang to be cross-compiling by default, but it would be good to consider (even if we reject) matching GCC's behavior here.</div>

</blockquote></div><div><br>I don't see what influence this has on anything but internal design: LLVM/Clang should really decide for itself. Version/Target sounds like the "right" choice for the reason you say.<br>

<br></div><div class="im"><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div><br></div><div>Should runtime libraries be installed as archives? .o files? .so files? (gasp) bitcode? Some mixture of these? What mixture, and how do we decide? I lean  toward .o files as bitcode where the linker supports it, normal .o files where it supports those, and .a files only as a fallback. Not very confident of these preferences though.</div>

</blockquote></div><div><br>libraries -> .a/so files... They're target specific anyways, why even consider bitcode?<br><br>Ruben<br><br></div><blockquote class="gmail_quote" style="margin:0pt 0pt 0pt 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">


<br>_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@cs.uiuc.edu" target="_blank">cfe-dev@cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/cfe-dev</a><br>
<br></blockquote></div><br>
</div><br>