Skip to content

Releases

v0.3.2

Choose a tag to compare

@github-actions github-actions released this 29 Oct 23:56

Release 0.3.2

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 9dae328 (the commit of the SLua tree the libraries are built against)
  • API version: 5 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=9dae3285f6 api=5
  • Built from commit: fef0cc6

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.3.2.zip slua_shim.dll
slua-native-linux-x64-0.3.2.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses.zip licences of everything linked into the libraries

What changed since 0.3.1 (API version unchanged at 5)

The exports, their signatures and the API version are the same as in 0.3.1, with one addition: the export slua_restore_note. A host that needs API version 5 loads this library as it loaded the last one, and a host that does not look up the new export is not affected.

  1. A saved script state no longer fails to restore when the host binds more functions than it did when the state was saved. The state header (format version 2) now lists the host functions the state holds, so a restore is refused, with the function's name, only when the state holds a function this build no longer provides or binds it the other way (plain or pausing). Before, any change to the hash of the whole list of bound functions refused the state and the script started fresh.
  2. A state written by 0.3.1 (format version 1) is still read. It carries only the hash of the list, so it restores when the list is the same; when the list has changed it restores unless it mentions a function that this build binds as pausing, and if the Executor cannot rebuild it the script starts fresh and the note says the list had changed.
  3. New export slua_restore_note copies the reason the last slua_restore of a script refused its state into a buffer, so a host can show why a state was set aside and offer to try it again. A library without it answers an entry-point error, which a host treats as no reason given.

v0.3.1

Choose a tag to compare

@github-actions github-actions released this 28 Oct 11:10

Release 0.3.1

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 9dae328 (the commit of the SLua tree the libraries are built against)
  • API version: 5 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=9dae3285f6 api=5
  • Built from commit: 5afc9eb

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.3.1.zip slua_shim.dll
slua-native-linux-x64-0.3.1.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses.zip licences of everything linked into the libraries

What changed since 0.3.0 (API version unchanged at 5)

The exports, their signatures and the API version are the same as in 0.3.0. A host that needs API version 5 loads this library as it loaded the last one.

  1. A script that caught an error with pcall inside an event handler faulted with corrupt yield state once the handler returned. The event dispatcher saved its yield state only when the handler yielded; an error caught by a pcall in the handler unwinds the dispatcher's frame without a yield, and the dispatcher then read a state that was never written. The dispatcher now saves its state before it calls the handler (YIELD_CALL_SAVING_STATE in VM/include/lyieldablemacros.h).
  2. The same defect was in every other yieldable function that calls script code. It now applies to string.gsub with a replacement function, table.sort with a comparison function, lljson.encode (the replacer option and __tojson metamethods), lljson.decode (the reviver) and the LLTimers tick that calls a timer's handler. A callback that caught an error made the function lose its state (corrupt yield state) or read the wrong value: string.gsub kept the original text, table.sort did not reorder, lljson.encode wrote null.
  3. The saved state now also records where the callback's results sit on the frame, and the "yielding" mark that the early save sets is cleared again when the callback returns without a yield, so the chained helpers of table.sort and the JSON functions can use it. A first attempt that only saved the state before every call broke seven of the runtime's own conformance tests for this reason.
  4. ngc-host/LL-RUNTIME-PIN names the commit that carries this change (it changes files of the parent tree), and the stamp's runtime part is that commit. Scripts saved by 0.3.0 start fresh once because the runtime part of the stamp changed.

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 19:04

Release 0.3.0

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 8b40c52 (the commit of the SLua tree the libraries are built against)
  • API version: 5 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=8b40c525bf api=5
  • Built from commit: 688da07

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.3.0.zip slua_shim.dll
slua-native-linux-x64-0.3.0.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses.zip licences of everything linked into the libraries

What changed since 0.2.0 (API version 4 to 5)

The version check is exact: a host that needs API version 5 refuses a library of another version and names both numbers.

  1. New export slua_set_host_functions (and Host.SetHostFunctions in the test binding). The host gives the LSL compiler the os, iw and bot functions it supplies, one per line in the form of builtins.txt (integer osAddOne( integer n )). LSL compiled with the runtime's compiler can then call them as it calls ll functions. A call to osName, iwName or botName runs the host function registered as ossl.Name, iw.Name or bot.Name, which an SLua script calls by that name. ll and llcompat stay the runtime's own: a line that names an ll function, or any name that is not os, iw or bot followed by a capital letter, is refused and the earlier list stays. A name may be listed several times with different parameter types (the same parameter types twice is refused), each with its own result type; an LSL call picks the signature the way the Phlox compiler does (an exact type beats an implicit conversion, integer to float and key to string and back; a tie is a compile error naming the function and both signatures), and all of them run the one host function, which tells the signatures apart by the arguments it gets.
  2. With a list set, a name that is neither in the list nor an ll function fails to compile with its line number. A host that sets no list gets what API 4 gave: an LSL call to an os, iw or bot function is refused with the text that points at the engine that runs such scripts.
  3. The LSL compiler (Compiler/src/LSLCompiler.cpp) takes the module of a builtin call from its prefix: ll for the runtime's functions, ossl, iw or bot for the host's. Because that changes a file of the parent tree, ngc-host/LL-RUNTIME-PIN now names the commit that carries the change and the stamp's runtime part is that commit. Scripts saved by an earlier release start fresh once (the API part of the stamp changed as well).
  4. A release's change list now comes from a file at the tag, ngc-host/release-notes/<version>.md, and is added to the generated release notes. A version without a dash is refused without the file.

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 23:04

Release 0.2.0

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 4116d7f (the commit of the SLua tree the libraries are built against)
  • API version: 4 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=4116d7f6a3 api=4
  • Built from commit: 68bd480

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.2.0.zip slua_shim.dll
slua-native-linux-x64-0.2.0.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses.zip licences of everything linked into the libraries

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 10:25

Release 0.1.0

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 4116d7f (the commit of the SLua tree the libraries are built against)
  • API version: 3 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=4116d7f6a3 api=3
  • Built from commit: 100f9df

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.1.0.zip slua_shim.dll
slua-native-linux-x64-0.1.0.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses.zip licences of everything linked into the libraries

v0.0.1

Choose a tag to compare

@github-actions github-actions released this 26 Oct 09:27

Release 0.0.1

Native library for hosting the SLua runtime: slua_shim for Windows x64 and Linux x64. The package
built from these files carries no managed code; the host binds to the C interface in slua_shim.h.

  • Runtime pin: 4116d7f (the commit of the SLua tree the libraries are built against)
  • API version: 3 (a host must check slua_api_version() for an exact match)
  • Saved-state stamp format: runtime=<pin> api=<n>; slua_version returns the same text,
    here runtime=4116d7f6a3 api=3
  • Built from commit: 9763d02

Every file was built or copied by one CI run from that commit. SHA256SUMS.txt lists the SHA-256 of
every other file in the release (check with sha256sum -c SHA256SUMS.txt).

File Contents
slua-native-win-x64-0.0.1.zip slua_shim.dll
slua-native-linux-x64-0.0.1.tar.gz libslua_shim.so, built on Ubuntu 22.04
slua_shim.h the C interface
THIRD-PARTY-NOTICES.txt, licenses/ licences of everything linked into the libraries