• Summary rsyscall is a library which provides a interface to an ever-growing subset of Linux system calls. This interface is:
• process-independent: all system calls are called as methods on process objects, which can refer to the "local" process or to other processes under our control, possibly on remote hosts.
• type-safe: many Linux API constraints, which are usually left to user code to enforce, are made explicit in the type system.
• low-level: any action which is possible with the underlying Linux APIs, is possible with rsyscall; nothing is forbidden or discouraged.

For more detail on the concepts and motivation behind rsyscall, read the [[file:docs/conceptual.org][conceptual introduction]].

• Quick Start Check out the docs at [[http://rsyscall.org/rsyscall][rsyscall.org]].

Note that the rsyscall Python API uses some recent Python 3 features: async/await and type annotations. If you haven't seen those before, skim the [[file:docs/background.org][background tutorial]] first.

• Installation There's no official release of rsyscall yet.

But, if you want to try it, you can do so with Nix:

+begin_src bash

git clone https://github.com/catern/rsyscall cd rsyscall/python nix-shell python

+end_src

Or you can build it by hand in a virtual environment:

+begin_src bash

git clone https://github.com/catern/rsyscall cd rsyscall python3 -m venv venv . venv/bin/activate pip install -U pip

cd c autoreconf -fvi ./configure --prefix=$PWD/../venv make install cd .. export LD_LIBRARY_PATH=$PWD/venv/lib export PKG_CONFIG_PATH=$PWD/venv/lib/pkgconfig

pip install -e python/ python

+end_src

• Getting started rsyscall is an async library that uses [[https://trio.readthedocs.io][Trio]], so the easiest way to try it out is with an async Python REPL. [[https://ipython.org/][IPython]] provides a convenient REPL:

  +begin_example

  $ pip install ipython $ ipython In [1]: %autoawait trio

In [2]: import rsyscall

In [3]: t = await rsyscall.local_process.fork()

In [4]: await t.stdout.write(await t.ptr("Hello world!\n")) Hello world!

+end_example

• Discussion irc://irc.oftc.net/#rsyscall