pub/scm/libs/librseq/librseq.git  about / heads / tags
Restartable Sequences Library
$ git log --pretty=format:'%h %s (%cs)%d'
589d928 fix: set init_done flag with libc registration (2025-02-06)
	(HEAD -> master)
1b06174 docs: Add optional dependencies to the README (2025-01-28)
7dc6062 docs: Clarify that make is required to build the project (2025-01-28)
6cd6512 Fix: tests: Do not expect allowed cpus to be invariant (2025-01-28)
5385e99 README: Add pkg-config to prerequisites list (2025-01-20)
c65c8f9 tests: resolve errno names in syscall_errors_test (2025-01-20)
2054c3c cleanup: adjust copied comments referencing URCU (2025-01-20)
24b9883 tests: exclude syscall invalid address test on s390 (2025-01-20)
578a5d3 tests: s390: use r0 as scratch register (2025-01-20)
c954c25 x32: cast rseq_offset to long long int (2025-01-11)
...

$ git cat-file blob HEAD:README.md
<!--
SPDX-FileCopyrightText: 2022 EfficiOS Inc.

SPDX-License-Identifier: MIT
-->

Library for Restartable Sequences
=================================

by Mathieu Desnoyers


Required and optional dependencies
----------------------------------

The following dependencies are optional:

  - [libnuma](https://github.com/numactl/numactl)
    To build without this dependency run `./configure` with `--disable-numa`
  - [libseccomp](https://github.com/seccomp/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](http://www.gnu.org/software/autoconf/)
    (**Automake >= 1.12**, **Autoconf >= 2.69**,
    **Autoheader >= 2.69**;
    make sure your system-wide `automake` points to a recent version!)
  - **[GNU Libtool](https://www.gnu.org/software/libtool/) >= 2.2**
  - **[GNU Make](https://www.gnu.org/software/make/)**
  - **[pkg-config](https://www.freedesktop.org/wiki/Software/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

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       fix: set init_done flag with libc registration (2025-02-06)
  rseq-percpu-alloc rseq percpu alloc: Add percpu pool set (2024-02-29)
  pseudo-code  Rename RSEQ_ASM_DEFINE_CMPFAIL to RSEQ_ASM_DEFINE_TEARDOWN (2024-02-25)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
# no tags, yet...

# associated public inboxes:
# (number on the left is used for dev purposes)
         18 lkml
         11 linux-kselftest
         11 linux-api
          8 ltp
          7 stable
          6 lttng-dev
          5 qemu-devel
          5 xen-devel
          4 linux-input
          4 linux-arm-kernel
          4 linux-bluetooth
          3 linux-wireless
          3 linux-devicetree
          3 linux-erofs
          3 linux-mm
          3 linux-btrfs
          3 linux-iio
          3 dpdk-dev
          3 kvm
          3 virtualization
          3 linux-fbdev
          3 buildroot
          3 openembedded-core
          2 linux-samsung-soc
          2 linux-mtd
          2 linux-block
          2 linux-riscv
          2 linux-nvme
          2 linux-xfs
          2 bpf
          2 linux-nfs
          2 linux-mediatek
          2 linux-crypto
          2 linux-efi
          2 linux-acpi
          2 netfilter-devel
          2 linux-integrity
          2 linux-fsdevel
          2 linux-edac
          2 linux-cifs
          2 linux-arm-msm
          2 linux-amlogic
          2 linux-iommu
          2 netdev
          2 linux-media
          2 linux-snps-arc
          2 linux-mips
          2 fstests
          2 linux-pm
          2 linux-hwmon
          2 linux-rtc
          2 alsa-devel
          2 linux-scsi
          2 kvmarm
          2 linux-usb
          2 linux-renesas-soc
          2 selinux
          2 linux-clk
          2 linux-gpio
          2 dmaengine
          2 linux-rdma
          2 linux-parisc
          2 linux-leds
          2 linux-security-module
          2 linux-pci
          2 linuxppc-dev
          2 linux-modules
          2 linux-rt-users
          2 linux-ide
          2 linux-serial
          2 linux-watchdog
          2 linux-hyperv
          2 rcu
          2 linux-m68k
          2 linux-i3c
          2 wireguard
          2 backports
          2 linux-doc
          2 git
          2 linux-csky
          2 linux-man
          2 linux-mmc
          2 amd-gfx
          2 dri-devel
          2 intel-gfx
          2 linux-unionfs
          2 linux-firmware
          2 cip-dev
          2 linux-omap
          2 linux-spi
          2 linux-i2c
          2 linux-remoteproc
          2 linux-sparse
          2 linux-pwm
          2 linux-tegra
          2 linux-kbuild
          2 linux-fpga
          2 ceph-devel
          2 linux-arch
          2 linux-can
          2 linux-rockchip
          2 linux-raid
          2 platform-driver-x86
          2 phone-devel
          2 openbmc
          2 linux-hardening
          2 dash
          2 dm-devel
          2 keyrings
          2 linux-cxl
          2 linux-perf-users
          2 linux-sh
          2 soc
          2 rust-for-linux
          2 nouveau
          2 linux-phy
          2 linux-s390
          2 kernel-janitors
          2 sparclinux
          2 linux-staging
          2 linux-sunxi
          2 mptcp
          2 linux-coco
          2 nvdimm
          2 u-boot
          2 llvm
          2 fio
          2 iwd
          2 ofono
          2 yocto
          2 yocto-meta-arm
          2 openembedded-devel
          2 bitbake-devel
          2 linux-patches
          2 yocto-meta-virtualization
          2 yocto-meta-ti
          2 yocto-meta-arago
          2 xenomai
          2 openrisc
          2 kexec
          2 loongarch
          2 imx
          2 b4-sent
          2 linux-trace-kernel
          2 oe-kbuild-all
          2 batman
          2 intel-xe
          2 linux-um
          2 v9fs
          2 qemu-riscv
          2 grub-devel
          2 linux-alpha
          2 linux-hexagon
          2 linux-sound
          2 u-boot-amlogic
          2 perfbook
          2 igt-dev
          1 linux-fscrypt
          1 cocci
          1 live-patching
          1 linux-nvdimm
          1 driverdev-devel
          1 kernel-hardening
          1 linux-next
          1 linux-ext4
          1 linux-f2fs-devel
          1 kernelnewbies
          1 linux-sgx
          1 linux-trace-devel
          1 workflows
          1 util-linux
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 io-uring
          1 linux-kernel-mentees
          1 tpmdd-devel
          1 linux-audit
          1 linux-dash
          1 linux-bcache
          1 mm-commits
          1 containers
          1 xdp-newbies
          1 linux-sctp
          1 target-devel
          1 lustre-devel
          1 ocfs2-devel
          1 ath10k
          1 ath11k
          1 regressions
          1 ksummit
          1 b43-dev
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 linux-ppp
          1 ell
          1 yocto-meta-freescale
          1 yocto-toaster
          1 yocto-docs
          1 chrome-platform
          1 ntb
          1 outreachy
          1 damon
          1 asahi
          1 intel-wired-lan
          1 ath12k
          1 oe-linux-nfc
          1 oe-chipsec
          1 fsverity
          1 virtio-dev
          1 virtio-comment
          1 ecryptfs
          1 poky
          1 linux-ia64
          1 cluster-devel
          1 kdevops
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 cgroups
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 kvm-ppc
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-hotplug
          1 linux-laptop
          1 trinity
          1 reiserfs-devel
          1 linux-metag
          1 linux-x25
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 lm-sensors
          1 lvm-devel
          1 acpica-devel
          1 virtio-fs
          1 smatch
          1 fuego
          1 wireless-regdb
          1 netfs
          1 powertop
          1 dtrace
          1 yocto-patches
          1 barebox
          1 linux-aspeed

git clone https://yhbt.net/lore/pub/scm/libs/librseq/librseq.git