rsyscall

• 摘要
  rsyscall 是一个库，它为不断增长的 Linux 系统调用子集提供了接口。
  该接口具有以下特性：

• 进程无关：所有系统调用都作为进程对象上的方法进行调用，这些对象可以引用“本地”进程或我们控制下的其他进程，甚至可能位于远程主机上。
• 类型安全：许多 Linux API 的约束通常留给用户代码来强制执行，而现在它们在类型系统中被明确表示。
• 底层：任何可以通过底层 Linux API 实现的操作，都可以通过 rsyscall 实现；没有禁止或限制的操作。

有关 rsyscall 背后的概念和动机的更多细节，请阅读[[file:docs/conceptual.org][概念介绍]]。

• 快速开始
  请查阅 [[http://rsyscall.org/rsyscall][rsyscall.org]] 上的文档。

请注意，rsyscall 的 Python API 使用了一些较新的 Python 3 特性：async/await 和类型注解。
如果你之前没有接触过这些，请先快速浏览[[file:docs/background.org][背景教程]]。

• 安装
  rsyscall 目前还没有正式发布。

但如果你想要尝试，可以使用 Nix：
#+begin_src bash
git clone https://github.com/catern/rsyscall
cd rsyscall/python
nix-shell
python
#+end_src

或者你可以在虚拟环境中手动构建：
#+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

• 入门
  rsyscall 是一个使用 [[https://trio.readthedocs.io][Trio]] 的异步库，因此最简单的尝试方式是使用异步 Python REPL。 [[https://ipython.org/][IPython]] 提供了一个便利的 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

• 讨论
  irc://irc.oftc.net/#rsyscall