<div dir="ltr">I know this is more work, but would it be possible to split all the testing stuff out into a totally separate page on the sidebar?<br></div><br><div class="gmail_quote">On Tue, Apr 7, 2015 at 9:35 AM Pavel Labath <<a href="mailto:labath@google.com">labath@google.com</a>> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi tberghammer, zturner,<br>
<br>
<a href="http://reviews.llvm.org/D8873" target="_blank">http://reviews.llvm.org/D8873</a><br>
<br>
Files:<br>
  www/build.html<br>
<br>
Index: www/build.html<br>
==============================<u></u>==============================<u></u>=======<br>
--- www/build.html<br>
+++ www/build.html<br>
@@ -402,6 +402,45 @@<br>
             <code><br>
               <br />&gt; python dotest.py -h<br>
             </code><br>
+<br>
+            <p><br>
+              Besides <code>dotest.py</code>, there is also <code>dosep.py</code>, which runs<br>
+              multiple instances of <code>dotest.py</code> in parallel, thereby greatly<br>
+              decreasing the time it takes to run the full testsuite. The number of concurrent<br>
+              tests is controlled by the <code>LLDB_TEST_THREADS</code> environment variable and<br>
+              defaults to the number of CPUs on your system. To pass additional options to<br>
+              <code>dotest.py</code>, specify those options as an <code>-o</code> argument to<br>
+              <code>dosep.py</code>. For example, the command<br>
+            </p><br>
+            <code>python dosep.py -o "--executable bin/lldb -C bin/clang"</code><br>
+            <p><br>
+              will specify the lldb and clang executables to test for each dotest invocation.<br>
+              <code>ninja check-lldb</code> is wrapper around <code>dosep.py</code>.<br>
+            </p><br>
+<br>
+            <h3>Running the test-suite remotely</h3><br>
+<br>
+            <p><br>
+              Running the test-suite remotely is supported both with <code>dotest.py</code> and<br>
+              <code>dosep.py</code>. The general process is the same as when running a local test<br>
+              suite, but there are two things to have in mind:<br>
+            </p><br>
+            <ul><br>
+              <li><br>
+                You must have the <code>lldb-server</code> running on the remote system, ready to<br>
+                accept multiple connections. For more information on how to setup remote<br>
+                debugging see the <a href="remote.html">Remote debugging</a> page.<br>
+              </li><br>
+              <li><br>
+                You must tell the test-suite how to connect to the remote system. This is<br>
+                achieved using the <code>--platform-name</code>, <code>--platform-url</code> and<br>
+                <code>--platform-working-dir</<u></u>code> parameters to <code>dotest.py</code>. These<br>
+                parameters correspond to the <code>platform select</code> and <code>platform<br>
+                connect</code> LLDB commands. You will usually also need to specify the compiler and<br>
+                architecture for the remote system.<br>
+              </li><br>
+            </ul><br>
+<br>
             <h2>Building API reference documentation</h2><br>
             <p><br>
               LLDB exposes a C++ as well as a Python API. To build the reference documentation for these two APIs, ensure you have<br>
<br>
EMAIL PREFERENCES<br>
  <a href="http://reviews.llvm.org/settings/panel/emailpreferences/" target="_blank">http://reviews.llvm.org/<u></u>settings/panel/<u></u>emailpreferences/</a><br>
</blockquote></div>