Restartable Sequences Library

Clone this repo:
  1. 616a244 cleanup: wrong comment for RSEQ_ASM_STORE_RSEQ_CS by Michael Jeanson · 5 weeks ago master
  2. 0f70b78 Add 64bit LoongArch support by Michael Jeanson · 7 months ago
  3. 7368642 Add missing unistd.h include to rseq-utils.h by Mathieu Desnoyers · 6 weeks ago
  4. bf92d8f Add missing include to rseq-utils.h by Mathieu Desnoyers · 6 weeks ago
  5. 346710e Fix copy-paste error in __RSEQ_ASM_DEFINE_TABLE by Artem Labazov · 8 weeks ago

Library for Restartable Sequences

by Mathieu Desnoyers

Required and optional dependencies

The following dependencies are optional:

  • libnuma To build without this dependency run ./configure with --disable-numa
  • libseccomp

Building

Prerequisites

This source tree is based on the Autotools suite from GNU to simplify portability. Here are some things you should have on your system in order to compile the Git repository tree:

  • GNU Autotools (Automake >= 1.12, Autoconf >= 2.69, Autoheader >= 2.69; make sure your system-wide automake points to a recent version!)
  • GNU Libtool >= 2.2
  • GNU Make
  • pkg-config
  • Linux kernel headers from kernel >= 4.18 to build on x86, arm, ppc, and mips and from kernel >= 4.19 to build on s390.

Building steps

If you get the tree from the Git repository, you will need to run

./bootstrap

in its root. It calls all the GNU tools needed to prepare the tree configuration.

To build and install, do:

./configure
make
sudo make install
sudo ldconfig

Note: the configure script sets /usr/local as the default prefix for files it installs. However, this path is not part of most distributions' default library path, which will cause builds depending on librseq to fail unless -L/usr/local/lib is added to LDFLAGS. You may provide a custom prefix to configure by using the --prefix switch (e.g., --prefix=/usr).

Building against a local version of the kernel headers

cd /path/to/kernel/sources
make headers_install
cd /path/to/librseq
CPPFLAGS=-I/path/to/kernel/sources/usr/include ./configure
make
sudo make install
sudo ldconfig