instructions.html 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Language" content="en-us">
  4. <meta name="GENERATOR" content="Microsoft FrontPage 5.0">
  5. <meta name="ProgId" content="FrontPage.Editor.Document">
  6. <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
  7. <title>Running Boost Regression Tests</title>
  8. <link rel="stylesheet" type="text/css" href="../../../doc/html/minimal.css">
  9. </head>
  10. <body>
  11. <table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="831">
  12. <tr>
  13. <td width="277">
  14. <a href="../../../../index.htm">
  15. <img src="../../../boost.png" alt="boost.png (6897 bytes)" align="middle" width="277" height="86" border="0"></a></td>
  16. <td width="531" align="middle">
  17. <font size="7">Running Boost Regression Tests</font>
  18. </td>
  19. </tr>
  20. </table>
  21. <h2>Requirements</h2>
  22. <ul>
  23. <li>Python 2.3 or later.<br>
  24. &nbsp;</li>
  25. <li>Subversion 1.4 or later.<br>
  26. &nbsp;</li>
  27. <li>At least 5 gigabytes of disk space per compiler to be tested.</li>
  28. </ul>
  29. <h2>Step by step instructions</h2>
  30. <ol>
  31. <li>Create a new directory for the branch you want to test.<br>
  32. &nbsp;</li>
  33. <li>Download the
  34. <a href="http://svn.boost.org/svn/boost/trunk/tools/regression/src/run.py">
  35. run.py</a> script into that directory.<br>
  36. &nbsp;</li>
  37. <li>Run &quot;<code>python run.py [options] [commands]</code>&quot;.</li>
  38. </ol>
  39. <dl>
  40. <dd>
  41. <pre>commands: cleanup, collect-logs, get-source, get-tools, patch,
  42. regression, setup, show-revision, test, test-clean, test-process,
  43. test-run, update-source, upload-logs
  44. options:
  45. -h, --help show this help message and exit
  46. --runner=RUNNER runner ID (e.g. 'Metacomm')
  47. --comment=COMMENT an HTML comment file to be inserted in the
  48. reports
  49. --tag=TAG the tag for the results
  50. --toolsets=TOOLSETS comma-separated list of toolsets to test with
  51. --incremental do incremental run (do not remove previous
  52. binaries)
  53. --timeout=TIMEOUT specifies the timeout, in minutes, for a single
  54. test run/compilation
  55. --bjam-options=BJAM_OPTIONS
  56. options to pass to the regression test
  57. --bjam-toolset=BJAM_TOOLSET
  58. bootstrap toolset for 'bjam' executable
  59. --pjl-toolset=PJL_TOOLSET
  60. bootstrap toolset for 'process_jam_log'
  61. executable
  62. --platform=PLATFORM
  63. --user=USER Boost SVN user ID
  64. --local=LOCAL the name of the boost tarball
  65. --force-update=FORCE_UPDATE
  66. do an SVN update (if applicable) instead of a
  67. clean checkout, even when performing a full run
  68. --have-source=HAVE_SOURCE
  69. do neither a tarball download nor an SVN update;
  70. used primarily for testing script changes
  71. --proxy=PROXY HTTP proxy server address and port
  72. (e.g.'<a rel="nofollow" href="http://www.someproxy.com:3128'" target="_top">http://www.someproxy.com:3128'</a>)
  73. --ftp-proxy=FTP_PROXY
  74. FTP proxy server (e.g. 'ftpproxy')
  75. --dart-server=DART_SERVER
  76. the dart server to send results to
  77. --debug-level=DEBUG_LEVEL
  78. debugging level; controls the amount of
  79. debugging output printed
  80. --send-bjam-log send full bjam log of the regression run
  81. --mail=MAIL email address to send run notification to
  82. --smtp-login=SMTP_LOGIN
  83. STMP server address/login information, in the
  84. following form:
  85. &lt;user&gt;:&lt;password&gt;@&lt;host&gt;[:&lt;port&gt;]
  86. --skip-tests=SKIP_TESTS
  87. do not run bjam; used for testing script changes</pre>
  88. </dd>
  89. </dl>
  90. <p>To test trunk use &quot;<code>--tag=trunk</code>&quot; (the default), and to test the
  91. release use &quot;<code>--tag=branches/release</code>&quot;. Or substitute any Boost tree
  92. of your choice.</p>
  93. <hr>
  94. <p>© Copyright Rene Rivera, 2007<br>
  95. Distributed under the Boost Software License, Version 1.0. See
  96. <a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a></p>
  97. <p>Revised
  98. <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%B %d, %Y" startspan -->November 23, 2007<!--webbot bot="Timestamp" endspan i-checksum="39587" --> </font>
  99. </p>
  100. </body>
粤ICP备19079148号