Add note about setting up linux systems to directly execute LLVM bytecode files

Fixes PR303


git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@12516 91177308-0d34-0410-b5e6-96231b3b80d8

1 files changed, 34 insertions, 4 deletions

diff --git a/docs/GettingStarted.html b/docs/GettingStarted.html
index 2e04c9ea65..6490c0cf28 100644
--- a/docs/GettingStarted.html
+++ b/docs/GettingStarted.html
@@ -30,6 +30,7 @@
       <li><a href="#config">Local LLVM Configuration</a>
       <li><a href="#compile">Compiling the LLVM Suite Source Code</a>
       <li><a href="#objfiles">The Location of LLVM Object Files</a>
+      <li><a href="#optionalconfig">Optional Configuration Items</a>
     </ol></li>
 
   <li><a href="#layout">Program layout</a>
@@ -49,11 +50,11 @@
 </ul>
 
 <p>By: 
-  <a href="mailto:gshi1@uiuc.edu">Guochun Shi</a>,
-  <a href="mailto:sabre@nondot.org">Chris Lattner</a>,
   <a href="mailto:criswell@uiuc.edu">John Criswell</a>, 
-  <a href="http://misha.brukman.net">Misha Brukman</a>, and
-  <a href="http://www.cs.uiuc.edu/~vadve">Vikram Adve</a>.</p>
+  <a href="mailto:sabre@nondot.org">Chris Lattner</a>,
+  <a href="http://misha.brukman.net">Misha Brukman</a>, 
+  <a href="http://www.cs.uiuc.edu/~vadve">Vikram Adve</a>, and
+  <a href="mailto:gshi1@uiuc.edu">Guochun Shi</a>.</p>
 
 
 <!-- *********************************************************************** -->
@@ -765,6 +766,35 @@ named after the build type:</p>
 
 </div>
 
+<!-- ======================================================================= -->
+<div class="doc_subsection">
+  <a name="optionalconfig">Optional Configuration Items</a>
+</div>
+
+<div class="doc_text">
+
+<p>
+If you're running on a linux system that supports the "<a
+href="http://www.tat.physik.uni-tuebingen.de/~rguenth/linux/binfmt_misc.html">binfmt_misc</a>"
+module, and you have root access on the system, you can set your system up to
+execute LLVM bytecode files directly.  To do this, use commands like this (the
+first command may not be required if you are already using the module):</p>
+
+<pre>
+   $ mount -t binfmt_misc none /proc/sys/fs/binfmt_misc
+   $ echo ':llvm:M::llvm::/path/to/lli:' > /proc/sys/fs/binfmt_misc/register
+   $ chmod u+x hello.bc                (if needed)
+   $ ./hello.bc
+</pre>
+
+<p>
+This allows you to execute LLVM bytecode files directly.  Thanks to Jack
+Cummings for pointing this out!
+</p>
+
+</div>
+
+
 <!-- *********************************************************************** -->
 <div class="doc_section">
   <a name="layout"><b>Program Layout</b></a>