status.html 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
  2. <html>
  3. <head>
  4. <title>Status</title>
  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  6. <meta name="Author" content="Mike Pall">
  7. <meta name="Copyright" content="Copyright (C) 2005-2017, Mike Pall">
  8. <meta name="Language" content="en">
  9. <link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
  10. <link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
  11. <style type="text/css">
  12. ul li { padding-bottom: 0.3em; }
  13. </style>
  14. </head>
  15. <body>
  16. <div id="site">
  17. <a href="http://luajit.org"><span>Lua<span id="logo">JIT</span></span></a>
  18. </div>
  19. <div id="head">
  20. <h1>Status</h1>
  21. </div>
  22. <div id="nav">
  23. <ul><li>
  24. <a href="luajit.html">LuaJIT</a>
  25. <ul><li>
  26. <a href="http://luajit.org/download.html">Download <span class="ext">&raquo;</span></a>
  27. </li><li>
  28. <a href="install.html">Installation</a>
  29. </li><li>
  30. <a href="running.html">Running</a>
  31. </li></ul>
  32. </li><li>
  33. <a href="extensions.html">Extensions</a>
  34. <ul><li>
  35. <a href="ext_ffi.html">FFI Library</a>
  36. <ul><li>
  37. <a href="ext_ffi_tutorial.html">FFI Tutorial</a>
  38. </li><li>
  39. <a href="ext_ffi_api.html">ffi.* API</a>
  40. </li><li>
  41. <a href="ext_ffi_semantics.html">FFI Semantics</a>
  42. </li></ul>
  43. </li><li>
  44. <a href="ext_jit.html">jit.* Library</a>
  45. </li><li>
  46. <a href="ext_c_api.html">Lua/C API</a>
  47. </li><li>
  48. <a href="ext_profiler.html">Profiler</a>
  49. </li></ul>
  50. </li><li>
  51. <a class="current" href="status.html">Status</a>
  52. <ul><li>
  53. <a href="changes.html">Changes</a>
  54. </li></ul>
  55. </li><li>
  56. <a href="faq.html">FAQ</a>
  57. </li><li>
  58. <a href="http://luajit.org/performance.html">Performance <span class="ext">&raquo;</span></a>
  59. </li><li>
  60. <a href="http://wiki.luajit.org/">Wiki <span class="ext">&raquo;</span></a>
  61. </li><li>
  62. <a href="http://luajit.org/list.html">Mailing List <span class="ext">&raquo;</span></a>
  63. </li></ul>
  64. </div>
  65. <div id="main">
  66. <p>
  67. <span style="color: #0000c0;">LuaJIT&nbsp;2.0</span> is the current
  68. <span style="color: #0000c0;">stable branch</span>. This branch is in
  69. feature-freeze &mdash; new features will only be added to LuaJIT&nbsp;2.1.
  70. </p>
  71. <h2>Current Status</h2>
  72. <p>
  73. LuaJIT ought to run all Lua&nbsp;5.1-compatible source code just fine.
  74. It's considered a serious bug if the VM crashes or produces unexpected
  75. results &mdash; please report this.
  76. </p>
  77. <p>
  78. Known incompatibilities and issues in LuaJIT&nbsp;2.0:
  79. </p>
  80. <ul>
  81. <li>
  82. There are some differences in <b>implementation-defined</b> behavior.
  83. These either have a good reason, are arbitrary design choices
  84. or are due to quirks in the VM. The latter cases may get fixed if a
  85. demonstrable need is shown.
  86. </li>
  87. <li>
  88. The Lua <b>debug API</b> is missing a couple of features (return
  89. hooks for non-Lua functions) and shows slightly different behavior
  90. in LuaJIT (no per-coroutine hooks, no tail call counting).
  91. </li>
  92. <li>
  93. Currently some <b>out-of-memory</b> errors from <b>on-trace code</b> are not
  94. handled correctly. The error may fall through an on-trace
  95. <tt>pcall</tt> or it may be passed on to the function set with
  96. <tt>lua_atpanic</tt> on x64. This issue will be fixed with the new
  97. garbage collector.
  98. </li>
  99. <li>
  100. LuaJIT on 64 bit systems provides a <b>limited range</b> of 47 bits for the
  101. <b>legacy <tt>lightuserdata</tt></b> data type.
  102. This is only relevant on x64 systems which use the negative part of the
  103. virtual address space in user mode, e.g. Solaris/x64, and on ARM64 systems
  104. configured with a 48 bit or 52 bit VA.
  105. Avoid using <tt>lightuserdata</tt> to hold pointers that may point outside
  106. of that range, e.g. variables on the stack. In general, avoid this data
  107. type for new code and replace it with (much more performant) FFI bindings.
  108. FFI cdata pointers can address the full 64 bit range.
  109. </li>
  110. </ul>
  111. <br class="flush">
  112. </div>
  113. <div id="foot">
  114. <hr class="hide">
  115. Copyright &copy; 2005-2017 Mike Pall
  116. <span class="noprint">
  117. &middot;
  118. <a href="contact.html">Contact</a>
  119. </span>
  120. </div>
  121. </body>
  122. </html>