Google Git
Sign in
kernel/pub/scm/libs/librseq/librseq

Restartable Sequences Library

Mirrored from git://git.kernel.org/pub/scm/libs/librseq/librseq.git
Clone this repo:

Branches

  1. 5d2eef6 Fix: use weak symbol rather than dlsym to detect libc rseq support by Mathieu Desnoyers · 2 weeks ago master
  2. 4f66a1b Fix: check whether rseq is registered in rseq_clear_rseq_cs by Mathieu Desnoyers · 2 weeks ago
  3. cb08c44 Fix rseq_registered() to compare rseq_size as signed by Mathieu Desnoyers · 6 weeks ago
  4. 2ca6d37 Add 'rseq-status' cli tool by Michael Jeanson · 6 months ago
  5. ee2bb12 Add 'slice_control' feature to the ABI by Michael Jeanson · 6 months 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

Running the test suite

To run the test suite after a successful build:

make check

The default list of tests to run can be overriden by the TESTS variable:

make check TESTS="run_unregistered_test.tap"