1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-29 19:30:36 +02:00
Mirror of the upstream GNU Guile repository on Savannah. https://www.gnu.org/software/guile/
Find a file
Tony Garnock-Jones 2c0126e3ef aarch64: Fix swap_atomic retry
* lightening/aarch64-cpu.c (swap_atomic): If the swap fails, and the dst
register was the same as the val, we would stomple val during the retry.
Fixes https://github.com/wingo/fibers/issues/83#issuecomment-2068847127.
2024-04-22 15:03:01 +02:00
lightening aarch64: Fix swap_atomic retry 2024-04-22 15:03:01 +02:00
tests Fix jmp-shortening on x64 when target within instruction. 2021-01-07 11:04:17 +01:00
.gitignore Rework naming of test suite files 2019-03-26 10:02:30 +01:00
.gitlab-ci.yml Fix CI 2024-04-22 15:03:01 +02:00
AUTHORS Prepare for the first alpha release of lightning 2.0. 2013-06-05 20:18:54 -03:00
ChangeLog Archive lightning ChangeLog 2018-10-30 11:42:08 +01:00
ChangeLog.lightning Archive lightning ChangeLog 2018-10-30 11:42:08 +01:00
COPYING switch to GPLv3 2008-01-09 15:50:13 +01:00
COPYING.DOC update FSF address 2008-01-09 15:49:29 +01:00
COPYING.LESSER switch to GPLv3 2008-01-09 15:50:13 +01:00
lightening.am Add includable automake file 2019-05-23 10:02:00 +02:00
lightening.h Allow jit_begin_data to declare max data size 2020-07-30 13:41:02 +02:00
lightning.texi Move lightning.texi up to root, and remove Makefile.am 2018-10-30 11:35:53 +01:00
NEWS Second alpha release 1.99a 2013-07-08 11:58:03 -03:00
README.md Update README 2019-05-20 15:45:51 +02:00
THANKS Implement a correct generation of Fibonacci numbers. 2015-11-30 15:32:48 -02:00

Lightening

Lightening is a just-in-time code generation library derived from GNU Lightning, adapted to the purposes of the GNU Guile project.

Use

gcc -flto -O2 -g -o lightening.o -c lightening/lightening.c
gcc -flto -O2 -g -o my-program lightening.o my-program.c

See the GNU Lightning manual for more on how to program against Lightening (much of the details are the same).

What's the difference with GNU Lightning?

This project is called Lightening because it's lighter-weight than GNU Lightning. When you go to generate code at run-time with GNU Lightning, what happens is that you build up a graph of nodes which GNU Lightning "optimizes" before finally emitting machine code. These optimizations can improve register allocation around call sites. However they are not helpful from a Guile perspective, as they get in the way of register allocation that we need to do; and they actually prevent access to all the registers that we would like to have.

Guile needs a simple, light-weight code generation library. The GNU Lightning architecture-specific backends provide the bulk of this functionality, and Lightening wraps it all in a lightweight API.

Supported targets

Lightening can generate code for the x86-64, i686, ARMv7, and AArch64 architectures. It supports the calling conventions of MS Windows, GNU/Linux, and Mac OS.

On i686, Lightening requires SSE support. On ARMv7, we require hardware floating-point support (the VFP instructions), as well as the UDIV/SDIV instructions.

Lightening is automatically tested using GitLab's continuous integration for under the supported architectures, for GNU/Linux; for a list of recent jobs, see the CI page.

Future targets

Lightening has some inherited code from GNU Lightning for MIPS, PPC64, and s390. Patches to adapt this code to the Lightening code structure are quite welcome.

RISC-V support would be fun too.

Status

Lightening is used in GNU Guile since version 2.9.2 and seems to work well.